Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

交叉编译

宿主工具链运行在主机平台(如 linux-x64)上,默认编译该平台的程序。交叉 SDK 运行在同一主机上,提供面向其他目标平台(如 ohos 或 android)的编译工具和目标库。

cjv 将交叉 SDK 作为宿主工具链的附加安装进行管理:交叉 SDK 的发行版本必须与所依附的宿主工具链完全一致,可用目标列表由分发清单决定。

安装和查询

你可以在安装宿主工具链时通过 --target(-t)参数一并安装交叉目标,也可以稍后通过 cjv target add 为已安装的宿主工具链补装目标:

cjv install sts --target ohos
cjv target list --toolchain sts
cjv target add android --toolchain sts
cjv target list --toolchain sts --installed
  • cjv target add — 为宿主工具链当前已安装的版本补齐目标 SDK,不会升级宿主本身。
  • cjv target list — 查询分发清单中为该宿主发行版发布的所有可用目标,并标出哪些已安装。
  • cjv target list --installed — 只读取本地安装状态,支持完全离线执行。

指定目标参数(或在 cangjie-sdk.toml 中配置 targets)时,请只写目标后缀,例如 ohos、android 或 ohos-arm32,不要写 linux-x64-ohos 这样的完整宿主-目标平台名。安装命令支持重复传入 --target 或传入逗号分隔列表(如 --target ohos,android)。

使用目标 SDK

默认情况下,<CJV_HOME>/bin 中的 cjc、cjpm 代理命令仍选择宿主 SDK 环境。需要调用交叉 SDK 中的编译工具和目标库时,请在当前 shell 中通过 cjv envsetup 加载目标环境:

eval "$(cjv envsetup +sts --target=ohos)"
cjc --version

在 Windows PowerShell 中执行:

cjv envsetup +sts --target=ohos | Invoke-Expression

请注意,安装目标 SDK 或在 cangjie-sdk.toml 中声明 targets 只负责在磁盘上准备好交叉 SDK 文件,不会自动把普通的 cjpm build 转换为目标平台构建。后续编译参数、系统库(sysroot)和链接器配置由目标 SDK 及项目构建脚本决定;终端会话环境的切换与恢复详见运行命令与配置环境。

组件、更新和移除

每个交叉 SDK 独立管理自己的组件,宿主工具链的组件不会自动充当目标平台的组件。安装好目标 SDK 后,给 cjv component 命令加上 --target <suffix> 即可管理该交叉目标的组件:

cjv component add stdx --toolchain sts --target ohos
cjv component list --toolchain sts --target ohos
cjv target remove ohos --toolchain sts

运行 cjv update 更新跟踪通道(lts、sts、nightly)时,cjv 会先一并准备好新的宿主 SDK、已跟踪目标和已选组件,全部就绪后再统一原子发布。默认情况下,如果新版本缺少所需的目标或组件制品,cjv 会阻止更新并保留原有可用安装(nightly 通道会自动在已发布历史中查找满足全部目标和组件的兼容版本)。如果希望允许跳过并移除未发布的可选目标或组件,请传入 --allow-missing;具体规则见命令参考。

运行 cjv target remove 会移除所选交叉 SDK 及其目标组件,同时保留宿主工具链。交叉 SDK 依附于宿主工具链,不能直接设为全局默认或当前活跃工具链。