Analyse technique

Créer un sélecteur d’emoji natif pour macOS en Swift

Sans Electron, sans superflu

Voici le journal de bord derrière Emoji Picker pour macOS. Nous l’avons créé parce que le sélecteur par défaut interrompait sans cesse notre propre écriture pendant nos conversations. L’option intégrée obligeait à passer à la souris et était lente à utiliser. L’objectif était simple : taper, choisir et continuer.

Publié le 2026-02-16 · par inndevs GmbH

Dans cette analyse

Le vrai problème au quotidien

macOS intègre déjà un sélecteur d’emoji. Pour un usage occasionnel, il fait l’affaire. Mais quand on écrit beaucoup, il nous ralentissait. Ouvrir le panneau, prendre la souris, choisir, fermer le panneau, retrouver le fil. Répétez cela des dizaines de fois par jour et le coût de l’interruption devient évident.

Les premiers tests internes ont montré à quel point les déclenchements intempestifs étaient agaçants. Nous avons resserré les règles jusqu’à ce que l’activation devienne banale et prévisible : tapez ;, restez dans l’app en cours, choisissez au clavier, continuez à écrire.

  • Dans le support et le traitement des tickets, il faut insérer vite en triant de nombreux messages courts.
  • Dans les commentaires de revue de code et les messages de commit, on sait généralement déjà ce que l’on veut : parcourir les catégories est alors plus lent que de taper une requête.
  • Changer l’état du panneau plus de 40 fois par jour casse vite le rythme de frappe.

Choix d’architecture

Gestion des raccourcis globaux

La saisie repose sur un event tap Core Graphics et sur une machine à états protégée. Un tampon limité, conservé en mémoire, garde les derniers caractères imprimables de l’app au premier plan afin de reconnaître le déclencheur configuré. Il est réinitialisé lors d’un changement d’app, d’un raccourci, d’une saisie non imprimable ou d’une annulation. Un délai d’affichage réglable garde l’interface discrète tant qu’une requête est en cours de saisie.

NSPanel ou NSPopover : notre choix

Nous avons commencé avec NSPopover, puis sommes passés à NSPanel. NSPopover perdait trop facilement le focus dans Slack et Chrome lors de changements d’app rapides. NSPanel nous a donné un contrôle explicite du cycle de vie et un acheminement prévisible du clavier d’une app à l’autre.

Autorisation Accessibilité et stratégie d’insertion

L’autorisation Accessibilité permet à Emoji Picker de surveiller ces événements globaux et de renvoyer des événements clavier à l’app active. Nous avons écarté l’insertion via le presse-papiers, car modifier son contenu est déroutant et inspire peu confiance. L’app n’inspecte pas les champs de texte via AXUIElement ; elle enregistre l’app censée être au premier plan au début d’une session et vérifie que c’est toujours elle qui est au premier plan avant l’insertion.

Remplacement de texte compté

Une session en ligne compte les caractères du déclencheur et de la requête qui ont atteint l’app cible. Lors de la sélection, Emoji Picker envoie autant d’événements de touche Retour arrière, puis envoie le texte Unicode choisi sous forme d’événement clavier synthétique. Le presse-papiers n’est jamais modifié. Certaines commandes personnalisées peuvent toutefois interpréter différemment les événements clavier synthétiques : c’est pourquoi la vérification de l’app cible et le comportement d’annulation sont importants.

Règles de détection du contexte

Voici les règles concrètes que nous appliquons pour que l’activation reste prévisible :

  • Ignorer les fenêtres d’Emoji Picker et les apps figurant dans la liste d’exclusion de l’utilisateur.
  • Associer la saisie récente et chaque session active à l’app au premier plan ; changer d’app annule la session.
  • Comparer le déclencheur configuré à un suffixe limité de la saisie imprimable récente.
  • Accepter les lettres, les chiffres, le tiret bas, le plus et le trait d’union dans une requête en ligne ; toute autre saisie l’annule.
  • Appliquer la liste de séquences d’ouverture bloquées, la longueur minimale de requête et le délai d’affichage choisis par l’utilisateur avant d’afficher l’interface.
  • Permettre de personnaliser le déclencheur d’ouverture directe (par exemple ;; ou //) pour ceux qui préfèrent une invocation explicite.

Logique d’état simplifiée (abrégée pour plus de lisibilité) :

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 déclencheur requête temporisée validation, perte du focus ou annulation
Vue d’ensemble du flux d’état : idle -> tracking -> open -> idle.

Un bug qui nous a imposé un meilleur modèle d’état

Un problème mentionné dans les notes de version de la v1.3 a révélé un angle mort dans notre modèle d’état des mises à jour : Checking... pouvait rester affiché après un résultat sans mise à jour, et Available pouvait rester inconnu. Le bug était mineur, mais son impact sur la confiance était important.

Pour le corriger, nous avons dû resserrer la machine à états au lieu de rafistoler les libellés au cas par cas. Cela a changé notre façon de gérer l’état de l’interface dans le reste de l’app : des transitions explicites, moins d’états déduits et une meilleure synchronisation entre les vérifications asynchrones et l’état affiché.

  • Symptôme : un texte d’état de mise à jour périmé après une vérification réussie sans mise à jour.
  • Cause : des transitions d’état incomplètes lors des rappels asynchrones de mise à jour.
  • Résultat : ce sont désormais des transitions d’état explicites qui pilotent l’affichage de l’état.

Notes sur les performances

La mesure qui compte : le temps entre le déclencheur et l’emoji inséré. C’est pourquoi nous sommes restés sur Swift + AppKit en natif plutôt que sur une pile reposant sur un moteur de navigateur.

Mesuré sur Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, avec la v1.3.1 issue du ZIP distribué. Le temps de lancement ci-dessous correspond au démarrage depuis open -n jusqu’à l’apparition du processus de l’app.

Premier lancement de la session

217.68 ms (mesure unique, démarrage jusqu’à la visibilité du processus).

Relancement à chaud

Médiane de 110.02 ms sur 7 relancements.

Mémoire au repos

110.4 MB RSS via ps ; lors de la même mesure, le Moniteur d’activité indiquait 99.4 MB de mémoire réelle et 29.6 MB de mémoire privée.

Taille du paquet

ZIP de 4.49 MB, bundle d’app de 12.96 MB sur le disque.

Les mesures de mémoire sont présentées telles quelles, car elles reposent sur des modèles de comptabilisation différents. L’essentiel du RSS correspond ici à la mémoire partagée du framework AppKit ; la mémoire privée reste inférieure à 30 MB lors de nos tests.

Swift + AppKit vs Electron pour les utilitaires macOS

Pour un utilitaire toujours actif, le comportement à l’exécution compte plus que la portabilité de l’interface. Nous avons choisi Swift + AppKit en natif pour ces raisons pratiques :

  • Un fichier de distribution léger et un démarrage direct, sans préchauffage d’un environnement JavaScript.
  • Intégration directe de l’accessibilité et de l’insertion de texte grâce aux API natives de macOS.
  • Aucune arborescence de processus de moteur de navigateur embarquée pour un simple utilitaire clavier.

Pour les temps de démarrage mesurés de l’outil intégré, de Raycast et d’Emoji Picker, consultez la page de comparaison.

Compromis de conception

Pourquoi la barre des menus

Les outils de la barre des menus restent facilement actifs et s’appellent rapidement. Pour ce produit, cela correspondait à la réalité : on l’utilise sans cesse dans les conversations, les tickets, les messages de commit et la documentation.

Pourquoi une interface volontairement minimaliste

Nous avons supprimé presque tous les éléments décoratifs qui ralentissaient le choix. Des catégories claires, une navigation au clavier évidente et une interface épurée ont mieux fonctionné que des traitements visuels plus riches dans notre propre usage quotidien.

Là où le sélecteur intégré reste le meilleur

Si vous insérez rarement des emojis, le sélecteur de macOS suffit largement et ne demande aucune configuration. Notre app s’adresse à ceux qui en insèrent toute la journée et ressentent sans cesse le coût de l’interruption.

Pourquoi le local d’abord

Le fonctionnement local était non négociable. Pas de compte obligatoire, pas de dépendance au cloud, et aucune frappe acheminée par des services externes.

Ce qui nous a surpris

  • De petits bugs d’état peuvent nuire davantage à la confiance que des bugs visuels évidents.
  • Les utilisateurs avancés remarquent immédiatement les déclenchements intempestifs.
  • Personne n’a demandé plus de fonctionnalités tant que l’activation se déclenchait à tort.

La principale leçon : un outil clavier se juge à sa constance, pas à sa nouveauté. Si l’app se comporte toujours de la même façon, elle gagne une place durable dans le quotidien.

Limites connues

  • L’autorisation Accessibilité est nécessaire pour surveiller le déclencheur global et insérer du texte dans d’autres apps.
  • L’app n’inspecte pas les métadonnées du champ actif, y compris le fait qu’il soit sécurisé ou non. Les apps dans lesquelles la surveillance du déclencheur n’est pas souhaitée peuvent être ajoutées à la liste d’exclusion.
  • Certaines commandes de texte personnalisées interprètent différemment les événements synthétiques de Retour arrière ou de clavier Unicode, ce qui peut rendre l’insertion moins fiable.
  • La détection du déclencheur a surtout été testée avec des dispositions de clavier latines.

Assistance

Posez une question, signalez un problème ou demandez une fonctionnalité sur la page d’assistance d’Emoji Picker. Aucun compte requis.

Essayer Emoji Picker

Vous avez trouvé un problème ? Signalez-le en indiquant la version de l’app, la version de macOS et les étapes pour le reproduire.