常見問題解答

問題回報後的處理

我提的問題或需求或者 PR，怎麼一直都沒有人處理？

1. 不是所有的問題或需求都活該得到積極響應。與上游不同，敝專案會在某些問題/需求因自身特性而無法響應之的情況下做出對應的說明、以節約雙方的時間與感情。

2. 雖然威注音專案的研發時間投入比上游高出幾個數量級，但也只是偶然。請勿將這種日常視為理所當然，誰都會有因為私事而突然變忙的時候。

3. 有時，自己的痛苦，就是源於自己的無能。自己覺得對方不去做的話，「自己學、自己做」可能還真的就是最快的方式，因為反正對方可能到死都不會去做、就是要跟你鬧情緒。「軟體與程式碼是開源的，但專案是私人的」。早一點做出最壞的預期的話，就早一點意識到：自己的情緒管理控制權應該在自己的手中、且管理的方法就是讓自己變得比對方更強。你不需要獲得對方的承認，因為你的勝利在於你比對方創造了更多被公認的有利於社會的價值。

使用相關

1. 輸入法選單內的輸入法是灰色的，無法選中。

1. macOS 系統終端機內的「加密的鍵盤輸入」選項被啟用了。請點選「終端機」選單，關閉「加密的鍵盤輸入」選項，威注音就會正常出現在輸入法選單上。英文語系的使用者可以從「Terminal -> Secure Keyboard Entry」選單關閉該選項。包括 iTerms 在內的某些副廠終端機模擬軟體也會有類似的功能，請自行排查。

2. 你可能需要重新登入，特別是你在對威注音輸入法進行升級或者降級安裝的情況下。

2. 輸入法選單內出現多個相同的威注音輸入法副本。

請立刻重新登入。如果問題仍舊持續存在的話，請用終端機執行：

sudo "/Library/Input Methods/vChewing.app/Contents/MacOS/vChewing" uninstall

這道命令可以將任何安裝到錯誤位置的威注音輸入法移除掉。在這道命令之後，請再次執行最新的威注音的安裝程式。

威注音輸入法僅該被安裝到使用者目錄內的「~/Library/Input Methods/」目錄下，這也有助於將威注音輸入法安裝到受公司資安策略管控的電腦上。

3. 怎樣用非常規手段安裝部署威注音？

本次以 pkg 的形式發行安裝程式，方便資安管理業者們藉由終端機進行部署。

終端部署可以用這道指令：

installer -pkg ~/Downloads/vChewing-macOS-?.?.?-unsigned.pkg -target CurrentUserHomeDirectory

由於只會安裝至使用者目錄內，所以同一台電腦不同使用者需要分別安裝一遍。

下述終端命令亦可使下載來的程式從 macOS 門衛檢查隔離區內取出來：

xattr -dr com.apple.quarantine ~/Downloads/vChewing-macOS-?.?.?-unsigned.pkg
xattr -dr com.apple.quarantine ~/Downloads/vChewingInstaller.app

另請注意 macOS 10 & 11 的所有系統版本均有一處行為故障：pkg 安裝包指定僅裝在使用者目錄下的話，在 macOS 10 & 11 內執行時，仍舊會往總根目錄下安裝，除非您手動點「更改安裝位置」再將那唯一的「安裝只供我使用」再點一遍才可以。

4. 有打算支援 Homebrew 等安裝途徑嗎？

這樣會增大維護成本，所以不會再考慮。

5. 選字窗位置不對欸。

這往往是您在敲字時使用的應用程式，並沒有正確地將正確的游標位置告知 IMK、導致輸入法無法得知相關的資訊使然。您在某個應用程式中敲字，輸入游標的位置到底在哪裡，一開始只有那個應用程式知道，然後，那個應用程式必須把正確的位置告知輸入法，輸入法才知道應該在什麼位置，顯示像是選字窗這樣的使用者介面元件。某些應用完全沒有認真處理與 macOS 的 IMK 框架有關的內容，所以就通知了輸入法一個奇怪的位置資訊，有時候座標根本就在螢幕大小之外。威注音對此的判斷邏輯與上游相同：如果某個應用程式將奇怪的位置（不在任何一個螢幕的範圍內）告知給 IMK，那麼輸入法就會想辦法把選字窗擺在螢幕範圍內最接近的位置。比方說：如果是 y 軸超過了螢幕尺寸，就會改在螢幕的最上方顯示。

6. 自訂使用者語彙資料該怎麼管理？

輸入法選單內有相關的選項、允許您開啟使用者語彙資料目錄來自行備份。您也可以藉由輸入法偏好設定來修改這個目錄的位置。修改該目錄的位置的行為並不會自動遷移這些資料。

出於研發負擔與使用者體驗管理方面的疑慮，威注音輸入法不打算內建基於 git 的使用者語彙資料版本管理備份功能。如果您有相關的產品需求的話，完全可以自己寫 bash 腳本搭配系統內建的 cron 功能來使用。

技術相關：

威注音會使用多少系統資源？

此部分以威注音 v2.7.0 版來說明。

在 2018 Intel Mac Mini 以及 2020 年的末代 Intel MacBook Pro 13-inch 機種內使用 Xcode 對威注音做側寫的過程中，我們得到的測試結果是：

1. 如果僅使用簡體中文或繁體中文單個模式的原廠詞庫、且啟用「按需載入簡繁體模式的原廠辭典資料」的話，記憶體開銷大約在 70-80MB 起步。
2. 如果簡體中文與繁體中文模式的原廠詞庫都載入的話，大約會佔用 110-120 MB 左右的記憶體。
3. 值得注意的是，如果使用者語彙內容體積有所增長的話，對應的記憶體開銷也會有相應的上漲。

為什麼會比上游多出幾乎接近 10 倍呢？因為 Swift 對 string 資料的處理就是這樣不經濟。這還是在經過優化處理之後的結果。（威注音在 1.5.4 版內部測試的時候，語言模組體系剛剛 Swift 化，記憶體開銷是 700MB。）我們能得出的對 Swift 而言的最佳處理方案就是使用 plist 格式的原廠語彙資料，這樣能夠兼顧十年前的舊機種的 CPU 算力。假如只照顧最近三年以來的機種的話，還可以換用另一種算法、來將記憶體開銷縮減至 80MB 以內。

得益於威注音的純 Swift 化，平常處理每個按鍵事件都可以在毫秒級別的時間完成。

我想修改威注音，新增一些偏好設定。請問需要注意哪些問題？

在 PrefUI (macOS 10.15 開始的 SwiftUI 偏好設定介面) 與 PrefWindow (針對 macOS 10.14 為止的舊版偏好設定介面) 當中新增對應的介面內容之前，你需要做這些：

1. 在「vChewing_Shared」封包當中的 Shared.swift 檔案內的 UserDef 這個 Enum 當中添入新的記錄，用以規定該資料值在 UserDefaults plist 當中的名稱。
2. 在「vChewing_Shared」封包當中的 PrefMgrProtocol 當中添入對應的新資料值的規範。
3. 在 PrefMgr.swfit 當中依照 PrefMgrProtocol 的變動來添入對應的新資料值。
4. 與小麥注音不同的是，威注音給 Bool 類型引入了 toggled() 特性，會先 toggle() 再回傳操作後的資料值結果。如果您需要讓參數在行將變化、或者變化之後自動做些什麼的話，請擴充該參數的 willSet 或 didSet 特性、而不需要再另外設定函式（除非需要再傳入特定的參數）。

威注音 2.7.0 版好像改很兇，但又幾乎沒有新功能。究竟改了哪些內容？

威注音 2.7.0 是威注音的 Dezonblization 行動的一部分，旨在讓在此之後的研發流程更能順利進行。藉由將整個專案大卸八塊、拆成各個以 Swift Package 為單位的各種組件，以及對大中心派發技術（Grand Central Dispatch）的合理運用，威注音得以做到更快的專案建置速度、更快的辭典載入速度、更清晰且更易於維護的專案結構框架。至於放棄 macOS 10.11-10.12 的支援，則是因為 NSGridView 以及 Xcode 14 的雙雙限制使然。藉由這些改動，威注音今後在理論上就可以引入對 InputHandler 等元件的更有效的單元測試。

$ EOF.