Fcitx5 macOS 版安装与配置指南

Fcitx5 macOS 版安装与配置指南

fcitx5-macos WIP: macOS port of Fcitx5 项目地址: https://gitcode.com/gh_mirrors/fc/fcitx5-macos

1. 项目基础介绍

Fcitx5 macOS 是小企鹅输入法（Fcitx）的一个分支，专门为 macOS 操作系统设计。Fcitx 是一款开源的输入法框架，支持多种语言的输入。本项目使用了 Swift 和 C++ 等编程语言，旨在为 macOS 用户提供一个功能强大的输入解决方案。

2. 项目使用的关键技术和框架

本项目主要使用了以下技术和框架：

• Swift：用于 macOS 应用的主要开发语言。
• C++：用于输入法引擎的部分开发。
• CMake：跨平台的安装（编译）工具，用于构建项目。
• Ninja：一个快速的构建系统，与 CMake 配合使用。
• extra-cmake-modules：为 CMake 提供额外模块，用于处理 macOS 特定的构建需求。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统满足以下要求：

• macOS：推荐使用最新的 macOS 版本。
• Xcode：需要安装 Xcode，因为它包含了编译 Swift 和其他语言所需的编译器。
• Homebrew：用于安装项目依赖的包管理器。

详细安装步骤

步骤 1：安装 Homebrew（如果尚未安装）

打开终端，输入以下命令安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤 2：安装项目依赖

使用 Homebrew 安装项目所需的依赖：

brew install cmake ninja extra-cmake-modules gettext librsvg

步骤 3：克隆项目代码

在终端中，使用以下命令克隆项目代码到本地：

git clone https://github.com/fcitx-contrib/fcitx5-macos.git
cd fcitx5-macos

步骤 4：安装 Node.js 和 npm

本项目需要 Node.js 和 npm，可以使用以下命令安装：

nvm install node

步骤 5：安装项目脚本依赖

在项目目录中，运行以下命令安装项目脚本依赖：

./scripts/install-deps.sh
npm i -g pnpm
pnpm --prefix=fcitx5-webview i

步骤 6：构建项目

使用 CMake 构建项目：

cmake -B build/ $(uname -m) -G Ninja -DCMAKE_BUILD_TYPE=Debug
cmake --build build/ $(uname -m)

步骤 7：安装到系统

构建完成后，使用以下命令将 Fcitx5 安装到系统中：

sudo cmake --install build/ $(uname -m)

安装完成后，需要注销并重新登录，然后在系统设置 -> 键盘 -> 输入源中添加 Fcitx5，选择简体中文。

步骤 8：代码签名（可选）

某些功能（如通知、核心转储）需要应用包进行代码签名。可以通过以下命令进行代码签名：

./scripts/code-sign.sh

完成以上步骤后，您应该能够在 macOS 上成功安装并使用 Fcitx5 输入法。

请注意，本指南针对小白用户，尽可能简化了安装过程，但在实际操作中可能会遇到各种问题，需要根据具体情况调整步骤。

fcitx5-macos WIP: macOS port of Fcitx5 项目地址: https://gitcode.com/gh_mirrors/fc/fcitx5-macos