English | 中文

Fcitx5 macOS

Fcitx5 input method framework ported to macOS.

Public beta: please download installer.

Build

Native build on Intel and Apple Silicon is supported.

This is NOT an Xcode project, but Xcode is needed for Swift compiler.

Install dependencies

You may use nvm to install node, then

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
brew install cmake ninja extra-cmake-modules gettext iso-codes xkeyboardconfig nlohmann-json
./install-deps.sh
npm i -g pnpm
pnpm --prefix=fcitx5-webview i

Build with CMake

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
cmake --build build
sudo cmake --install build

Code sign

Some features (e.g. notifications) require the app bundle be code-signed after installation:

sudo /usr/bin/codesign --force --sign - --deep /Library/Input\ Methods/Fcitx5.app

Debug

Console.app

• Check Include Info Messages and Include Debug Messages in Action menu.
• Put FcitxLog in Search.

Log

/tmp/Fcitx5.log contains all log in Console.app, plus those written to stderr by engines, e.g. rime.

lldb

SSH into the mac from another device, then

$ /usr/bin/lldb
(lldb) process attach --name Fcitx5

Plugins

Fcitx5 only packages keyboard engine. To install other engines, use the built-in Plugin Manager.

Translation

Swift sources

To update .strings files for each supported locale, run

cmake --build build --target GenerateStrings

This will, e.g., update assets/zh-Hans/Localizable.strings, and then the translator can work on it.

C++ sources

First, create assets/po/base.pot file:

cmake --build build --target pot

To add a new language, do

cd assets/po && msginit

and then add this locale to assets/CMakeLists.txt.

Then, use a PO file editor to translate strings.

Finally, to merge new strings into PO files, do

cd assets/po && msgmerge -U <locale>.po base.pot

Credits

• fcitx5: LGPL-2.1-or-later
• fcitx5-android: LGPL-2.1-or-later
• squirrel: GPL-3.0-only
• swift-cmake-examples: Apache-2.0
• SwiftyJSON: MIT
• pugixml: MIT
• webview: MIT