Approfondimento tecnico
Creare un emoji picker nativo per macOS in Swift
Niente Electron, niente zavorra
Questo è il diario di sviluppo di Emoji Picker per macOS. L’abbiamo creato perché il picker predefinito continuava a interrompere il nostro flusso di scrittura mentre chattavamo. L’opzione integrata richiedeva di passare al mouse ed era lenta da usare. L’obiettivo era semplice: digita, scegli e vai avanti.
In questo approfondimento
Il vero problema del flusso di lavoro
macOS include già un picker di emoji. Per un uso occasionale va benissimo. Nei flussi di lavoro con molto testo, però, ci rallentava. Apri il pannello, sposta la mano sul mouse, scegli, chiudi il pannello, ritrova il contesto. Ripetilo decine di volte al giorno e il costo dell’interruzione diventa evidente.
I primi test interni hanno mostrato quanto fossero fastidiose le attivazioni involontarie. Abbiamo stretto le regole finché l’attivazione è diventata noiosa e prevedibile: digiti ;, resti nell’app in cui sei, scegli da tastiera e continui a scrivere.
- Nel supporto e nella gestione dei ticket servono inserimenti rapidi mentre si smistano tanti messaggi brevi.
- Nei commenti di code review e nei messaggi di commit di solito sappiamo già cosa vogliamo, quindi sfogliare le categorie è più lento che digitare una query.
- Cambiare lo stato del pannello più di 40 volte al giorno spezza in fretta il ritmo di scrittura.
Scelte architetturali
Gestione delle scorciatoie globali
L’input è gestito da un event tap di Core Graphics e da una macchina a stati protetta. Un buffer limitato in memoria conserva gli ultimi caratteri stampabili dell’app in primo piano, così da riconoscere il tasto di attivazione configurato. Si azzera quando cambi app, usi una scorciatoia, digiti caratteri non stampabili o annulli. Un ritardo del popup configurabile mantiene l’interfaccia tranquilla mentre stai ancora digitando la query.
La scelta tra NSPanel e NSPopover
Siamo partiti con NSPopover e siamo passati a NSPanel. NSPopover perdeva il focus troppo facilmente in Slack e Chrome durante i passaggi rapidi tra app. NSPanel ci ha dato un controllo esplicito sul ciclo di vita e un instradamento della tastiera prevedibile tra un’app e l’altra.
Permesso di accessibilità e strategia di inserimento
Il permesso di accessibilità consente a Emoji Picker di monitorare questi eventi globali e di inviare eventi da tastiera all’app attiva. Abbiamo scartato l’inserimento tramite appunti, perché sovrascrivere gli appunti è sorprendente e difficile da considerare affidabile. L’app non ispeziona i campi di testo tramite AXUIElement: quando inizia una sessione registra l’app in primo piano prevista e, prima dell’inserimento, verifica che sia ancora quella in primo piano.
Sostituzione del testo a conteggio
Una sessione in linea conta i caratteri di attivazione e di query arrivati all’app di destinazione. Alla selezione, Emoji Picker invia altrettanti eventi del tasto Backspace e poi invia il testo Unicode scelto come evento da tastiera sintetico. Non modifica mai gli appunti. I controlli personalizzati possono comunque interpretare in modo diverso gli eventi da tastiera sintetici: per questo contano i controlli sull’app di destinazione e il comportamento di annullamento.
Regole di rilevamento del contesto
Queste sono le regole pratiche che usiamo per mantenere l’attivazione prevedibile:
- Ignorare le finestre di Emoji Picker e le app nell’elenco delle esclusioni dell’utente.
- Associare l’input recente e ogni sessione attiva all’app in primo piano; cambiando app la sessione viene annullata.
- Confrontare l’attivazione configurata con una porzione finale limitata dell’input stampabile recente.
- In una query in linea sono ammessi lettere, numeri, trattino basso, più e trattino; qualsiasi altro input la annulla.
- Prima di mostrare l’interfaccia, applica l’elenco delle sequenze iniziali bloccate dall’utente, la lunghezza minima della query e il ritardo del popup.
- Supportare la personalizzazione di un’attivazione ad apertura diretta (per esempio ;; o //) per chi preferisce un richiamo esplicito.
Logica di stato semplificata (ridotta per leggibilità):
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)
}
Un bug che ci ha imposto un modello di stato migliore
Un problema riportato nelle novità della v1.3 ha messo in luce un punto cieco nel modello di stato degli aggiornamenti: Checking... poteva restare visibile anche quando non c’erano aggiornamenti, e Available poteva restare indeterminato. Il bug era piccolo, ma l’impatto sulla fiducia era grande.
Per risolverlo abbiamo dovuto rendere più rigorosa la macchina a stati, invece di correggere le etichette sul posto. Questo ha cambiato il modo in cui gestiamo lo stato dell’interfaccia nel resto dell’app: transizioni esplicite, meno stati dedotti e una sincronizzazione più solida tra i controlli asincroni e lo stato visibile.
- Sintomo: testo di stato degli aggiornamenti non aggiornato dopo un controllo riuscito senza aggiornamenti.
- Causa: transizioni di stato incomplete con le callback asincrone degli aggiornamenti.
- Risultato: ora sono le transizioni di stato esplicite a determinare la visualizzazione dello stato.
Note sulle prestazioni
La metrica che conta: il tempo dall’attivazione all’emoji inserita. Per questo siamo rimasti su un runtime nativo Swift + AppKit invece di uno stack basato su un motore browser.
Misurato su Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, con la v1.3.1 dello ZIP distribuito. Il tempo di avvio qui sotto indica l’avvio da open -n fino alla comparsa del processo dell’app.
Primo avvio nella sessione
217.68 ms (esecuzione singola, avvio fino alla visibilità del processo).
Riavvio a caldo
110.02 ms di mediana su 7 riavvii.
Memoria a riposo
110.4 MB RSS secondo ps; Monitoraggio Attività, nella stessa esecuzione, mostrava 99.4 MB di memoria reale e 29.6 MB di memoria privata.
Dimensione del pacchetto
4.49 MB lo ZIP, 12.96 MB il pacchetto dell’app su disco.
Le metriche di memoria sono riportate così come sono, perché usano modelli di calcolo diversi. Gran parte della RSS è memoria condivisa dei framework AppKit; nei nostri test la memoria privata resta sotto i 30 MB.
Swift + AppKit vs Electron per le utility macOS
Per le utility sempre attive, il comportamento a runtime conta più della portabilità dell’interfaccia. Abbiamo scelto Swift + AppKit nativi per questi motivi pratici:
- Un pacchetto di distribuzione piccolo e un avvio diretto, senza il riscaldamento di un runtime JavaScript.
- Integrazione diretta di accessibilità e inserimento del testo tramite API native di macOS.
- Nessun albero di processi di un motore browser incorporato per una leggera utility da tastiera.
Per i tempi di avvio misurati dello strumento integrato, di Raycast e di Emoji Picker, consulta la pagina di confronto.
Compromessi di design
Perché la barra dei menu
Gli strumenti nella barra dei menu restano attivi facilmente e si richiamano in un attimo. Per questo prodotto corrispondeva alla realtà: gli utenti lo richiamano di continuo in chat, ticket, messaggi di commit e documenti.
Perché un’interfaccia volutamente minimale
Abbiamo eliminato quasi tutti gli elementi decorativi che rallentavano la scelta. Categorie chiare, navigazione da tastiera evidente e un’interfaccia essenziale hanno funzionato meglio di trattamenti visivi più ricchi nel nostro uso quotidiano.
Dove il picker integrato resta migliore
Se inserisci emoji di rado, il picker di macOS è già sufficiente e non richiede alcuna configurazione. La nostra app è per chi lo fa tutto il giorno e sente di continuo il costo dell’interruzione.
Perché local-first
Il local-first non era negoziabile. Nessun account obbligatorio, nessuna dipendenza dal cloud e nessun dato di digitazione inviato a servizi esterni.
Cosa ci ha sorpreso
- I piccoli bug di stato possono minare la fiducia più dei bug visivi evidenti.
- Gli utenti esperti notano subito le attivazioni involontarie.
- Nessuno ha chiesto nuove funzioni finché l’attivazione non ha smesso di scattare a vuoto.
La lezione principale: gli strumenti da tastiera vengono giudicati per la coerenza, non per la novità. Se l’app si comporta sempre allo stesso modo, si guadagna un posto fisso nel flusso di lavoro.
Limiti noti
- Il permesso di accessibilità è necessario per monitorare il tasto di attivazione a livello globale e per inserire testo in altre app.
- L’app non ispeziona i metadati del campo attivo, nemmeno per sapere se è un campo protetto. Le app in cui non vuoi il monitoraggio dell’attivazione possono essere aggiunte all’elenco delle esclusioni.
- Alcuni controlli di testo personalizzati interpretano in modo diverso gli eventi sintetici di Backspace o Unicode e possono rendere l’inserimento meno affidabile.
- Il rilevamento dell’attivazione è stato testato soprattutto con layout di tastiera latini.
Supporto
Fai una domanda, segnala un problema o richiedi una funzione nella pagina di supporto di Emoji Picker. Non serve un account.
Prova Emoji Picker
Hai trovato un problema? Segnalalo indicando la versione dell’app, la versione di macOS e i passaggi per riprodurlo.