Technischer Deep Dive

Einen nativen Emoji Picker für macOS in Swift entwickeln

Kein Electron, kein Ballast

Dies ist das Entwicklungsprotokoll hinter Emoji Picker for macOS. Wir haben die App gebaut, weil der Standard-Picker beim Chatten immer wieder unseren eigenen Schreibfluss unterbrach. Die integrierte Lösung verlangte den Griff zur Maus und ist langsam. Das Ziel war einfach: tippen, auswählen, weitermachen.

Veröffentlicht am 2026-02-16 · von inndevs GmbH

In diesem Deep Dive

Das eigentliche Workflow-Problem

macOS bringt bereits einen Emoji-Picker mit. Für gelegentliche Nutzung ist er in Ordnung. In textlastigen Workflows hat er uns ausgebremst: Panel öffnen, Hand zur Maus, auswählen, Panel schließen, wieder in den Kontext finden. Wiederhole das Dutzende Male am Tag, und die Kosten der Unterbrechung werden offensichtlich.

Frühe interne Tests zeigten, wie lästig Fehlauslösungen sind. Wir haben die Regeln verschärft, bis sich die Aktivierung langweilig und vorhersehbar anfühlte: ; tippen, in der aktuellen App bleiben, per Tastatur auswählen, weiterschreiben.

  • Support- und Ticket-Workflows brauchen schnelles Einfügen, während viele kurze Nachrichten gesichtet werden.
  • In Code-Review-Kommentaren und Commit-Nachrichten wissen wir meist schon, was wir wollen – da ist das Blättern in Kategorien langsamer als das Tippen einer Suche.
  • Mehr als 40 Panel-Wechsel am Tag bringen den Tipprhythmus schnell aus dem Takt.

Architekturentscheidungen

Umgang mit globalen Hotkeys

Die Eingabe läuft über einen Core Graphics Event Tap und eine abgesicherte Zustandsmaschine. Ein begrenzter Puffer im Arbeitsspeicher hält die zuletzt getippten druckbaren Zeichen der App im Vordergrund, damit der eingestellte Auslöser erkannt wird. Er wird bei App-Wechseln, Tastenkürzeln, nicht druckbaren Eingaben und Abbrüchen zurückgesetzt. Eine einstellbare Pop-up-Verzögerung hält die Oberfläche ruhig, solange noch an der Suche getippt wird.

Entscheidung zwischen NSPanel und NSPopover

Wir haben mit NSPopover begonnen und sind zu NSPanel gewechselt. NSPopover verlor bei schnellen App-Wechseln in Slack und Chrome zu leicht den Fokus. NSPanel gab uns explizite Kontrolle über den Lebenszyklus und eine vorhersehbare Tastaturweiterleitung über App-Grenzen hinweg.

Bedienungshilfen-Berechtigung und Einfügestrategie

Die Bedienungshilfen-Berechtigung erlaubt Emoji Picker, diese globalen Ereignisse zu beobachten und Tastaturereignisse an die aktive App zurückzusenden. Einfügen über die Zwischenablage haben wir verworfen, weil das Überschreiben der Zwischenablage überrascht und schwer nachvollziehbar ist. Die App liest kein Textfeld über AXUIElement aus; sie merkt sich beim Start einer Sitzung die vorgesehene App im Vordergrund und prüft vor dem Einfügen, ob noch dieselbe App vorne ist.

Gezählte Textersetzung

Eine Inline-Sitzung zählt die Auslöse- und Abfragezeichen, die in der Ziel-App angekommen sind. Bei der Auswahl sendet Emoji Picker entsprechend viele Rückschritt-Tastenereignisse und danach den gewählten Unicode-Text als synthetisches Tastaturereignis. Die Zwischenablage bleibt unverändert. Eigene Steuerelemente können synthetische Tastaturereignisse dennoch anders interpretieren – deshalb sind die Prüfung der Ziel-App und das Abbruchverhalten wichtig.

Regeln zur Kontexterkennung

Mit diesen praktischen Regeln halten wir die Aktivierung vorhersehbar:

  • Eigene Fenster von Emoji Picker und Apps auf der Ausschlussliste des Nutzers ignorieren.
  • Letzte Eingaben und jede aktive Sitzung an die App im Vordergrund binden; ein App-Wechsel bricht die Sitzung ab.
  • Den eingestellten Auslöser mit einem begrenzten Ende der letzten druckbaren Eingaben abgleichen.
  • In einer Inline-Abfrage werden Buchstaben, Ziffern, Unterstrich, Plus und Bindestrich akzeptiert; jede andere Eingabe bricht sie ab.
  • Vor dem Anzeigen der Oberfläche die Sperrliste für Eröffnungssequenzen, die minimale Abfragelänge und die Pop-up-Verzögerung des Nutzers anwenden.
  • Eigene Auslöser zum direkten Öffnen (zum Beispiel ;; oder //) für alle, die einen expliziten Aufruf bevorzugen.

Vereinfachte Zustandslogik (zur besseren Lesbarkeit gekürzt):

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 Auslöser verzögerte Abfrage übernehmen, Fokus verlieren oder abbrechen
Überblick über den Zustandsablauf: idle -> tracking -> open -> idle.

Ein Bug, der uns ein besseres Zustandsmodell abverlangte

Ein Fehler aus den Versionshinweisen zu v1.3 deckte einen blinden Fleck in unserem Statusmodell für Updates auf: Checking... konnte nach einem Ergebnis ohne Update sichtbar bleiben, und Available konnte unbekannt bleiben. Der Bug war klein, der Vertrauensschaden groß.

Die Behebung zwang uns, die Zustandsmaschine zu straffen, statt Beschriftungen an Ort und Stelle zu flicken. Das hat geändert, wie wir UI-Status im Rest der App behandeln: explizite Übergänge, weniger abgeleitete Zustände und eine engere Abstimmung zwischen asynchronen Prüfungen und sichtbarem Status.

  • Symptom: veralteter Update-Statustext nach erfolgreichen Prüfungen ohne Update.
  • Ursache: unvollständige Zustandsübergänge bei asynchronen Update-Callbacks.
  • Ergebnis: Explizite Zustandsübergänge steuern jetzt die Statusanzeige.

Hinweise zur Performance

Die Messgröße, auf die es ankommt: die Zeit vom Auslöser bis zum eingefügten Emoji. Deshalb sind wir bei einer nativen Swift-+-AppKit-Laufzeit geblieben statt bei einem Stack mit Browser-Engine.

Gemessen auf Mac15,11 (Apple M3 Max), macOS 26.2 Build 25C56, mit v1.3.1 aus dem ausgelieferten ZIP. Startzeit bedeutet unten den prozesssichtbaren Start von open -n bis zum Erscheinen des App-Prozesses.

Erster Start in der Sitzung

217.68 ms (ein Durchlauf, prozesssichtbarer Start).

Warmer Neustart

110.02 ms Median über 7 Neustarts.

Speicher im Leerlauf

110.4 MB RSS laut ps; die Aktivitätsanzeige zeigte im selben Durchlauf 99.4 MB realen und 29.6 MB privaten Speicher.

Paketgröße

4.49 MB ZIP, 12.96 MB App-Bundle auf dem Datenträger.

Die Speicherwerte stehen unverändert da, weil sie auf unterschiedlichen Zählweisen beruhen. Der Großteil des RSS ist hier gemeinsam genutzter Speicher des AppKit-Frameworks; der private Speicher bleibt in unseren Tests unter 30 MB.

Swift + AppKit vs. Electron für macOS-Dienstprogramme

Bei ständig aktiven Dienstprogrammen zählt das Laufzeitverhalten mehr als die Portierbarkeit der Oberfläche. Wir haben uns aus diesen praktischen Gründen für natives Swift + AppKit entschieden:

  • Kleines Distributionsartefakt und direkter Startpfad ohne Aufwärmen einer JavaScript-Laufzeit.
  • Direkte Integration von Bedienungshilfen und Texteinfügung über native macOS-APIs.
  • Kein Prozessbaum einer eingebetteten Browser-Engine für ein leichtgewichtiges Tastatur-Dienstprogramm.

Gemessene Startzeiten der integrierten Lösung, von Raycast und Emoji Picker findest du auf der Vergleichsseite.

Design-Abwägungen

Warum in der Menüleiste

Menüleisten-Tools lassen sich leicht am Laufen halten und schnell aufrufen. Für dieses Produkt passte das zur Realität: Man ruft es immer wieder auf – in Chats, Tickets, Commit-Nachrichten und Dokumentation.

Warum eine bewusst minimale Oberfläche

Wir haben fast jedes dekorative Element entfernt, das die Auswahl verlangsamte. Klare Kategorien, offensichtliche Tastaturnavigation und minimale Bedienelemente funktionierten in unserem eigenen Alltag besser als aufwendigere Gestaltung.

Wo der integrierte Picker weiterhin gewinnt

Wenn du nur selten Emoji einfügst, ist der Picker von macOS gut genug und braucht keinerlei Einrichtung. Unsere App ist für alle, die das den ganzen Tag tun und die Unterbrechung immer wieder spüren.

Warum local-first

Local-first war nicht verhandelbar: keine Kontopflicht, keine Cloud-Abhängigkeit und kein Weiterleiten des Tippverhaltens an externe Dienste.

Was uns überrascht hat

  • Kleine Statusfehler können dem Vertrauen mehr schaden als offensichtliche optische Fehler.
  • Fehlauslösungen bemerken Power-User sofort.
  • Niemand wollte mehr Funktionen, bis die Aktivierung nicht mehr danebenlag.

Die wichtigste Lektion: Tastatur-Tools werden an ihrer Beständigkeit gemessen, nicht an Neuheit. Verhält sich die App jedes Mal gleich, verdient sie sich einen festen Platz im Workflow.

Bekannte Einschränkungen

  • Die Bedienungshilfen-Berechtigung ist für die globale Überwachung des Auslösers und das Einfügen in andere Apps erforderlich.
  • Die App liest keine Metadaten des fokussierten Feldes aus, auch nicht, ob es ein sicheres Feld ist. Apps, in denen keine Auslöser-Überwachung gewünscht ist, lassen sich zur Ausschlussliste hinzufügen.
  • Manche eigenen Textsteuerelemente interpretieren synthetische Rückschritt- oder Unicode-Tastaturereignisse anders, was die Zuverlässigkeit des Einfügens verringern kann.
  • Die Auslöse-Erkennung wurde am intensivsten mit lateinischen Tastaturbelegungen getestet.

Support

Stell eine Frage, melde ein Problem oder wünsch dir eine Funktion auf der Support-Seite von Emoji Picker. Kein Konto nötig.

Emoji Picker ausprobieren

Ein Problem gefunden? Melde es mit App-Version, macOS-Version und den Schritten zur Reproduktion.