扩展库源码集成指南

两种集成方式

stdx 有两种源码集成方式：git 源码依赖和本地源码依赖。

git 源码依赖

在工程的 cjpm.toml 文件中，新增如下源码依赖配置：

[dependencies]
  stdx = { git = "https://gitcode.com/Cangjie/cangjie_stdx.git", branch = "dev", output-type = "dynamic" }

在工程的 cjpm.toml 文件所在目录，执行 cjpm update 命令即可同步更新本仓源码。

本地源码依赖

如果不希望通过 git 依赖本仓，开发者可以直接下载本仓库分支的全量源码（包括本仓库的 cjpm.toml 配置文件），然后在工程的 cjpm.toml 文件中添加本地模块依赖。

[dependencies]
  stdx = { path = "/path/to/cangjie_stdx", output-type="dynamic"}

完成本地模块依赖添加之后，即可在项目中使用 stdx。

包范围

目前源码依赖集成的 stdx 不包含 aspectCJ 和 syntax，并且在 Windows 平台上没有 fuzz 包。

支持平台

Linux
macOs
Windows
交叉编译 OpenHarmony

交叉编译 OpenHarmony

Linux 和 macOS 平台交叉编译 OpenHarmony 需要配置交叉编译工具链的环境变量（非 DevEco Studio 项目），请参考编译 ohos-x86_64、ohos-aarch64 工具链

OHOS_TOOLCHAIN_PATH (编译工具链中 Clang/LLVM 编译器的二进制目录, 如 /opt/buildtools/ohos_root/prebuilts/clang/ohos/linux-x86_64/llvm/bin)
OHOS_SYSROOT_PATH (OpenHarmony 系统头文件目录，如 /opt/buildtools/ohos_root/out/sdk/obj/third_party/musl/sysroot)

DevEco Studio 自带 OpenHarmony 交叉编译工具链，无需设置上面的环境变量。

交叉编译命令：cjpm build --target aarch64-linux-ohos 或者 cjpm build --target x86_64-linux-ohos

注意：

部分版本 DevEco Studio 可能缺少 openssl 头文件，构建过程中报错找不到 openssl 头文件，需要准备 openssl 头文件放入 DevEco Studio 的 sysroot 下。

Windows 常见路径如 C:\Program Files\Huawei\DevEco Studio\sdk\default\openharmony\native\sysroot\usr\include\openssl。

macOS 常见路径如 /Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/native/sysroot/usr/include/openssl。

依赖

由于 stdx 需要拉取并编译外部开源 C 库，也有涉及 C 互操作的包，目前构建有一些额外依赖（使用 DevEco Studio 除外，DevEco Studio 自带了下面的工具），提前准备好下面的依赖，同时配置好环境变量。

python: > 3.7
cmake: >= 3.16.5 且 < 4
ninja: >1.10
openssl: >= 3 （需要配置环境变量 OPENSSL_ROOT_DIR，指向 OpenSSL 安装的根目录）
clang: >= 15.0.4 且 < 16 (Linux or macOS)
mingw-w64 (Windows) 下载地址

Keyboard shortcuts