技術深入解析

用 Swift 打造原生 macOS 表情符號選擇器

不用 Electron,拒絕臃腫

這是 Emoji Picker for macOS 背後的開發紀錄。我們做這款 App,是因為聊天時預設的選擇器總是打斷我們的寫作節奏。系統內建的方式需要切換到滑鼠,用起來很慢。目標很簡單:輸入、選擇,然後繼續。

發布於 2026-02-16 · inndevs GmbH

本文內容

真正的工作流程問題

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)
}
idle tracking open 觸發 防抖動查詢 確認、失焦或取消
狀態流程概覽:idle -> tracking -> open -> idle。

一個迫使我們改進狀態模型的 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 版本與重現步驟。