技術解説
macOS用のネイティブな絵文字ピッカーをSwiftで作る
Electronなし、無駄なし
これはEmoji Picker for macOSの開発記録です。チャット中、標準のピッカーが私たち自身の執筆の流れを何度も中断させていたことから、このアプリを作りました。内蔵の機能ではマウスに持ち替える必要があり、使うのに時間がかかります。目指したのはシンプルなことです。入力して、選んで、そのまま進む。
この技術解説の内容
ワークフローの本当の問題
macOSには最初から絵文字ピッカーが付いています。たまに使うだけなら、それで十分です。でも大量のテキストを扱うワークフローでは、それが作業の足かせになっていました。パネルを開き、手をマウスに移し、選んで、パネルを閉じ、元の作業に戻る。これを1日に何十回も繰り返すと、中断による負担は無視できなくなります。
初期の社内テストで、誤った起動がいかに煩わしいかがわかりました。そこで、起動が退屈なほど予測どおりに感じられるまでルールを厳しくしました。;を入力し、今のアプリのままキーボードで選び、そのまま書き続ける。
- サポートやチケット対応では、多数の短いメッセージを振り分けながら、すばやく挿入する必要があります。
- コードレビューのコメントやコミットメッセージでは、たいてい入れたいものが決まっているので、カテゴリから探すよりもクエリを入力するほうが速くなります。
- 1日に40回以上もパネルを開いたり閉じたりしていると、入力のリズムはすぐに崩れてしまいます。
アーキテクチャの決定
グローバルホットキーの処理
入力は、Core Graphicsのイベントタップと、ガード付きのステートマシンで処理しています。容量を制限したメモリ内バッファに、最前面のアプリで直近に入力された印字可能な文字を保持し、設定されたトリガーを認識できるようにしています。このバッファは、アプリの切り替え、ショートカット、印字できない入力、キャンセルの際にリセットされます。設定可能なポップアップの遅延により、クエリの入力中もUIが落ち着いた状態に保たれます。
NSPanelかNSPopoverかの判断
最初はNSPopoverを使っていましたが、NSPanelに切り替えました。NSPopoverは、SlackやChromeでアプリをすばやく切り替えると、フォーカスを失いやすかったのです。NSPanelなら、ライフサイクルを明示的に制御でき、アプリの境界を越えてもキーボード入力の送り先が予測どおりになりました。
アクセシビリティの許可と挿入の方法
アクセシビリティの許可によって、Emoji Pickerはこれらのグローバルイベントを監視し、アクティブなアプリにキーボードイベントを送り返せるようになります。クリップボードを使った挿入は採用しませんでした。クリップボードの内容を書き換えるのは予想外の挙動で、信頼しにくいからです。アプリはAXUIElementを通じてテキストフィールドの中身を調べることはしません。セッションの開始時に最前面にあるはずのアプリを記録し、挿入の前に同じアプリがまだ最前面にあることを確認します。
文字数を数えたテキスト置換
インラインセッションでは、対象アプリに届いたトリガー文字とクエリ文字の数を数えます。項目を選択すると、Emoji Pickerはその数だけBackspaceキーのイベントを送り、続けて選んだUnicodeテキストを合成キーボードイベントとして送信します。クリップボードを書き換えることは一切ありません。それでも、カスタムコントロールによっては合成キーボードイベントを異なる形で解釈する場合があるため、対象アプリの確認とキャンセル時の挙動が重要になります。
コンテキスト検出のルール
起動を予測どおりに保つために、私たちが使っている実際的なルールは次のとおりです:
- Emoji Picker自身のウインドウと、ユーザの除外リストにあるアプリは無視します。
- 直近の入力と各アクティブセッションを最前面のアプリに結び付け、アプリを切り替えるとセッションをキャンセルします。
- 設定されたトリガーを、直近の印字可能な入力の末尾(範囲は制限付き)と照合します。
- インラインクエリでは英字、数字、アンダースコア、プラス、ハイフンを受け付け、それ以外の入力があればキャンセルします。
- UIを表示する前に、ユーザが設定した開始シーケンスのブロックリスト、クエリの最小文字数、ポップアップの遅延を適用します。
- 明示的に呼び出したいユーザのために、直接開くトリガーのカスタマイズ(例:;;や//)に対応します。
簡略化した状態ロジック(読みやすさのため一部省略):
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)
}
より良い状態モデルを生んだバグ
v1.3の変更履歴に記載したある問題から、アップデータのステータスモデルの盲点が明らかになりました。アップデートがないという結果の後もChecking...が表示されたままになったり、Availableが不明のままになったりすることがあったのです。小さなバグでしたが、信頼への影響は大きなものでした。
修正にあたっては、ラベルをその場しのぎで直すのではなく、ステートマシンを厳密にする必要がありました。これをきっかけに、アプリ全体でのUIステータスの扱い方が変わりました。明示的な状態遷移、推測に頼る状態の削減、そして非同期チェックと表示されるステータスとのより確実な同期です。
- 症状:アップデートなしの確認が成功した後も、アップデータのステータステキストが古いまま残る。
- 根本原因:非同期のアップデートコールバックでの不完全な状態遷移。
- 結果:現在は明示的な状態遷移に基づいてステータスを表示しています。
パフォーマンスについて
重要な指標は、トリガーから絵文字が挿入されるまでの時間です。だからこそ、ブラウザエンジンを使う構成ではなく、ネイティブのSwift + AppKitのランタイムを選び続けました。
Mac15,11(Apple M3 Max)、macOS 26.2(ビルド25C56)で、配布用ZIPのv1.3.1を使って計測しました。以下の起動時間は、open -nからアプリのプロセスが現れるまでの、プロセスが見えるまでの起動時間を指します。
セッション中の初回起動
217.68 ms(1回の計測、プロセスが見えるまでの起動時間)。
ウォーム再起動
再起動7回の中央値は110.02 ms。
アイドル時のメモリ
psで110.4 MB RSS。同じ実行時のアクティビティモニタでは、実メモリ99.4 MB、専用メモリ29.6 MBでした。
パッケージサイズ
ZIPは4.49 MB、ディスク上のアプリバンドルは12.96 MB。
メモリの指標は算出方法がそれぞれ異なるため、そのまま掲載しています。ここでのRSSの大部分はAppKitフレームワークの共有メモリで、私たちのテストでは専用メモリは30 MB未満に収まっています。
macOSユーティリティにおけるSwift + AppKit vs Electron
常に動作しているユーティリティツールでは、UIの移植性よりもランタイムの性質のほうが重要です。次のような実際的な理由から、ネイティブのSwift + AppKitを選びました:
- 配布物のサイズが小さく、JavaScriptランタイムのウォームアップなしで直接起動します。
- macOSネイティブのAPIを使った、アクセシビリティとテキスト挿入の直接的な統合。
- 軽量なキーボードユーティリティに、ブラウザエンジンを組み込んだプロセスツリーは不要です。
内蔵ツール、Raycast、Emoji Pickerの起動時間の計測結果については、比較ページをご覧ください。
設計上のトレードオフ
メニューバーにした理由
メニューバーツールは常駐させやすく、すばやく呼び出せます。この製品では、それが実際の使われ方に合っていました。チャット、チケット、コミットメッセージ、ドキュメントの作成中に、何度も呼び出されるからです。
あえて最小限のUIにした理由
選択の妨げになる装飾的な要素は、ほぼすべて取り除きました。私たち自身の日々の使用では、凝った見た目よりも、わかりやすいカテゴリ、明快なキーボード操作、最小限のクロームのほうがうまく機能しました。
標準のピッカーがまだ優れている点
絵文字をたまにしか入力しないなら、macOS標準のピッカーで十分ですし、設定も一切いりません。このアプリは、一日中絵文字を入力し、そのたびに作業が中断されることを負担に感じている人のためのものです。
ローカルファーストにした理由
ローカルファーストは譲れない条件でした。アカウントは不要、クラウドにも依存せず、入力の挙動を外部サービスに経由させることもありません。
意外だったこと
- ステータスの小さなバグは、目に見える表示の不具合以上に信頼を損なうことがあります。
- 誤った起動は、パワーユーザにすぐ気づかれます。
- 起動の誤作動がなくなるまで、新しい機能を求める声はひとつもありませんでした。
一番の教訓は、キーボードツールは目新しさではなく一貫性で評価されるということです。毎回同じように動くアプリこそが、ワークフローの中に定位置を得られます。
既知の制約
- グローバルなトリガーの監視とアプリをまたいだ挿入には、アクセシビリティの許可が必要です。
- アプリは、フォーカスのあるフィールドがセキュアかどうかを含め、そのメタデータを調べません。トリガーの監視を望まないアプリは、除外リストに追加できます。
- カスタムのテキストコントロールの中には、合成されたBackspaceやUnicodeのキーボードイベントを異なる形で解釈するものがあり、挿入の信頼性が下がる場合があります。
- トリガー検出の処理は、主にラテン文字のキーボードレイアウトで重点的にテストしています。
サポート
質問や問題の報告、機能のリクエストは、Emoji Pickerサポートページからどうぞ。アカウントは不要です。
Emoji Pickerを試す
問題が見つかりましたか?アプリのバージョン、macOSのバージョン、再現手順を添えてご報告ください。