| name | build |
| description | 编译构建仓颉 HarmonyOS 应用,执行 ohpm 依赖安装、仓颉资源同步和 HAP 包打包。用户说编译、构建、build、打包时触发 |
| allowed-tools | Bash(python3 *), Bash(ls *), Bash(cat *) |
| argument-hint | [-v 8k|15k] |
仓颉 HarmonyOS 应用编译构建
执行编译构建:
python3 ${CLAUDE_SKILL_DIR}/build.py $ARGUMENTS
前置检查(构建前必须完成)
| # | 检查项 | 检查方式 | 未通过时 |
|---|
| 1 | 项目类型是 HarmonyOS 应用 | 工程根含 entry/ + module.json5 | 若是 cjpm 库 → 改用 /cangjie-lib-build |
| 2 | .env 中 DEVECO_HOME 已配置 | 读取 .env 文件 | 提示用户补充,给出平台典型值 |
| 3 | 仓颉 SDK 可用 | .env 中配置或 ~/.cangjie-sdk/ 存在 | 提示用户安装 SDK |
| 4 | 构建版本确认 | 检查 .openvk-version 或用户传 -v 参数 | 默认使用 8k |
构建流程
脚本按顺序执行三个阶段:
- 安装依赖 —
ohpm install --all
- 同步仓颉资源 —
hvigorw SyncCangjieResource
- 编译打包 —
hvigorw assembleHap
配置说明
.env 中 DEVECO_HOME 和 CANGJIE_SDK_HOME-* 的配置详见 base-skill 平台典型值
.openvk-version 文件指定构建版本(8k 或 15k,默认 8k),也可通过 -v 参数覆盖
常用参数
python3 ${CLAUDE_SKILL_DIR}/build.py -v 8k
python3 ${CLAUDE_SKILL_DIR}/build.py -v 15k
产物位置
entry/build/default/outputs/default/entry-default-unsigned.hap
编译失败排查
- 仓颉编译错误会显示源文件路径和行号,定位到具体
.cj 文件
- 查阅
evolution skill(cangjie/syntax.md、cangjie/arkui.md、cangjie/state.md)中的已知问题
macro evaluation has failed → 检查 @Component/@Observed 等宏的使用约束
- 类型不匹配 → 注意
Int32 vs Int64、Array vs ArrayList 等差异
- 环境问题 → 确认
.env 中 DEVECO_HOME 路径正确
- 经验回写:排查并解决了非显而易见的编译问题后,将经验写入
evolution/cangjie/ 对应主题文件(格式参见 evolution/SKILL.md)