Teknisk fördjupning
Så byggde vi en inbyggd emojiväljare för macOS i Swift
Utan Electron, utan onödig vikt
Det här är byggloggen bakom Emoji Picker for macOS. Vi byggde den för att standardväljaren hela tiden avbröt vårt eget skrivflöde när vi chattade. Det inbyggda alternativet krävde att man tog till musen och var långsamt. Målet var enkelt: skriv, välj och fortsätt.
I den här fördjupningen
Det verkliga problemet i arbetsflödet
macOS har redan en inbyggd emojiväljare. För enstaka användning fungerar den bra. Men när vi skrev mycket text bromsade den oss. Öppna panelen, flytta handen till musen, välj, stäng panelen, hitta tillbaka. Gör det dussintals gånger om dagen så blir kostnaden för avbrotten uppenbar.
Tidiga interna tester visade hur irriterande felaktiga aktiveringar var. Vi skärpte reglerna tills aktiveringen kändes tråkig och förutsägbar: skriv ;, stanna i den aktuella appen, välj med tangentbordet och fortsätt skriva.
- Support- och ärendeflöden kräver snabb infogning när många korta meddelanden ska sorteras.
- I kommentarer vid kodgranskning och i commit-meddelanden vet vi oftast redan vad vi vill ha, så att bläddra bland kategorier går långsammare än att skriva en sökning.
- Att växla panelens läge över 40 gånger om dagen bryter snabbt skrivrytmen.
Arkitekturbeslut
Hantering av globala kortkommandon
Inmatningen styrs av en Core Graphics event tap och en skyddad tillståndsmaskin. En begränsad buffert i minnet håller de senaste skrivbara tecknen för appen längst fram så att den konfigurerade utlösaren kan kännas igen. Den nollställs vid appbyten, kortkommandon, icke-skrivbar inmatning och avbrott. En inställbar fördröjning för popupfönstret håller gränssnittet lugnt medan sökningen fortfarande skrivs.
Valet mellan NSPanel och NSPopover
Vi började med NSPopover och bytte till NSPanel. NSPopover tappade fokus för lätt i Slack och Chrome vid snabba appbyten. NSPanel gav oss uttrycklig kontroll över livscykeln och förutsägbar tangentbordsstyrning mellan appar.
Behörighet för hjälpmedel och infogningsstrategi
Behörigheten för hjälpmedel gör att Emoji Picker kan övervaka dessa globala händelser och skicka tangentbordshändelser tillbaka till den aktiva appen. Vi valde bort infogning via urklipp, eftersom det är överraskande och svårt att lita på när urklippet skrivs över. Appen läser inte av textfält via AXUIElement; den noterar vilken app som är längst fram när en session börjar och kontrollerar att samma app fortfarande ligger längst fram innan något infogas.
Räknad textersättning
En inbäddad session räknar de tecken för utlösare och sökning som nådde målappen. När du väljer skickar Emoji Picker lika många Backspace-tangenthändelser och skickar sedan den valda Unicode-texten som en syntetisk tangentbordshändelse. Urklippet ändras aldrig. Anpassade kontroller kan ändå tolka syntetiska tangentbordshändelser annorlunda, och därför är kontrollen av målappen och hur avbrott hanteras viktiga.
Regler för kontextidentifiering
Det här är de praktiska regler vi använder för att hålla aktiveringen förutsägbar:
- Ignorera Emoji Pickers egna fönster och appar på användarens undantagslista.
- Knyt den senaste inmatningen och varje aktiv session till appen längst fram; byter du app avbryts sessionen.
- Matcha den konfigurerade utlösaren mot ett begränsat slutsegment av den senaste skrivbara inmatningen.
- Godta bokstäver, siffror, understreck, plus och bindestreck i en inbäddad sökning; annan inmatning avbryter den.
- Tillämpa användarens blockeringslista för inledande sekvenser, minsta söklängd och fördröjning för popupfönstret innan gränssnittet visas.
- Stöd anpassade utlösare som öppnar direkt (till exempel ;; eller //) för användare som föredrar att öppna uttryckligen.
Förenklad tillståndslogik (förkortad för läsbarhetens skull):
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)
}
En bugg som tvingade fram en bättre tillståndsmodell
Ett problem i ändringsloggen för v1.3 avslöjade en blind fläck i vår statusmodell för uppdateringar: Checking... kunde bli kvar efter beskedet att ingen uppdatering fanns, och Available kunde förbli okänt. Buggen var liten, men påverkan på förtroendet var stor.
Att rätta den tvingade oss att skärpa tillståndsmaskinen i stället för att lappa etiketter på plats. Det ändrade hur vi hanterar status i gränssnittet i resten av appen: tydliga övergångar, färre härledda tillstånd och bättre synk mellan asynkrona kontroller och synlig status.
- Symptom: inaktuell statustext för uppdateringar efter lyckade kontroller utan ny uppdatering.
- Grundorsak: ofullständiga tillståndsövergångar vid asynkrona återanrop för uppdateringar.
- Resultat: tydliga tillståndsövergångar styr nu hur statusen visas.
Om prestanda
Måttet som spelar roll: tiden från utlösare till infogad emoji. Därför höll vi oss till inbyggt Swift + AppKit i stället för en stack byggd på en webbläsarmotor.
Uppmätt på Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, med v1.3.1 från den publicerade ZIP-filen. Starttiden nedan avser tiden från open -n tills appens process syns.
Första start i sessionen
217.68 ms (en körning, tid tills processen syns).
Varm omstart
110.02 ms i median över 7 omstarter.
Minne i vila
110.4 MB RSS enligt ps; Aktivitetskontroll visade vid samma körning 99.4 MB verkligt och 29.6 MB privat minne.
Paketstorlek
4.49 MB ZIP, 12.96 MB appaket på disk.
Minnesvärdena visas som de är, eftersom de bygger på olika sätt att räkna. Det mesta av RSS här är delat minne för ramverket AppKit; det privata minnet ligger under 30 MB i våra tester.
Swift + AppKit vs Electron för macOS-verktyg
För verktyg som alltid är igång spelar körningsegenskaperna större roll än ett portabelt gränssnitt. Vi valde inbyggt Swift + AppKit av dessa praktiska skäl:
- Litet distributionspaket och direkt start utan uppvärmning av en JavaScript-körmiljö.
- Direkt integration med hjälpmedel och textinfogning via macOS egna API:er.
- Inget inbäddat processträd för en webbläsarmotor i ett lätt tangentbordsverktyg.
Uppmätta starttider för den inbyggda funktionen, Raycast och Emoji Picker finns på jämförelsesidan.
Designavvägningar
Varför menyraden
Menyradsverktyg är enkla att hålla igång och snabba att ta fram. För den här produkten stämde det med verkligheten: användare tar fram den gång på gång i chattar, ärenden, commit-meddelanden och dokument.
Varför ett medvetet minimalt gränssnitt
Vi tog bort nästan alla dekorativa element som gjorde valet långsammare. Tydliga kategorier, självklar tangentbordsnavigering och minimalt med ramverk fungerade bättre än rikare visuella lösningar i vår egen dagliga användning.
När den inbyggda väljaren fortfarande vinner
Om du sällan infogar emojier räcker macOS-väljaren gott och kräver ingen konfiguration alls. Vår app är för dig som gör det hela dagen och gång på gång känner av kostnaden för avbrotten.
Varför lokalt först
Lokalt först var inte förhandlingsbart. Inget krav på konto, inget beroende av molnet och inget skrivande som skickas via externa tjänster.
Vad som överraskade oss
- Små statusbuggar kan skada förtroendet mer än uppenbara visuella buggar.
- Avancerade användare märker felaktiga aktiveringar direkt.
- Ingen bad om fler funktioner förrän aktiveringen slutade slå fel.
Den viktigaste lärdomen: tangentbordsverktyg bedöms efter hur konsekventa de är, inte hur nya de är. Om appen beter sig likadant varje gång förtjänar den en permanent plats i arbetsflödet.
Kända begränsningar
- Behörighet för hjälpmedel krävs för global övervakning av utlösaren och infogning i andra appar.
- Appen läser inte av metadata för det aktiva fältet, inte heller om fältet är skyddat. Appar där du inte vill att utlösaren ska övervakas kan läggas till i undantagslistan.
- Vissa anpassade textkontroller tolkar syntetiska Backspace- eller Unicode-tangenthändelser annorlunda, vilket kan göra infogningen mindre tillförlitlig.
- Identifieringen av utlösaren har testats mest med latinska tangentbordslayouter.
Support
Ställ en fråga, rapportera ett problem eller önska en funktion på supportsidan för Emoji Picker. Inget konto krävs.
Prova Emoji Picker
Hittat ett problem? Rapportera det med appversion, macOS-version och steg för att återskapa det.