Analiză tehnică detaliată

Cum am construit un selector emoji nativ pentru macOS în Swift

Fără Electron, fără balast

Acesta este jurnalul de dezvoltare din spatele Emoji Picker for macOS. L-am construit pentru că selectorul implicit ne tot întrerupea propriul flux de scriere în timp ce conversam pe chat. Opțiunea integrată ne obliga să trecem la mouse și este lentă. Scopul era simplu: tastezi, alegi și mergi mai departe.

Publicat pe 2026-02-16 · de inndevs GmbH

În această analiză detaliată

Problema reală a fluxului de lucru

macOS include deja un selector de emoji. Pentru utilizare ocazională, e în regulă. În fluxurile cu mult text, ne încetinea. Deschizi panoul, muți mâna pe mouse, alegi, închizi panoul, îți recuperezi contextul. Repetă asta de zeci de ori pe zi și costul întreruperii devine evident.

Testele interne timpurii au arătat cât de enervante erau activările false. Am înăsprit regulile până când activarea a devenit plictisitoare și previzibilă: tastezi ;, rămâi în aplicația curentă, alegi cu tastatura, continui să scrii.

  • Fluxurile de suport și tichete au nevoie de inserări rapide atunci când triezi multe mesaje scurte.
  • În comentariile de code review și în mesajele de commit știm de obicei deja ce vrem, așa că răsfoirea pe categorii este mai lentă decât tastarea unei căutări.
  • Comutarea stării panoului de peste 40 de ori pe zi strică rapid ritmul tastării.

Decizii de arhitectură

Gestionarea tastelor rapide globale

Intrarea este gestionată de un event tap Core Graphics plus o mașină de stări protejată. Un buffer limitat, în memorie, păstrează cele mai recente caractere imprimabile pentru aplicația din prim-plan, astfel încât declanșatorul configurat să poată fi recunoscut. Acesta se resetează la schimbarea aplicației, la scurtături, la intrări neimprimabile și la anulare. O întârziere configurabilă a ferestrei pop-up păstrează interfața liniștită cât timp căutarea este încă tastată.

Decizia NSPanel vs. NSPopover

Am început cu NSPopover și am trecut la NSPanel. NSPopover pierdea prea ușor focusul în Slack și Chrome la comutările rapide între aplicații. NSPanel ne-a oferit control explicit asupra ciclului de viață și rutare previzibilă a tastaturii între aplicații.

Permisiunea de accesibilitate și strategia de inserare

Permisiunea de accesibilitate îi permite lui Emoji Picker să monitorizeze aceste evenimente globale și să trimită evenimente de tastatură înapoi către aplicația activă. Am respins inserarea prin clipboard, deoarece suprascrierea conținutului clipboardului este surprinzătoare și greu de acceptat. Aplicația nu inspectează câmpul de text prin AXUIElement; reține aplicația vizată din prim-plan la începutul sesiunii și verifică dacă aceeași aplicație este încă în prim-plan înainte de inserare.

Înlocuire de text numărată

O sesiune inline numără caracterele declanșatorului și ale căutării care au ajuns în aplicația țintă. La selecție, Emoji Picker trimite tot atâtea evenimente de tastă Backspace, apoi trimite textul Unicode ales ca eveniment de tastatură sintetic. Nu modifică niciodată clipboardul. Controalele personalizate pot interpreta totuși diferit evenimentele de tastatură sintetice, de aceea verificările aplicației țintă și comportamentul de anulare contează.

Reguli de detectare a contextului

Acestea sunt regulile practice pe care le folosim ca activarea să rămână previzibilă:

  • Ignoră ferestrele proprii ale Emoji Picker și aplicațiile din lista de excluderi a utilizatorului.
  • Leagă intrările recente și fiecare sesiune activă de aplicația din prim-plan; schimbarea aplicației anulează sesiunea.
  • Compară declanșatorul configurat cu un sufix limitat al intrărilor imprimabile recente.
  • Acceptă litere, cifre, liniuță jos, plus și cratimă într-o căutare inline; orice altă intrare o anulează.
  • Aplică lista de blocare a secvențelor de deschidere, lungimea minimă a căutării și întârzierea ferestrei pop-up setate de utilizator înainte de afișarea interfeței.
  • Permite personalizarea declanșatorului de deschidere directă (de exemplu ;; sau //) pentru utilizatorii care preferă invocarea explicită.

Logica de stare simplificată (prescurtată pentru lizibilitate):

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 declanșator căutare cu debounce confirmare, pierderea focusului sau anulare
Prezentarea fluxului de stări: idle -> tracking -> open -> idle.

Un bug care ne-a obligat la un model de stare mai bun

O problemă din notele de modificări pentru v1.3 a scos la iveală un punct orb în modelul de stare al actualizatorului: Checking... putea rămâne vizibil după un rezultat fără actualizări, iar Available putea rămâne necunoscut. Bugul era mic, dar impactul asupra încrederii a fost mare.

Remedierea ne-a obligat să înăsprim mașina de stări în loc să peticim etichetele pe loc. Asta a schimbat felul în care tratăm starea interfeței în restul aplicației: tranziții explicite, mai puține stări deduse și o sincronizare mai strânsă între verificările asincrone și starea vizibilă.

  • Simptom: textul de stare al actualizatorului rămânea învechit după verificări reușite fără actualizări.
  • Cauza principală: tranziții de stare incomplete în callbackurile asincrone de actualizare.
  • Rezultat: afișarea stării este acum controlată de tranziții de stare explicite.

Note despre performanță

Metrica ce contează: timpul de la declanșator până la emojiul inserat. De aceea am rămas la un runtime nativ Swift + AppKit în loc de o stivă bazată pe un motor de browser.

Măsurat pe Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, folosind v1.3.1 din ZIP-ul livrat. Timpul de lansare de mai jos înseamnă pornirea vizibilă la nivel de proces, de la open -n până la apariția procesului aplicației.

Prima lansare din sesiune

217.68 ms (o singură rulare, pornire vizibilă la nivel de proces).

Relansare la cald

Mediană de 110.02 ms pe parcursul a 7 relansări.

Memorie în repaus

110.4 MB RSS prin ps; Monitor activitate a arătat la aceeași rulare 99.4 MB memorie reală și 29.6 MB memorie privată.

Dimensiunea pachetului

4.49 MB ZIP, 12.96 MB pachetul aplicației pe disc.

Valorile de memorie sunt prezentate ca atare, deoarece folosesc modele de calcul diferite. Cea mai mare parte din RSS este aici memorie partajată a frameworkului AppKit; în testele noastre, memoria privată rămâne sub 30 MB.

Swift + AppKit vs. Electron pentru utilitare macOS

Pentru utilitarele care rulează permanent, modul în care se comportă la rulare contează mai mult decât portabilitatea interfeței. Am ales Swift + AppKit nativ din aceste motive practice:

  • Pachet de distribuție mic și pornire directă, fără încălzirea unui runtime JavaScript.
  • Integrare directă pentru accesibilitate și inserarea textului, folosind API-uri native macOS.
  • Fără arborele de procese al unui motor de browser încorporat pentru un utilitar ușor de tastatură.

Pentru timpii de pornire măsurați la instrumentul integrat, Raycast și Emoji Picker, vezi pagina de comparație.

Compromisuri de design

De ce în bara de meniu

Instrumentele din bara de meniu sunt ușor de ținut active și rapid de apelat. Pentru acest produs, asta s-a potrivit cu realitatea: utilizatorii îl apelează în mod repetat în chaturi, tichete, mesaje de commit și documente.

De ce o interfață minimală intenționat

Am eliminat aproape fiecare element decorativ care încetinea alegerea. Categoriile clare, navigarea evidentă cu tastatura și elementele de interfață minime au funcționat mai bine decât tratamentele vizuale bogate în propria noastră utilizare zilnică.

Unde selectorul integrat încă e mai bun

Dacă inserezi rar emoji, selectorul din macOS este deja suficient de bun și nu necesită nicio configurare. Aplicația noastră este pentru cei care fac asta toată ziua și simt iar și iar costul întreruperii.

De ce local-first

Abordarea local-first a fost nenegociabilă. Fără cont obligatoriu, fără dependență de cloud și fără ca ceea ce tastezi să treacă prin servicii externe.

Ce ne-a surprins

  • Bugurile mici de stare pot afecta încrederea mai mult decât bugurile vizuale evidente.
  • Utilizatorii avansați observă imediat activările false.
  • Nimeni n-a cerut funcții noi până când activarea n-a încetat să se declanșeze greșit.

Lecția principală: instrumentele de tastatură sunt judecate după consecvență, nu după noutate. Dacă aplicația se comportă la fel de fiecare dată, își câștigă un loc permanent în fluxul de lucru.

Limitări cunoscute

  • Permisiunea de accesibilitate este necesară pentru monitorizarea globală a declanșatorului și pentru inserarea în alte aplicații.
  • Aplicația nu inspectează metadatele câmpului activ, inclusiv dacă un câmp este securizat. Aplicațiile în care nu se dorește monitorizarea declanșatorului pot fi adăugate în lista de excluderi.
  • Unele controale de text personalizate interpretează diferit evenimentele de tastatură sintetice Backspace sau Unicode, ceea ce poate reduce fiabilitatea inserării.
  • Detectarea declanșatorului a fost testată cel mai intens pe aranjamente de tastatură latine.

Suport

Pune o întrebare, raportează o problemă sau cere o funcție pe pagina de suport Emoji Picker. Nu este nevoie de cont.

Încearcă Emoji Picker

Ai găsit o problemă? Raporteaz-o împreună cu versiunea aplicației, versiunea macOS și pașii de reproducere.