README in English | 普通話(Mandarin)

粵拼輸入法

iOS、iPadOS 及 macOS 粵語拼音輸入法。

採用 香港語言學學會粵語拼音方案 ，兼容各種習慣拼寫串法。

候選詞hau6 syun2 ci4會標注對應嘅粵拼。
支持簡、繁體漢字及各種字形標準。
可以用倉頡、速成、筆畫、普通話拼音、拆字等反查粵語拼音。

另有 Android 版: yuetyam/jyutping-android

擷屏（Screenshots）

iOS & iPadOS

兼容系統： iOS / iPadOS 16.0+

macOS

由於 第三方輸入法無法上架 Mac App Store ，請前往 官網 下載安裝，或者用 Homebrew 安裝 。

選項䈎面： 輸入法撳 Control + Shift + ` (位於 esc 鍵下方) 會顯示一個選項䈎面。
常問問題： 常問問題（FAQ）
兼容系統： macOS 13 Ventura 或者更高。

如何構建（How to build）

前置要求（Build requirements）：

• macOS 26.0+
• Xcode 26.0+

倉庫體積比較大，建議加 --depth 來 clone：

git clone --depth 1 https://github.com/yuetyam/jyutping.git

先構建數據庫 (Prepare databases)：

# cd path/to/jyutping
cd ./Modules/Preparing/
swift run -c release

跟住用 Xcode 開啓 Jyutping.xcodeproj 即可。

成個工程(project)包含 Jyutping, Keyboard, InputMethod 三個目標(target)。
Jyutping 係 iOS & macOS App，Keyboard 係 iOS Keyboard Extension，InputMethod 係 macOS 輸入法。

注意事項: 請勿直接 Run InputMethod，只可以 Build 或 Archive

如果要自己本機測試 Mac 輸入法，請將 Archive & Export 出來嘅輸入法程式 Jyutping.app 放入 /Library/Input Methods/ 資料夾。
如果替換舊有 Jyutping.app 輸入法箇陣，彈提示話佢運行緊、無法替換，可以去 Terminal（終端） 用以下命令將佢結束運行：

osascript -e 'tell application id "org.jyutping.inputmethod.Jyutping" to quit'

鳴謝（Credits）

• Rime-Cantonese (Cantonese Lexicon)
• OpenCC (Traditional-Simplified Character Conversion)
• JetBrains (Licenses for Open Source Development)

支持作者開發（Support this project）

官網: https://jyutping.app/donate

Patreon: https://patreon.com/bingzheung

愛發電: https://afdian.com/a/jyutping

Ko-fi: https://ko-fi.com/zheung

PayPal: https://paypal.me/bingzheung

Bitcoin: bc1qx5tjmlvq8ydmfzxt5fru7vqq0khjkhf2savheh