Technický rozbor
Jak jsme ve Swiftu postavili nativní Emoji Picker pro macOS
Bez Electronu a zbytečné zátěže
Toto je deník vývoje Emoji Picker pro macOS. Vytvořili jsme ho, protože výchozí výběr emoji nás při chatování neustále vytrhával z psaní. Vestavěná možnost vyžadovala přechod na myš a byla pomalá. Cíl byl jednoduchý: napsat, vybrat a pokračovat.
V tomto rozboru
Skutečný problém při práci
macOS už výběr emoji obsahuje. Pro občasné použití stačí. Při intenzivní práci s textem nás ale zdržoval. Otevřít panel, přesunout ruku na myš, vybrat, zavřít panel, znovu se zorientovat. Opakujte to desítkykrát denně a cena přerušení je zřejmá.
Rané interní testování ukázalo, jak otravné jsou falešné aktivace. Pravidla jsme zpřísňovali, dokud aktivace nebyla nudná a předvídatelná: napište ;, zůstaňte v aktuální aplikaci, vyberte klávesnicí a pište dál.
- Podpora a práce s tikety vyžadují rychlé vkládání při třídění mnoha krátkých zpráv.
- V komentářích při code review a v commit zprávách obvykle už víme, co chceme, takže procházení kategorií je pomalejší než napsání dotazu.
- Přepínání stavu panelu více než 40krát denně rychle naruší rytmus psaní.
Architektonická rozhodnutí
Zpracování globálních klávesových zkratek
Vstup řídí event tap Core Graphics spolu s hlídaným stavovým automatem. Omezená vyrovnávací paměť uchovává poslední tisknutelné znaky pro aplikaci v popředí, aby bylo možné rozpoznat nastavený spouštěč. Vynuluje se při změně aplikace, klávesových zkratkách, netisknutelném vstupu a zrušení. Nastavitelné zpoždění vyskakovacího okna udržuje rozhraní v klidu, dokud se dotaz ještě píše.
Volba mezi NSPanel a NSPopover
Začínali jsme s NSPopover a přešli na NSPanel. NSPopover při rychlém přepínání aplikací ve Slacku a Chromu příliš snadno ztrácel fokus. NSPanel nám dal explicitní kontrolu nad životním cyklem a předvídatelné směrování klávesnice napříč aplikacemi.
Oprávnění Zpřístupnění a strategie vkládání
Oprávnění Zpřístupnění umožňuje Emoji Picker sledovat tyto globální události a posílat události klávesnice zpět do aktivní aplikace. Vkládání přes schránku jsme zavrhli, protože přepisování schránky je překvapivé a těžko se mu důvěřuje. Aplikace nezkoumá textové pole přes AXUIElement; při zahájení relace si zaznamená, která aplikace má být v popředí, a před vložením ověří, že je v popředí stále stejná aplikace.
Nahrazení textu podle počtu znaků
Inline relace počítá znaky spouštěče a dotazu, které dorazily do cílové aplikace. Po výběru Emoji Picker odešle stejný počet stisků klávesy Backspace a pak odešle zvolený text Unicode jako syntetickou událost klávesnice. Schránku nikdy nemění. Vlastní ovládací prvky mohou syntetické události klávesnice přesto interpretovat jinak, a proto záleží na kontrole cílové aplikace a na chování při zrušení.
Pravidla rozpoznávání kontextu
Toto jsou praktická pravidla, díky kterým zůstává aktivace předvídatelná:
- Ignorovat vlastní okna Emoji Picker a aplikace ze seznamu výjimek uživatele.
- Vázat nedávný vstup i každou aktivní relaci na aplikaci v popředí; přepnutí aplikace relaci zruší.
- Porovnávat nastavený spouštěč s omezeným koncem nedávného tisknutelného vstupu.
- Inline dotaz přijímá písmena, číslice, podtržítko, plus a spojovník; jakýkoli jiný vstup ho zruší.
- Před zobrazením rozhraní uplatnit uživatelský seznam blokovaných úvodních sekvencí, minimální délku dotazu a zpoždění vyskakovacího okna.
- Podporovat vlastní spouštěč pro přímé otevření (například ;; nebo //) pro uživatele, kteří dávají přednost explicitnímu vyvolání.
Zjednodušená stavová logika (zkráceno kvůli čitelnosti):
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)
}
Chyba, která nás donutila vylepšit model stavů
Jeden problém z poznámek k verzi v1.3 odhalil slepé místo v modelu stavů aktualizátoru: Checking... mohl zůstat zobrazený i po výsledku „žádná aktualizace“ a Available mohl zůstat neznámý. Chyba byla malá, ale dopad na důvěru velký.
Oprava nás donutila zpřísnit stavový automat místo záplatování popisků na místě. Změnilo to, jak ve zbytku aplikace zacházíme se stavem rozhraní: explicitní přechody, méně odvozených stavů a těsnější synchronizace mezi asynchronními kontrolami a viditelným stavem.
- Příznak: zastaralý stavový text aktualizátoru po úspěšné kontrole bez aktualizace.
- Hlavní příčina: neúplné přechody mezi stavy v asynchronních callbackech aktualizací.
- Výsledek: zobrazení stavu teď řídí explicitní přechody mezi stavy.
Poznámky k výkonu
Metrika, na které záleží: čas od spouštěče po vložené emoji. Proto jsme zůstali u nativního běhového prostředí Swift + AppKit místo stacku postaveného na prohlížečovém jádře.
Změřeno na Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, s verzí v1.3.1 z distribuovaného ZIPu. Doba spuštění níže znamená spuštění do zobrazení procesu: od open -n do okamžiku, kdy se objeví proces aplikace.
První spuštění v relaci
217.68 ms (jeden běh, spuštění do zobrazení procesu).
Teplé opětovné spuštění
110.02 ms – medián ze 7 opakovaných spuštění.
Paměť v nečinnosti
110.4 MB RSS podle ps; Monitor aktivity při stejném běhu ukázal 99.4 MB skutečné a 29.6 MB soukromé paměti.
Velikost balíčku
4.49 MB ZIP, 12.96 MB balíček aplikace na disku.
Údaje o paměti uvádíme tak, jak jsou, protože vycházejí z různých modelů účtování. Většinu RSS zde tvoří sdílená paměť frameworku AppKit; soukromá paměť v našich testech zůstává pod 30 MB.
Swift + AppKit vs. Electron pro nástroje na macOS
U nástrojů, které běží neustále, záleží víc na chování za běhu než na přenositelnosti rozhraní. Nativní Swift + AppKit jsme zvolili z těchto praktických důvodů:
- Malý distribuční balíček a přímé spuštění bez zahřívání běhového prostředí JavaScriptu.
- Přímá integrace se Zpřístupněním a vkládáním textu pomocí nativních API macOS.
- Žádný strom procesů vestavěného prohlížečového jádra kvůli lehkému klávesnicovému nástroji.
Naměřené doby spuštění vestavěného nástroje, Raycastu a Emoji Picker najdete na srovnávací stránce.
Kompromisy v návrhu
Proč řádek nabídek
Nástroje v řádku nabídek se snadno udržují spuštěné a rychle se vyvolávají. U tohoto produktu to odpovídalo realitě: uživatelé ho vyvolávají opakovaně v chatech, tiketech, commit zprávách i dokumentaci.
Proč záměrně minimalistické rozhraní
Odstranili jsme téměř všechny dekorativní prvky, které zpomalovaly výběr. Jasné kategorie, zřejmá navigace klávesnicí a minimum okolních prvků se nám při každodenním používání osvědčily víc než bohatší vizuální zpracování.
Kde vestavěný výběr emoji stále vítězí
Pokud emoji vkládáte jen občas, výběr v macOS vám bohatě stačí a nevyžaduje žádné nastavení. Naše aplikace je pro ty, kdo to dělají celý den a znovu a znovu cítí, kolik je ta přerušení stojí.
Proč lokálně
Lokální zpracování pro nás bylo nedotknutelné. Žádný povinný účet, žádná závislost na cloudu a žádné posílání toho, co píšete, přes externí služby.
Co nás překvapilo
- Drobné chyby ve zobrazení stavu mohou poškodit důvěru víc než zjevné vizuální chyby.
- Zkušení uživatelé si falešných aktivací všimnou okamžitě.
- Dokud se aktivace nepřestala spouštět omylem, nikdo o další funkce nestál.
Hlavní poučení: klávesnicové nástroje se posuzují podle spolehlivosti, ne podle novosti. Když se aplikace pokaždé chová stejně, získá si v pracovním postupu trvalé místo.
Známá omezení
- Oprávnění Zpřístupnění je nutné pro globální sledování spouštěče a vkládání napříč aplikacemi.
- Aplikace nezkoumá metadata aktivního pole, ani to, zda jde o zabezpečené pole. Aplikace, ve kterých sledování spouštěče nechcete, můžete přidat na seznam výjimek.
- Některé vlastní textové ovládací prvky interpretují syntetické události Backspace nebo Unicode jinak, což může snížit spolehlivost vkládání.
- Rozpoznávání spouštěče je nejdůkladněji otestované na latinkových rozloženích klávesnice.
Podpora
Zeptejte se, nahlaste problém nebo navrhněte funkci na stránce podpory Emoji Picker. Účet není potřeba.
Vyzkoušejte Emoji Picker
Našli jste problém? Nahlaste ho a uveďte verzi aplikace, verzi macOS a postup, jak ho vyvolat.