技術深入解析
用 Swift 打造原生 macOS 表情符號選擇器
不用 Electron,拒絕臃腫
這是 Emoji Picker for macOS 背後的開發紀錄。我們做這款 App,是因為聊天時預設的選擇器總是打斷我們的寫作節奏。系統內建的方式需要切換到滑鼠,用起來很慢。目標很簡單:輸入、選擇,然後繼續。
本文內容
真正的工作流程問題
macOS 本身就內建表情符號選擇器。偶爾用一下沒問題,但在大量輸入文字的工作中,它拖慢了我們的速度:打開面板,把手移到滑鼠上,選擇,關閉面板,再找回思緒。一天重複幾十次,被打斷的代價就顯而易見了。
早期內部測試暴露出誤觸發有多惱人。我們不斷收緊規則,直到觸發變得平淡且可預測:輸入 ;,留在目前的 App,用鍵盤選擇,繼續書寫。
- 在客服與工單處理流程中,分類大量短訊息時需要快速插入。
- 在撰寫程式碼審查意見與提交訊息時,我們通常早已知道想要什麼,因此依類別瀏覽比直接輸入查詢更慢。
- 每天切換面板狀態 40 次以上,很快就會打亂輸入節奏。
架構決策
全域快速鍵處理
輸入由 Core Graphics 事件監聽(event tap)和一個具防護機制的狀態機驅動。一個有大小上限的記憶體緩衝區會為最前方的 App 保留最近輸入的可列印字元,以便辨識所設定的觸發符號。切換 App、使用快速鍵、輸入不可列印字元或取消時,緩衝區都會重設。可調整的彈出延遲讓介面在你還在輸入查詢時保持安靜。
NSPanel 與 NSPopover 的取捨
我們最初使用 NSPopover,後來改用 NSPanel。在 Slack 和 Chrome 中快速切換 App 時,NSPopover 太容易失去焦點。NSPanel 讓我們能明確控制生命週期,並在不同 App 之間實現可預測的鍵盤事件路由。
輔助使用權限與插入策略
輔助使用權限讓 Emoji Picker 能夠監聽這些全域事件,並將鍵盤事件傳回目前的 App。我們捨棄了以剪貼簿為基礎的插入方式,因為覆寫剪貼簿內容會讓人意外,也難以令人信任。App 不會透過 AXUIElement 檢查文字欄位;它會在工作階段開始時記錄預期的最前方 App,並在插入前確認該 App 仍在最前方。
依計數取代文字
行內工作階段會計算已傳到目標 App 的觸發字元與查詢字元數。選取後,Emoji Picker 會送出相同數量的 Backspace 按鍵事件,再將所選的 Unicode 文字作為合成鍵盤事件送出。它從不更動剪貼簿。自訂控制項仍可能以不同方式解讀合成鍵盤事件,因此目標 App 檢查與取消行為非常重要。
情境偵測規則
以下是我們用來確保觸發行為可預測的實用規則:
- 忽略 Emoji Picker 本身的視窗,以及使用者排除清單中的 App。
- 將最近的輸入與每個作用中的工作階段綁定到最前方的 App;切換 App 會取消目前的工作階段。
- 將所設定的觸發符號與最近可列印輸入的有限長度後綴進行比對。
- 行內查詢接受字母、數字、底線、加號與連字號;其他輸入會取消查詢。
- 在顯示介面之前,先套用使用者設定的起始序列封鎖清單、最短查詢長度與彈出延遲。
- 為偏好明確叫出方式的使用者提供可自訂的直接開啟觸發符號(例如 ;; 或 //)。
簡化後的狀態邏輯(為便於閱讀有所刪減):
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)
}
一個迫使我們改進狀態模型的 Bug
v1.3 更新紀錄中記載的一個問題暴露了我們更新狀態模型中的盲點:在檢查結果為沒有更新後,Checking... 仍可能顯示在介面上,而 Available 可能一直處於未知狀態。Bug 雖小,對信任的影響卻很大。
修正這個問題迫使我們收緊狀態機,而不是就地修補標籤。這改變了我們在整個 App 中處理介面狀態的方式:明確的狀態轉換、更少的推斷狀態,以及非同步檢查與可見狀態之間更緊密的同步。
- 症狀:在成功檢查到沒有更新後,更新狀態文字沒有重新整理。
- 根本原因:非同步更新回呼下的狀態轉換不完整。
- 結果:現在由明確的狀態轉換來驅動狀態顯示。
效能說明
真正重要的指標:從觸發到表情符號插入完成的時間。這正是我們堅持使用原生 Swift + AppKit 執行環境、而非瀏覽器引擎技術堆疊的原因。
測試裝置為 Mac15,11(Apple M3 Max),macOS 26.2(建置版本 25C56),使用正式發布 ZIP 中的 v1.3.1。下文的啟動時間指程序可見啟動:從 open -n 開始,到 App 程序出現為止。
本次工作階段中的首次啟動
217.68 ms(單次執行,程序可見啟動)。
熱重新啟動
7 次重新啟動的中位數為 110.02 ms。
閒置記憶體
ps 測得 110.4 MB RSS;同一次執行中,「活動監視器」顯示實際記憶體 99.4 MB,專用記憶體 29.6 MB。
安裝包大小
ZIP 檔 4.49 MB,磁碟上的 App 套件 12.96 MB。
由於各項記憶體指標的計算方式不同,這裡按原樣列出。此處的 RSS 大多是共享的 AppKit 框架記憶體;在我們的測試中,專用記憶體始終低於 30 MB。
macOS 工具程式:Swift + AppKit 與 Electron 比較
對於常駐執行的工具程式來說,執行時特性比介面的跨平台能力更重要。我們選擇原生 Swift + AppKit,主要出於以下實際考量:
- 發行檔體積小,啟動路徑直接,不需要預熱 JavaScript 執行環境。
- 透過 macOS 原生 API 直接整合輔助使用與文字插入。
- 輕量級鍵盤工具,不需要內嵌瀏覽器引擎程序樹。
關於系統內建工具、Raycast 與 Emoji Picker 的啟動時間實測,請參閱比較頁面。
設計取捨
為什麼放在選單列
選單列工具很容易保持常駐,也能快速叫出。對這款產品來說,這正符合實際情況:使用者在聊天、處理工單、撰寫提交訊息與文件時會一再叫出它。
為什麼刻意保持極簡介面
我們幾乎移除了所有拖慢選擇的裝飾元素。在我們自己的日常使用中,清楚的分類、直覺的鍵盤導覽與極簡的介面框架,比更豐富的視覺效果更好用。
系統內建選擇器仍佔優勢的地方
如果你很少插入表情符號,macOS 內建的選擇器已經夠用,而且不需要任何設定。我們的 App 是為整天都在插入表情、一再被打斷的使用者而設計。
為什麼堅持本機優先
本機優先是不容妥協的底線:不需要帳號,不依賴雲端,也不會把輸入行為傳送給外部服務。
意料之外的發現
- 細小的狀態 Bug 比明顯的視覺 Bug 更傷害信任。
- 進階使用者會立刻注意到誤觸發。
- 在觸發不再誤判之前,沒有人要求更多功能。
最主要的心得:鍵盤工具靠的是一致性,而不是新奇。如果 App 每次的表現都一樣,它就能在工作流程中占有一席之地。
已知限制
- 全域觸發監聽與跨 App 插入需要輔助使用權限。
- App 不會讀取目前焦點欄位的後設資料,包括該欄位是否為安全輸入欄位。不希望被監聽觸發符號的 App 可以加入排除清單。
- 部分自訂文字控制項對合成的 Backspace 或 Unicode 鍵盤事件有不同的解讀,可能降低插入的可靠性。
- 觸發符號偵測流程主要在拉丁字母鍵盤配置上進行了充分測試。
支援
在 Emoji Picker 支援頁面提問、回報問題或提出功能建議,不需要註冊帳號。
試用 Emoji Picker
發現問題了嗎?回報時請附上 App 版本、macOS 版本與重現步驟。