Análisis técnico

Cómo crear un selector de emojis nativo para macOS en Swift

Sin Electron y sin lastre

Esta es la crónica del desarrollo de Emoji Picker para macOS. Lo creamos porque el selector predeterminado no paraba de interrumpir nuestra propia escritura mientras chateábamos. La opción integrada obligaba a usar el ratón y era lenta. El objetivo era sencillo: escribir, elegir y seguir adelante.

Publicado el 2026-02-16 · por inndevs GmbH

En este análisis

El verdadero problema del día a día

macOS ya incluye un selector de emojis. Para un uso ocasional, está bien. Pero cuando se escribe mucho, nos frenaba. Abrir el panel, llevar la mano al ratón, elegir, cerrar el panel, recuperar el contexto. Repítelo decenas de veces al día y el costo de la interrupción salta a la vista.

Las primeras pruebas internas demostraron lo molestas que eran las activaciones indebidas. Ajustamos las reglas hasta que la activación resultó aburrida y predecible: escribe ;, quédate en la app actual, elige con el teclado y sigue escribiendo.

  • En el soporte y la gestión de tickets hacen falta inserciones rápidas al clasificar muchos mensajes cortos.
  • En los comentarios de revisión de código y los mensajes de commit solemos saber ya lo que queremos, así que explorar categorías es más lento que escribir una búsqueda.
  • Cambiar el estado del panel más de 40 veces al día rompe enseguida el ritmo de escritura.

Decisiones de arquitectura

Gestión de atajos globales

La entrada se basa en un event tap de Core Graphics y en una máquina de estados protegida. Un búfer limitado en memoria guarda los últimos caracteres imprimibles de la app en primer plano para poder reconocer el activador configurado. Se reinicia al cambiar de app, al usar atajos, con entradas no imprimibles y al cancelar. Un retardo configurable de la ventana emergente mantiene la interfaz tranquila mientras aún se escribe la búsqueda.

NSPanel o NSPopover: la decisión

Empezamos con NSPopover y pasamos a NSPanel. NSPopover perdía el foco con demasiada facilidad en Slack y Chrome al cambiar rápido de app. NSPanel nos dio un control explícito del ciclo de vida y un enrutamiento del teclado predecible entre apps.

Permiso de Accesibilidad y estrategia de inserción

El permiso de Accesibilidad permite a Emoji Picker supervisar esos eventos globales y enviar eventos de teclado a la app activa. Descartamos la inserción mediante el portapapeles porque sobrescribir su contenido resulta inesperado y genera poca confianza. La app no inspecciona los campos de texto mediante AXUIElement; registra la app que debería estar en primer plano al iniciar una sesión y comprueba que sigue en primer plano antes de insertar.

Sustitución de texto contada

Una sesión en línea cuenta los caracteres del activador y de la búsqueda que han llegado a la app de destino. Al seleccionar, Emoji Picker envía ese mismo número de pulsaciones de la tecla de retroceso y después envía el texto Unicode elegido como evento de teclado sintético. Nunca modifica el portapapeles. Aun así, algunos controles personalizados pueden interpretar los eventos de teclado sintéticos de otra forma, por eso importan las comprobaciones de la app de destino y el comportamiento de cancelación.

Reglas de detección de contexto

Estas son las reglas prácticas que seguimos para que la activación sea predecible:

  • Ignorar las ventanas de Emoji Picker y las apps de la lista de exclusión del usuario.
  • Vincular la entrada reciente y cada sesión activa a la app en primer plano; cambiar de app cancela la sesión.
  • Comparar el activador configurado con un sufijo limitado de la entrada imprimible reciente.
  • Aceptar letras, números, guion bajo, signo más y guion en una búsqueda en línea; cualquier otra entrada la cancela.
  • Aplicar la lista de secuencias de apertura bloqueadas, la longitud mínima de búsqueda y el retardo de la ventana emergente que haya definido el usuario antes de mostrar la interfaz.
  • Permitir personalizar el activador de apertura directa (por ejemplo, ;; o //) para quienes prefieren invocarlo de forma explícita.

Lógica de estados simplificada (recortada para facilitar la lectura):

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 activador búsqueda con debounce confirmar, perder el foco o cancelar
Resumen del flujo de estados: idle -> tracking -> open -> idle.

Un error que nos obligó a mejorar el modelo de estados

Un problema recogido en las notas de la v1.3 dejó al descubierto un punto ciego en nuestro modelo de estado del actualizador: Checking... podía seguir visible tras comprobar que no había actualizaciones, y Available podía quedarse como desconocido. El error era pequeño, pero su impacto en la confianza fue grande.

Para corregirlo tuvimos que ajustar la máquina de estados en lugar de parchear las etiquetas sobre la marcha. Eso cambió cómo tratamos el estado de la interfaz en el resto de la app: transiciones explícitas, menos estados deducidos y una sincronización más sólida entre las comprobaciones asíncronas y el estado visible.

  • Síntoma: texto de estado del actualizador desfasado tras comprobaciones correctas sin actualizaciones.
  • Causa: transiciones de estado incompletas en las devoluciones de llamada asíncronas de actualización.
  • Resultado: ahora son transiciones de estado explícitas las que determinan cómo se muestra el estado.

Notas sobre rendimiento

La métrica que importa: el tiempo desde el activador hasta el emoji insertado. Por eso nos quedamos con Swift + AppKit nativos en lugar de una pila basada en un motor de navegador.

Medido en un Mac15,11 (Apple M3 Max), macOS 26.2 compilación 25C56, con la v1.3.1 del ZIP publicado. El tiempo de inicio que aparece a continuación corresponde al arranque desde open -n hasta que aparece el proceso de la app.

Primer inicio de la sesión

217.68 ms (una sola ejecución, arranque hasta que el proceso es visible).

Reinicio en caliente

Mediana de 110.02 ms en 7 reinicios.

Memoria en reposo

110.4 MB RSS según ps; en la misma ejecución, Monitor de Actividad mostró 99.4 MB de memoria real y 29.6 MB de memoria privada.

Tamaño del paquete

ZIP de 4.49 MB, paquete de la app de 12.96 MB en disco.

Las métricas de memoria se muestran tal cual porque usan modelos de cómputo distintos. La mayor parte del RSS es memoria compartida del framework AppKit; la memoria privada se mantiene por debajo de 30 MB en nuestras pruebas.

Swift + AppKit vs. Electron para utilidades de macOS

En utilidades siempre activas, el comportamiento en ejecución importa más que la portabilidad de la interfaz. Elegimos Swift + AppKit nativos por estas razones prácticas:

  • Un archivo de distribución pequeño y un arranque directo sin tener que calentar un entorno de ejecución de JavaScript.
  • Integración directa de accesibilidad e inserción de texto con API nativas de macOS.
  • Ningún árbol de procesos de un motor de navegador integrado para una utilidad de teclado ligera.

Para ver los tiempos de arranque medidos de la herramienta integrada, Raycast y Emoji Picker, consulta la página de comparación.

Compromisos de diseño

Por qué la barra de menús

Las herramientas de la barra de menús se mantienen activas sin esfuerzo y se invocan rápido. Para este producto encajaba con la realidad: se usa una y otra vez en chats, tickets, mensajes de commit y documentación.

Por qué una interfaz deliberadamente mínima

Eliminamos casi todos los elementos decorativos que ralentizaban la elección. Categorías claras, una navegación con teclado evidente y una interfaz mínima funcionaron mejor que un tratamiento visual más elaborado en nuestro uso diario.

Dónde sigue ganando el selector integrado

Si insertas emojis de vez en cuando, el selector de macOS ya es suficiente y no requiere ninguna configuración. Nuestra app es para quienes lo hacen todo el día y sufren una y otra vez el costo de la interrupción.

Por qué lo local ante todo

Lo local ante todo era innegociable. Sin cuenta obligatoria, sin depender de la nube y sin enviar lo que escribes a servicios externos.

Lo que nos sorprendió

  • Los pequeños errores de estado pueden dañar más la confianza que los errores visuales evidentes.
  • Los usuarios avanzados notan enseguida las activaciones indebidas.
  • Nadie pidió más funciones hasta que la activación dejó de dispararse por error.

La lección principal: las herramientas de teclado se juzgan por su constancia, no por su novedad. Si la app se comporta siempre igual, se gana un sitio fijo en tu forma de trabajar.

Limitaciones conocidas

  • El permiso de Accesibilidad es necesario para supervisar el activador global e insertar en otras apps.
  • La app no inspecciona los metadatos del campo activo, ni siquiera si es un campo seguro. Las apps en las que no quieras supervisar el activador pueden añadirse a la lista de exclusión.
  • Algunos controles de texto personalizados interpretan de otra forma los eventos sintéticos de retroceso o de teclado Unicode, lo que puede hacer la inserción menos fiable.
  • La detección del activador se ha probado sobre todo con distribuciones de teclado latinas.

Soporte

Haz una pregunta, informa de un problema o pide una función en la página de soporte de Emoji Picker. No necesitas cuenta.

Prueba Emoji Picker

¿Has encontrado un problema? Infórmanos indicando la versión de la app, la versión de macOS y los pasos para reproducirlo.