Технический разбор

Как мы создали нативный эмодзи-пикер для macOS на Swift

Без Electron и без лишнего веса

Это дневник разработки Emoji Picker for macOS. Мы создали его, потому что стандартное средство постоянно сбивало нас при переписке. Встроенный вариант требовал переключаться на мышь и работал медленно. Цель была простой: набрать, выбрать и продолжить.

Опубликовано 2026-02-16 · inndevs GmbH

В этом разборе

Настоящая проблема в работе

В macOS уже есть средство выбора эмодзи. Для редкого использования его хватает. Но при большом объёме текста оно нас тормозило. Открыть панель, перенести руку на мышь, выбрать, закрыть панель, вспомнить, на чём остановился. Повторите это десятки раз за день — и цена отвлечений становится очевидной.

Первые внутренние тесты показали, насколько раздражают ложные срабатывания. Мы ужесточали правила, пока срабатывание не стало скучным и предсказуемым: введите ;, оставайтесь в текущем приложении, выберите с клавиатуры, продолжайте писать.

  • В поддержке и работе с тикетами нужна быстрая вставка при разборе множества коротких сообщений.
  • В комментариях к код-ревью и сообщениях коммитов мы обычно уже знаем, что ищем, поэтому листать категории медленнее, чем набрать запрос.
  • Если открывать и закрывать панель 40+ раз в день, ритм набора быстро сбивается.

Архитектурные решения

Обработка глобальных сочетаний клавиш

Ввод обрабатывается через Core Graphics event tap и защищённый конечный автомат. Ограниченный буфер в памяти хранит последние печатаемые символы для активного приложения, чтобы распознать заданный триггер. Он сбрасывается при смене приложения, сочетаниях клавиш, непечатаемом вводе и отмене. Настраиваемая задержка всплывающего окна не даёт интерфейсу мельтешить, пока запрос ещё набирается.

Выбор между NSPanel и NSPopover

Мы начали с NSPopover и перешли на NSPanel. NSPopover слишком легко терял фокус в Slack и Chrome при быстром переключении приложений. NSPanel дал явный контроль над жизненным циклом и предсказуемую маршрутизацию клавиатуры между приложениями.

Разрешение на универсальный доступ и способ вставки

Разрешение на универсальный доступ позволяет Emoji Picker отслеживать эти глобальные события и отправлять события клавиатуры обратно в активное приложение. Мы отказались от вставки через буфер обмена: перезапись его содержимого неожиданна для пользователя и подрывает доверие. Приложение не анализирует текстовое поле через AXUIElement: в начале сеанса оно запоминает активное приложение и перед вставкой проверяет, что на переднем плане всё ещё оно.

Замена подсчитанного текста

Встроенный сеанс подсчитывает символы триггера и запроса, попавшие в целевое приложение. При выборе Emoji Picker отправляет столько же нажатий Backspace, а затем — выбранный текст Unicode в виде синтетического события клавиатуры. Буфер обмена никогда не изменяется. Нестандартные элементы управления могут по-своему интерпретировать синтетические события клавиатуры, поэтому так важны проверки целевого приложения и поведение при отмене.

Правила определения контекста

Вот практические правила, которые делают срабатывание предсказуемым:

  • Игнорировать собственные окна Emoji Picker и приложения из списка исключений пользователя.
  • Привязывать недавний ввод и каждый активный сеанс к активному приложению; переключение приложения отменяет сеанс.
  • Сопоставлять заданный триггер с ограниченным окончанием недавнего печатаемого ввода.
  • Во встроенном запросе допускаются буквы, цифры, подчёркивание, плюс и дефис; любой другой ввод отменяет запрос.
  • Перед показом интерфейса применять пользовательский список запрещённых начальных последовательностей, минимальную длину запроса и задержку всплывающего окна.
  • Поддерживать настройку триггера прямого открытия (например, ;; или //) для тех, кто предпочитает явный вызов.

Упрощённая логика состояний (сокращено для удобства чтения):

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 триггер запрос с задержкой подтверждение, потеря фокуса или отмена
Общая схема состояний: idle -> tracking -> open -> idle.

Ошибка, которая заставила нас улучшить модель состояний

Одна проблема из журнала изменений v1.3 выявила слепое пятно в модели статусов обновления: Checking... мог оставаться на экране после того, как обновлений не нашлось, а Available — оставаться неизвестным. Ошибка была мелкой, но удар по доверию — серьёзным.

Чтобы исправить её, пришлось ужесточить конечный автомат, а не латать надписи на месте. Это изменило подход к статусам интерфейса во всём приложении: явные переходы, меньше выводимых состояний и более надёжная синхронизация асинхронных проверок с видимым статусом.

  • Симптом: устаревший текст статуса обновления после успешных проверок, не нашедших обновлений.
  • Первопричина: неполные переходы состояний при асинхронных обратных вызовах обновления.
  • Итог: теперь отображением статуса управляют явные переходы состояний.

Заметки о производительности

Метрика, которая действительно важна: время от триггера до вставленного эмодзи. Поэтому мы остались на нативной среде Swift + AppKit, а не на стеке с браузерным движком.

Измерено на Mac15,11 (Apple M3 Max), macOS 26.2, сборка 25C56, с использованием v1.3.1 из опубликованного ZIP. Время запуска ниже — это время от open -n до появления процесса приложения.

Первый запуск в сеансе

217.68 ms (один замер, время до появления процесса).

Тёплый перезапуск

Медиана 110.02 ms по 7 повторным запускам.

Память в простое

110.4 MB RSS по данным ps; Мониторинг системы в том же замере показал 99.4 MB реальной и 29.6 MB частной памяти.

Размер пакета

ZIP — 4.49 MB, пакет приложения на диске — 12.96 MB.

Показатели памяти приведены как есть, поскольку они считаются по разным моделям. Бо́льшая часть RSS здесь — общая память фреймворка AppKit; частная память в наших тестах не превышает 30 MB.

Swift + AppKit против Electron для утилит macOS

Для утилит, которые работают постоянно, поведение во время выполнения важнее переносимости интерфейса. Мы выбрали нативные Swift + AppKit по практическим причинам:

  • Небольшой дистрибутив и прямой запуск без прогрева среды выполнения JavaScript.
  • Прямая интеграция универсального доступа и вставки текста через нативные API macOS.
  • Никакого дерева процессов браузерного движка для лёгкой клавиатурной утилиты.

Замеры времени запуска встроенного средства, Raycast и Emoji Picker — на странице сравнения.

Компромиссы в дизайне

Почему строка меню

Инструменты в строке меню легко держать запущенными и быстро вызывать. Для этого продукта это совпало с реальностью: его вызывают снова и снова в чатах, тикетах, сообщениях коммитов и документации.

Почему интерфейс намеренно минималистичен

Мы убрали почти все декоративные элементы, замедлявшие выбор. В нашей собственной ежедневной работе понятные категории, очевидная навигация с клавиатуры и минимум оформления оказались лучше более богатых визуальных решений.

В чём встроенное средство всё ещё выигрывает

Если вы вставляете эмодзи редко, встроенного в macOS средства вполне достаточно, и его не нужно настраивать. Наше приложение — для тех, кто делает это весь день и постоянно ощущает цену отвлечений.

Почему локальный подход

Локальный подход был обязательным условием. Без учётной записи, без зависимости от облака и без передачи ввода через внешние сервисы.

Что нас удивило

  • Мелкие ошибки статуса могут подорвать доверие сильнее, чем заметные визуальные ошибки.
  • Опытные пользователи сразу замечают ложные срабатывания.
  • Никто не просил новых функций, пока не перестали случаться ложные срабатывания.

Главный урок: клавиатурные инструменты оценивают по стабильности, а не по новизне. Если приложение каждый раз ведёт себя одинаково, оно занимает постоянное место в работе.

Известные ограничения

  • Для отслеживания глобального триггера и вставки в другие приложения требуется разрешение на универсальный доступ.
  • Приложение не анализирует метаданные активного поля, в том числе не проверяет, является ли оно защищённым. Приложения, в которых отслеживание триггера не нужно, можно добавить в список исключений.
  • Некоторые нестандартные текстовые элементы управления по-своему интерпретируют синтетические события Backspace или Unicode, что может снижать надёжность вставки.
  • Распознавание триггера больше всего тестировалось на латинских раскладках клавиатуры.

Поддержка

Задайте вопрос, сообщите о проблеме или предложите функцию на странице поддержки Emoji Picker. Учётная запись не нужна.

Попробовать Emoji Picker

Нашли проблему? Сообщите о ней, указав версию приложения, версию macOS и шаги для воспроизведения.