Artigo técnico

Criando um seletor de emojis nativo para macOS em Swift

Sem Electron, sem excessos

Este é o diário de desenvolvimento do Emoji Picker para macOS. Nós o criamos porque o seletor padrão vivia interrompendo nosso fluxo de escrita nos chats. A opção nativa exigia ir até o mouse e era lenta de usar. O objetivo era simples: digitar, escolher e seguir em frente.

Publicado em 16 de fevereiro de 2026 · por inndevs GmbH

Neste artigo

O verdadeiro problema do fluxo de trabalho

O macOS já vem com um seletor de emojis. Para uso ocasional, ele resolve. Em fluxos de trabalho com muito texto, ele nos atrasava. Abrir o painel, levar a mão ao mouse, escolher, fechar o painel, retomar o contexto. Repita isso dezenas de vezes por dia e o custo da interrupção fica evidente.

Os primeiros testes internos mostraram como as ativações indevidas eram irritantes. Apertamos as regras até a ativação ficar sem graça e previsível: digite ;, continue no app atual, escolha pelo teclado e siga escrevendo.

  • Fluxos de suporte e de tickets exigem inserções rápidas na triagem de muitas mensagens curtas.
  • Em comentários de code review e mensagens de commit, geralmente já sabemos o que queremos, então navegar por categorias é mais lento do que digitar uma busca.
  • Alternar o estado do painel mais de 40 vezes por dia quebra rápido o ritmo da digitação.

Decisões de arquitetura

Tratamento de atalhos globais

A entrada é tratada por um event tap do Core Graphics mais uma máquina de estados protegida. Um buffer limitado em memória guarda os caracteres imprimíveis mais recentes do app em primeiro plano para que o acionamento configurado possa ser reconhecido. Ele é zerado ao trocar de app, usar atalhos, digitar caracteres não imprimíveis ou cancelar. Um atraso configurável do pop-up mantém a interface tranquila enquanto a busca ainda está sendo digitada.

A decisão entre NSPanel e NSPopover

Começamos com NSPopover e mudamos para NSPanel. O NSPopover perdia o foco com muita facilidade no Slack e no Chrome durante trocas rápidas de app. O NSPanel nos deu controle explícito do ciclo de vida e um roteamento de teclado previsível entre apps.

Permissão de Acessibilidade e estratégia de inserção

A permissão de Acessibilidade permite que o Emoji Picker monitore esses eventos globais e envie eventos de teclado de volta ao app ativo. Descartamos a inserção pela área de transferência porque sobrescrever o conteúdo dela é inesperado e difícil de confiar. O app não inspeciona campos de texto via AXUIElement; ele registra o app em primeiro plano pretendido quando uma sessão começa e verifica se esse mesmo app continua em primeiro plano antes da inserção.

Substituição de texto por contagem

Uma sessão em linha conta os caracteres de acionamento e de busca que chegaram ao app de destino. Na seleção, o Emoji Picker envia esse mesmo número de eventos da tecla Backspace e depois envia o texto Unicode escolhido como um evento de teclado sintético. Ele nunca altera a área de transferência. Controles personalizados ainda podem interpretar eventos de teclado sintéticos de outra forma, e é por isso que as verificações do app de destino e o comportamento de cancelamento são importantes.

Regras de detecção de contexto

Estas são as regras práticas que usamos para manter a ativação previsível:

  • Ignorar as janelas do próprio Emoji Picker e os apps na lista de exclusão do usuário.
  • Vincular a entrada recente e cada sessão ativa ao app em primeiro plano; trocar de app cancela a sessão.
  • Comparar o acionamento configurado com um trecho final limitado da entrada imprimível recente.
  • Aceitar letras, números, sublinhado, sinal de mais e hífen em uma busca em linha; qualquer outra entrada a cancela.
  • Aplicar a lista de sequências iniciais bloqueadas pelo usuário, o tamanho mínimo da busca e o atraso do pop-up antes de mostrar a interface.
  • Permitir personalizar um acionamento de abertura direta (por exemplo, ;; ou //) para quem prefere chamar o seletor explicitamente.

Lógica de estado simplificada (resumida para facilitar a leitura):

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 acionamento busca com debounce confirmar, perder o foco ou cancelar
Visão geral do fluxo de estados: idle -> tracking -> open -> idle.

Um bug que nos obrigou a criar um modelo de estado melhor

Um problema citado nas notas da v1.3 revelou um ponto cego no nosso modelo de status de atualização: Checking... podia continuar visível depois de um resultado sem atualizações, e Available podia ficar indefinido. O bug era pequeno, mas o impacto na confiança foi grande.

Corrigir isso nos obrigou a deixar a máquina de estados mais rigorosa, em vez de remendar os rótulos no lugar. Isso mudou a forma como tratamos o status da interface no resto do app: transições explícitas, menos estados inferidos e uma sincronia mais forte entre as verificações assíncronas e o status visível.

  • Sintoma: texto de status de atualização desatualizado após verificações bem-sucedidas sem atualizações.
  • Causa raiz: transições de estado incompletas com callbacks assíncronos de atualização.
  • Resultado: agora são transições de estado explícitas que determinam a exibição do status.

Notas sobre desempenho

A métrica que importa: o tempo entre o acionamento e o emoji inserido. É por isso que ficamos com um runtime nativo em Swift + AppKit em vez de uma stack baseada em motor de navegador.

Medido em um Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, usando a v1.3.1 do ZIP distribuído. O tempo de abertura abaixo é a inicialização desde open -n até o processo do app aparecer.

Primeira abertura na sessão

217.68 ms (execução única, inicialização até o processo ficar visível).

Reabertura a quente

110.02 ms de mediana em 7 reaberturas.

Memória ociosa

110.4 MB RSS pelo ps; na mesma execução, o Monitor de Atividade mostrou 99.4 MB de memória real e 29.6 MB de memória privada.

Tamanho do pacote

4.49 MB de ZIP, 12.96 MB de pacote do app em disco.

As métricas de memória são apresentadas como estão porque usam modelos de contabilização diferentes. A maior parte do RSS aqui é memória compartilhada dos frameworks do AppKit; nos nossos testes, a memória privada fica abaixo de 30 MB.

Swift + AppKit vs. Electron para utilitários do macOS

Em utilitários sempre ativos, o comportamento em tempo de execução importa mais do que a portabilidade da interface. Escolhemos Swift + AppKit nativos por estes motivos práticos:

  • Pacote de distribuição pequeno e inicialização direta, sem aquecimento de runtime JavaScript.
  • Integração direta de acessibilidade e inserção de texto usando APIs nativas do macOS.
  • Nenhuma árvore de processos de um motor de navegador embutido para um utilitário de teclado leve.

Para ver os tempos de inicialização medidos da ferramenta nativa, do Raycast e do Emoji Picker, consulte a página de comparação.

Concessões de design

Por que a barra de menus

Ferramentas da barra de menus são fáceis de manter abertas e rápidas de chamar. Para este produto, isso batia com a realidade: os usuários o chamam várias vezes em chats, tickets, mensagens de commit e documentos.

Por que uma interface propositalmente mínima

Removemos quase todos os elementos decorativos que atrasavam a escolha. Categorias claras, navegação por teclado óbvia e o mínimo de interface funcionaram melhor do que visuais mais elaborados no nosso uso diário.

Onde o seletor nativo ainda ganha

Se você insere emojis raramente, o seletor do macOS já dá conta e não exige nenhuma configuração. Nosso app é para quem faz isso o dia todo e sente o custo da interrupção repetidamente.

Por que local-first

Ser local-first era inegociável. Sem exigir conta, sem depender da nuvem e sem passar o que você digita por serviços externos.

O que nos surpreendeu

  • Pequenos bugs de status podem abalar mais a confiança do que bugs visuais óbvios.
  • Usuários avançados percebem na hora quando há ativações indevidas.
  • Ninguém pediu mais recursos até a ativação parar de disparar à toa.

A principal lição: ferramentas de teclado são julgadas pela consistência, não pela novidade. Se o app se comporta sempre do mesmo jeito, ele conquista um lugar fixo no fluxo de trabalho.

Limitações conhecidas

  • A permissão de Acessibilidade é necessária para monitorar o acionamento global e inserir texto em outros apps.
  • O app não inspeciona os metadados do campo em foco, nem mesmo se ele é um campo seguro. Os apps em que você não quer o monitoramento do acionamento podem ser adicionados à lista de exclusão.
  • Alguns controles de texto personalizados interpretam de outra forma os eventos sintéticos de Backspace ou Unicode e podem reduzir a confiabilidade da inserção.
  • A detecção do acionamento foi testada principalmente com layouts de teclado latinos.

Suporte

Faça uma pergunta, relate um problema ou peça um recurso na página de suporte do Emoji Picker. Não é preciso ter conta.

Experimente o Emoji Picker

Encontrou um problema? Relate-o com a versão do app, a versão do macOS e os passos para reproduzi-lo.