Технічний огляд

Створення нативного Emoji Picker для macOS на Swift

Без Electron і зайвої ваги

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

Опубліковано 16.02.2026 · inndevs GmbH

У цьому огляді

Справжня проблема в роботі

macOS уже має вбудований засіб вибору емодзі. Для епізодичного використання його досить. Але коли тексту багато, він нас сповільнював. Відкрити панель, перенести руку на мишу, вибрати, закрити панель, повернутися до думки. Повторіть це десятки разів за день — і ціна перерв стає очевидною.

Ранні внутрішні тести показали, наскільки дратують хибні спрацьовування. Ми посилювали правила, доки активація не стала нудною й передбачуваною: введіть ;, залишайтеся в поточній програмі, виберіть із клавіатури й пишіть далі.

  • Підтримці й роботі з тікетами потрібне швидке вставлення, коли розбираєш багато коротких повідомлень.
  • У коментарях під час код-рев’ю та в повідомленнях комітів ми зазвичай уже знаємо, що хочемо, тож перегляд категорій повільніший, ніж введення запиту.
  • Перемикання стану панелі понад 40 разів на день швидко збиває ритм набору.

Архітектурні рішення

Обробка глобальних гарячих клавіш

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

Вибір між 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 тригер запит із затримкою (debounce) вставлення, втрата фокуса або скасування
Огляд переходів між станами: 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 приватної пам’яті.

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

4.49 MB ZIP, 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 і кроки для відтворення.