Artykuł techniczny

Jak zbudowaliśmy natywny panel emoji dla macOS w Swifcie

Bez Electrona, bez balastu

To dziennik budowy Emoji Picker for macOS. Stworzyliśmy go, bo domyślny panel emoji ciągle wybijał nas z rytmu podczas pisania na czatach. Wbudowana opcja wymagała sięgania po mysz i była powolna. Cel był prosty: pisz, wybierz, pisz dalej.

Opublikowano 2026-02-16 · inndevs GmbH

W tym artykule

Prawdziwy problem w codziennej pracy

macOS ma już wbudowany panel emoji. Do okazjonalnego użytku jest w porządku. Przy dużej ilości pisania spowalniał nas jednak. Otwórz panel, przenieś rękę na mysz, wybierz, zamknij panel, wróć do kontekstu. Powtórz to kilkadziesiąt razy dziennie, a koszt przerywania pracy staje się oczywisty.

Wczesne testy wewnętrzne pokazały, jak irytujące są fałszywe aktywacje. Zaostrzaliśmy reguły, aż aktywacja stała się nudna i przewidywalna: wpisz ;, zostań w bieżącej aplikacji, wybierz klawiaturą, pisz dalej.

  • Obsługa klienta i zgłoszeń wymaga szybkiego wstawiania przy segregowaniu wielu krótkich wiadomości.
  • W komentarzach do code review i opisach commitów zwykle wiemy już, czego szukamy, więc przeglądanie kategorii jest wolniejsze niż wpisanie zapytania.
  • Przełączanie panelu ponad 40 razy dziennie szybko wybija z rytmu pisania.

Decyzje architektoniczne

Obsługa globalnych skrótów klawiszowych

Wejściem steruje event tap Core Graphics wraz z chronioną maszyną stanów. Ograniczony bufor w pamięci przechowuje ostatnie drukowalne znaki dla aplikacji na pierwszym planie, aby można było rozpoznać skonfigurowany wyzwalacz. Jest czyszczony przy zmianie aplikacji, skrótach, znakach niedrukowalnych i anulowaniu. Konfigurowalne opóźnienie okienka sprawia, że interfejs nie przeszkadza, dopóki zapytanie jest jeszcze wpisywane.

Wybór między NSPanel a NSPopover

Zaczęliśmy od NSPopover, a potem przeszliśmy na NSPanel. NSPopover zbyt łatwo tracił fokus w Slacku i Chrome przy szybkim przełączaniu aplikacji. NSPanel dał nam jawną kontrolę nad cyklem życia i przewidywalne kierowanie klawiatury między aplikacjami.

Uprawnienie Dostępności i strategia wstawiania

Uprawnienie Dostępności pozwala Emoji Picker monitorować te globalne zdarzenia i wysyłać zdarzenia klawiatury z powrotem do aktywnej aplikacji. Odrzuciliśmy wstawianie przez schowek, bo nadpisywanie jego zawartości jest zaskakujące i trudno mu zaufać. Aplikacja nie analizuje pola tekstowego przez AXUIElement; na początku sesji zapamiętuje, która aplikacja ma być na pierwszym planie, i przed wstawieniem sprawdza, czy nadal tak jest.

Zliczana zamiana tekstu

Sesja w tekście zlicza znaki wyzwalacza i zapytania, które trafiły do docelowej aplikacji. Po wyborze Emoji Picker wysyła tyle samo zdarzeń klawisza Backspace, a następnie wybrany tekst Unicode jako syntetyczne zdarzenie klawiatury. Nigdy nie zmienia zawartości schowka. Niestandardowe kontrolki mogą jednak różnie interpretować syntetyczne zdarzenia klawiatury, dlatego tak ważne są sprawdzanie docelowej aplikacji i sposób anulowania.

Reguły wykrywania kontekstu

Oto praktyczne reguły, dzięki którym aktywacja pozostaje przewidywalna:

  • Ignoruj własne okna Emoji Picker i aplikacje z listy wykluczeń użytkownika.
  • Powiąż ostatnio wpisane znaki i każdą aktywną sesję z aplikacją na pierwszym planie; przełączenie aplikacji anuluje sesję.
  • Dopasuj skonfigurowany wyzwalacz do ograniczonego końcowego fragmentu ostatnio wpisanych znaków drukowalnych.
  • W zapytaniu wpisywanym w tekście akceptowane są litery, cyfry, podkreślnik, plus i łącznik; każdy inny znak je anuluje.
  • Zanim pojawi się interfejs, zastosuj listę blokowanych sekwencji otwierających, minimalną długość zapytania i opóźnienie okienka ustawione przez użytkownika.
  • Umożliw własny wyzwalacz bezpośredniego otwierania (na przykład ;; lub //) dla osób, które wolą jawne wywołanie.

Uproszczona logika stanów (skrócona dla czytelności):

func handle(_ event: KeyEvent, frontmostApp: App) {
    guard frontmostApp != emojiPicker, !isExcluded(frontmostApp) else {
        resetRecentInput()
        return
    }

    if session == nil, recentInput.appending(event).hasSuffix(inlineTrigger) {
        session = .inline(target: frontmostApp, deleteCount: inlineTrigger.count)
    } else if session?.accepts(event) == true {
        session?.appendToQuery(event)
        showAfterConfiguredDelay()
    }
}

func commit(_ text: String) {
    guard session?.target == frontmostApp else { return cancel() }
    postBackspaceEvents(count: session?.deleteCount ?? 0)
    postUnicodeKeyboardEvent(text)
}
idle tracking open wyzwalacz zapytanie z opóźnieniem (debounce) zatwierdzenie, utrata fokusu lub anulowanie
Przepływ stanów w skrócie: idle -> tracking -> open -> idle.

Błąd, który wymusił lepszy model stanów

Jeden problem opisany w historii zmian v1.3 ujawnił martwy punkt w modelu statusu aktualizacji: Checking... mogło pozostawać widoczne po wyniku „brak aktualizacji”, a Available mogło pozostać nieznane. Błąd był drobny, ale jego wpływ na zaufanie – duży.

Naprawa wymusiła zaostrzenie maszyny stanów zamiast łatania etykiet na miejscu. To zmieniło nasze podejście do statusu interfejsu w całej aplikacji: jawne przejścia, mniej domyślanych stanów i ściślejsza synchronizacja między asynchronicznymi sprawdzeniami a widocznym statusem.

  • Objaw: nieaktualny tekst statusu aktualizacji po udanym sprawdzeniu, które nie znalazło aktualizacji.
  • Przyczyna: niepełne przejścia między stanami przy asynchronicznych wywołaniach zwrotnych aktualizacji.
  • Efekt: status jest teraz renderowany na podstawie jawnych przejść między stanami.

Uwagi o wydajności

Liczy się jedna miara: czas od wyzwalacza do wstawionego emoji. Dlatego pozostaliśmy przy natywnym Swift + AppKit zamiast stosu opartego na silniku przeglądarki.

Pomiar na Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, z użyciem v1.3.1 z dystrybuowanego pliku ZIP. Czas uruchomienia poniżej oznacza czas od open -n do pojawienia się procesu aplikacji.

Pierwsze uruchomienie w sesji

217.68 ms (jeden pomiar, czas do pojawienia się procesu).

Ponowne uruchomienie na ciepło

110.02 ms – mediana z 7 ponownych uruchomień.

Pamięć w spoczynku

110.4 MB RSS według ps; Monitor aktywności w tym samym pomiarze pokazał 99.4 MB pamięci rzeczywistej i 29.6 MB pamięci prywatnej.

Rozmiar pakietu

4.49 MB ZIP, 12.96 MB pakiet aplikacji na dysku.

Wskaźniki pamięci podajemy bez zmian, bo opierają się na różnych modelach liczenia. Większość RSS to tutaj współdzielona pamięć frameworka AppKit; pamięć prywatna w naszych testach nie przekracza 30 MB.

Swift + AppKit vs Electron w narzędziach dla macOS

W narzędziach działających stale charakterystyka działania liczy się bardziej niż przenośność interfejsu. Wybraliśmy natywny Swift + AppKit z tych praktycznych powodów:

  • Mały pakiet dystrybucyjny i bezpośrednia ścieżka startu bez rozgrzewania środowiska JavaScript.
  • Bezpośrednia integracja z Dostępnością i wstawianiem tekstu przez natywne API macOS.
  • Żadnego drzewa procesów osadzonego silnika przeglądarki w lekkim narzędziu klawiaturowym.

Zmierzone czasy startu narzędzia wbudowanego, Raycast i Emoji Picker znajdziesz na stronie porównania.

Kompromisy projektowe

Dlaczego pasek menu

Narzędzia na pasku menu łatwo utrzymać w gotowości i szybko przywołać. W przypadku tego produktu pokrywa się to z rzeczywistością: użytkownicy wywołują go wielokrotnie podczas czatów, obsługi zgłoszeń, pisania commitów i dokumentacji.

Dlaczego celowo minimalistyczny interfejs

Usunęliśmy niemal każdy element dekoracyjny, który spowalniał wybór. Czytelne kategorie, oczywista nawigacja klawiaturą i minimum ozdobników sprawdzały się w naszym codziennym użyciu lepiej niż bogatsza oprawa wizualna.

Kiedy wbudowany panel wciąż wygrywa

Jeśli wstawiasz emoji rzadko, panel macOS w zupełności wystarczy i nie wymaga żadnej konfiguracji. Nasza aplikacja jest dla tych, którzy robią to przez cały dzień i raz po raz odczuwają koszt przerywania pracy.

Dlaczego local-first

Podejście local-first nie podlegało negocjacjom. Bez wymogu zakładania konta, bez zależności od chmury i bez przesyłania tego, co piszesz, przez zewnętrzne usługi.

Co nas zaskoczyło

  • Drobne błędy statusu mogą bardziej podważyć zaufanie niż oczywiste błędy wizualne.
  • Fałszywe aktywacje zaawansowani użytkownicy zauważają od razu.
  • Nikt nie prosił o nowe funkcje, dopóki aktywacja nie przestała się mylić.

Najważniejsza lekcja: narzędzia klawiaturowe ocenia się po spójności, nie po nowinkach. Jeśli aplikacja za każdym razem działa tak samo, zasłuży na stałe miejsce w codziennej pracy.

Znane ograniczenia

  • Uprawnienie Dostępności jest potrzebne do globalnego monitorowania wyzwalacza i wstawiania między aplikacjami.
  • Aplikacja nie sprawdza metadanych aktywnego pola, w tym tego, czy jest ono polem zabezpieczonym. Aplikacje, w których monitorowanie wyzwalacza jest niepożądane, można dodać do listy wykluczeń.
  • Niektóre niestandardowe kontrolki tekstowe różnie interpretują syntetyczne zdarzenia Backspace lub klawiatury Unicode, co może obniżać niezawodność wstawiania.
  • Wykrywanie wyzwalacza najdokładniej przetestowano na układach klawiatury z alfabetem łacińskim.

Pomoc

Zadaj pytanie, zgłoś problem lub zaproponuj funkcję na stronie pomocy Emoji Picker. Konto nie jest potrzebne.

Wypróbuj Emoji Picker

Coś nie działa? Zgłoś problem, podając wersję aplikacji, wersję macOS i kroki, które go wywołują.