Rime输入法Squirrel前端在macOS上的编译安装指南

Rime输入法Squirrel前端在macOS上的编译安装指南

squirrel 【鼠鬚管】Rime for macOS 项目地址: https://gitcode.com/gh_mirrors/squ/squirrel

前言

Rime输入法引擎的Squirrel前端是专为macOS系统设计的输入法界面。本文将详细介绍如何在macOS系统上从源代码编译安装Squirrel输入法前端。通过本指南，您将获得一个完全自定义的输入法解决方案。

环境准备

开发工具要求

1. Xcode 14.0或更高版本：必须从App Store安装最新版Xcode，这是构建通用二进制应用(Universal app)的基础。

2. CMake构建工具：可通过多种方式安装：

   • 使用Homebrew安装：brew install cmake
   • 使用MacPorts安装：port install cmake
   • 直接从官网下载安装包

获取源代码

通过以下命令克隆Squirrel仓库及其子模块：

git clone --recursive https://github.com/rime/squirrel.git
cd squirrel

可选步骤：安装Rime插件（如需要额外功能）：

bash librime/install-plugins.sh rime/librime-sample

常用插件包括librime-lua（Lua脚本支持）、librime-octagram（N元语法模型）和librime-predict（预测输入）等。

快速安装方案

如果您不想从源码编译所有依赖，可以使用预编译的librime二进制文件：

bash ./action-install.sh

执行此命令后，可直接跳转到"构建Squirrel"部分。

完整编译方案

Boost C++库安装

有三种安装方式可选：

1. 从源码编译安装（推荐）：

export BUILD_UNIVERSAL=1
bash librime/install-boost.sh
export BOOST_ROOT="$(pwd)/librime/deps/boost-1.84.0"

2. 使用Homebrew安装（简单但不便携）：

brew install boost

3. 使用MacPorts安装：

port install boost -no_static

构建Squirrel

1. 确保所有子模块已更新：

git submodule update --init --recursive

2. 设置环境变量（根据需要调整）：

export BOOST_ROOT="path_to_boost"  # 必须
export DEV_ID="您的Apple ID"      # 用于代码签名，可选
export BUILD_UNIVERSAL=1          # 构建通用二进制
export PLUM_TAG=":preset"         # 或":extra"，使用预设配方
export ARCHS='arm64 x86_64'       # 目标架构
export MACOSX_DEPLOYMENT_TARGET='13.0'  # 最低系统版本

3. 开始构建：

make

或指定参数构建：

make ARCHS='arm64 x86_64' BUILD_UNIVERSAL=1

安装方式

制作安装包

make package ARCHS='arm64'

如需自动处理代码签名和公证，需设置DEV_ID环境变量为您的开发者ID，并配置公证凭据：

xcrun notarytool store-credentials '您的开发者ID'

直接安装（不推荐）

make install

注意：可能需要sudo权限，安装后可能需要注销才能正常工作。

清理工作

1. 清理Squirrel构建产物：

make clean

2. 清理所有依赖：

make clean-deps

3. 清理安装包：

make clean-package

结语

通过以上步骤，您可以在macOS系统上成功编译并安装Rime输入法的Squirrel前端。这个过程虽然略显复杂，但能为您提供一个高度可定制的输入法解决方案。如果在任何步骤遇到问题，建议检查环境变量设置和依赖项是否完整。

squirrel 【鼠鬚管】Rime for macOS 项目地址: https://gitcode.com/gh_mirrors/squ/squirrel