Technische deep dive
Een native emoji-picker voor macOS bouwen in Swift
Geen Electron, geen ballast
Dit is het bouwverslag achter Emoji Picker for macOS. We maakten het omdat de standaardpicker tijdens het chatten steeds onze eigen schrijfflow onderbrak. De ingebouwde optie vroeg om de muis en werkt traag. Het doel was simpel: typen, kiezen en doorgaan.
In deze deep dive
Het echte workflowprobleem
macOS heeft al een emoji-picker. Voor af en toe is die prima. In tekstintensieve workflows remde hij ons af: paneel openen, hand naar de muis, kiezen, paneel sluiten, context terugvinden. Herhaal dat tientallen keren per dag en de kosten van de onderbreking worden duidelijk.
Vroege interne tests lieten zien hoe vervelend valse activeringen zijn. We hebben de regels aangescherpt tot activeren saai en voorspelbaar voelde: typ ;, blijf in de huidige app, kies met het toetsenbord, schrijf verder.
- Support- en ticketworkflows vragen om snel invoegen tijdens het verwerken van veel korte berichten.
- In code-reviewcommentaar en commitberichten weten we meestal al wat we willen, dus bladeren door categorieën is trager dan een zoekopdracht typen.
- Meer dan 40 keer per dag van paneel wisselen haalt je typritme snel onderuit.
Architectuurkeuzes
Afhandeling van globale sneltoetsen
Invoer loopt via een Core Graphics-event tap en een beveiligde toestandsmachine. Een begrensde buffer in het geheugen houdt de laatst getypte afdrukbare tekens van de app op de voorgrond bij, zodat de ingestelde trigger herkend kan worden. Die wordt gewist bij appwissels, sneltoetsen, niet-afdrukbare invoer en annuleren. Een instelbare pop-upvertraging houdt de interface rustig zolang een zoekopdracht nog wordt getypt.
Keuze tussen NSPanel en NSPopover
We begonnen met NSPopover en stapten over op NSPanel. NSPopover verloor te makkelijk de focus in Slack en Chrome bij snelle appwissels. NSPanel gaf ons expliciete controle over de levenscyclus en voorspelbare toetsenbordroutering over appgrenzen heen.
Toegankelijkheidsrechten en invoegstrategie
Met toegang tot toegankelijkheid kan Emoji Picker die globale gebeurtenissen volgen en toetsenbordgebeurtenissen terugsturen naar de actieve app. Invoegen via het klembord hebben we afgewezen, omdat het overschrijven van het klembord verrast en moeilijk te vertrouwen is. De app leest geen tekstveld uit via AXUIElement; ze onthoudt bij het begin van een sessie de bedoelde app op de voorgrond en controleert vóór het invoegen of diezelfde app nog vooraan staat.
Getelde tekstvervanging
Een inline sessie telt de trigger- en zoektekens die in de doel-app zijn aangekomen. Bij een keuze stuurt Emoji Picker evenveel Backspace-toetsgebeurtenissen en daarna de gekozen Unicode-tekst als synthetische toetsenbordgebeurtenis. Het klembord blijft onaangeroerd. Eigen tekstvelden kunnen synthetische toetsenbordgebeurtenissen toch anders interpreteren – daarom zijn de controle van de doel-app en het annuleringsgedrag belangrijk.
Regels voor contextdetectie
Dit zijn de praktische regels waarmee we het activeren voorspelbaar houden:
- Negeer de eigen vensters van Emoji Picker en apps op de uitsluitingslijst van de gebruiker.
- Koppel recente invoer en elke actieve sessie aan de app op de voorgrond; van app wisselen annuleert de sessie.
- Vergelijk de ingestelde trigger met een begrensd laatste stuk van de recente afdrukbare invoer.
- Accepteer letters, cijfers, underscore, plus en koppelteken in een inline zoekopdracht; andere invoer annuleert die.
- Pas de blokkeerlijst voor openingsreeksen, de minimale zoeklengte en de pop-upvertraging van de gebruiker toe voordat de interface verschijnt.
- Ondersteun eigen triggers om direct te openen (bijvoorbeeld ;; of //) voor wie liever expliciet oproept.
Vereenvoudigde toestandslogica (ingekort voor leesbaarheid):
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)
}
Een bug die ons een beter toestandsmodel opleverde
Een probleem uit de releasenotes van v1.3 legde een blinde vlek in ons statusmodel voor updates bloot: Checking... kon zichtbaar blijven na een resultaat zonder update, en Available kon onbekend blijven. De bug was klein, de impact op vertrouwen groot.
De oplossing dwong ons de toestandsmachine strakker te maken in plaats van labels ter plekke op te lappen. Dat veranderde hoe we UI-status in de rest van de app behandelen: expliciete overgangen, minder afgeleide toestanden en een betere afstemming tussen asynchrone controles en zichtbare status.
- Symptoom: verouderde statustekst van de updater na geslaagde controles zonder update.
- Oorzaak: onvolledige toestandsovergangen bij asynchrone update-callbacks.
- Resultaat: expliciete toestandsovergangen sturen nu de statusweergave.
Prestatie-opmerkingen
De meetwaarde die telt: de tijd van trigger tot ingevoegd emoji. Daarom bleven we bij een native Swift + AppKit-runtime in plaats van een stack met een browser-engine.
Gemeten op Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, met v1.3.1 uit de geleverde ZIP. Opstarttijd betekent hieronder de procesgebonden start vanaf open -n tot het appproces verschijnt.
Eerste start in de sessie
217.68 ms (één run, procesgebonden opstart).
Warme herstart
110.02 ms mediaan over 7 herstarts.
Geheugen in rust
110.4 MB RSS via ps; Activiteitenweergave toonde bij dezelfde run 99.4 MB echt en 29.6 MB privégeheugen.
Pakketgrootte
4.49 MB ZIP, 12.96 MB appbundel op schijf.
Geheugenwaarden staan er zoals gemeten, omdat ze verschillende rekenmodellen gebruiken. Het grootste deel van de RSS is hier gedeeld geheugen van het AppKit-framework; het privégeheugen blijft in onze tests onder 30 MB.
Swift + AppKit vs Electron voor macOS-hulpprogramma's
Voor hulpprogramma's die altijd aan staan, telt het runtimegedrag meer dan de overdraagbaarheid van de interface. We kozen om deze praktische redenen voor native Swift + AppKit:
- Klein distributiebestand en een direct opstartpad zonder opwarmen van een JavaScript-runtime.
- Directe integratie van toegankelijkheid en tekstinvoer via native macOS-API's.
- Geen procesboom van een ingebouwde browser-engine voor een lichtgewicht toetsenbordhulpmiddel.
Gemeten opstarttijden van de ingebouwde viewer, Raycast en Emoji Picker vind je op de vergelijkingspagina.
Ontwerpafwegingen
Waarom in de menubalk
Menubalktools zijn makkelijk actief te houden en snel op te roepen. Voor dit product klopte dat met de praktijk: je roept het steeds opnieuw op in chats, tickets, commitberichten en documentatie.
Waarom een bewust minimale interface
We hebben bijna elk decoratief element verwijderd dat het kiezen vertraagde. Duidelijke categorieën, voor de hand liggende toetsenbordnavigatie en minimale franje werkten in ons eigen dagelijks gebruik beter dan rijkere vormgeving.
Waar de ingebouwde picker nog wint
Voeg je maar zelden emoji in, dan is de picker van macOS al goed genoeg en hoef je niets in te stellen. Onze app is voor wie dit de hele dag doet en de onderbreking steeds opnieuw voelt.
Waarom local-first
Local-first was niet onderhandelbaar. Geen verplicht account, geen afhankelijkheid van de cloud en geen typgedrag dat via externe diensten loopt.
Wat ons verraste
- Kleine statusfouten kunnen het vertrouwen meer schaden dan duidelijke visuele fouten.
- Valse activeringen vallen powerusers meteen op.
- Niemand vroeg om meer functies tot het activeren niet meer misging.
De belangrijkste les: toetsenbordtools worden beoordeeld op consistentie, niet op nieuwigheid. Gedraagt de app zich elke keer hetzelfde, dan verdient ze een vaste plek in je workflow.
Bekende beperkingen
- Toegankelijkheidsrechten zijn nodig voor het globaal volgen van de trigger en het invoegen in andere apps.
- De app leest geen metagegevens van het actieve veld uit, ook niet of het een beveiligd veld is. Apps waarin je geen triggerbewaking wilt, kun je aan de uitsluitingslijst toevoegen.
- Sommige eigen tekstvelden interpreteren synthetische Backspace- of Unicode-toetsenbordgebeurtenissen anders, wat het invoegen minder betrouwbaar kan maken.
- De triggerdetectie is het meest getest met Latijnse toetsenbordindelingen.
Support
Stel een vraag, meld een probleem of vraag een functie aan op de supportpagina van Emoji Picker. Geen account nodig.
Probeer Emoji Picker
Een probleem gevonden? Meld het met de appversie, macOS-versie en stappen om het te reproduceren.