build-recipe.md 1.5 KB
CLI 构建配方（2026-08-23 实测验证）
工程：/Users/eastudio/DevEcoStudioProjects/dsh-harmony（2026-08-23 目录已由 DSHohos 改名对齐产品名；bundleName com.dotouch.dshharmony，显示名 DSH Harmony）
关键结论：hvigor CLI 编译需要三个环境变量，缺一会失败
- JAVA_HOME：指向 DevEco 自带 JBR（HAP 打包工具 app_packing_tool.jar 依赖 Java，系统 PATH 无 Java 时报「Unable to locate a Java Runtime」）
- DEVECO_SDK_HOME：指向 DevEco 内置 SDK
- 用 DevEco 内置 node 跑 hvigorw.js（工程根目录无 hvigorw 包装脚本）
已固化为脚本
scripts/build.sh（工程内，已 chmod +x，实测通过）：产出 entry/build/default/outputs/default/entry-default-unsigned.hap
当前工程配置（已应用用户决定）
| 项 | 值 |
|---|---|
| bundleName | com.dotouch.dshharmony |
| vendor | dotouch |
| 应用显示名 | DSH Harmony |
| targetSdkVersion | 26.0.0（HarmonyOS 7） |
| compatibleSdkVersion | 6.0.0(20)（HarmonyOS 6.0，注意 API 10-25 必须用 X.Y.Z(API) 格式，纯数字会报 Specification Limit Violation） |
待办
- 签名：signingConfigs 为空，产出为未签名 HAP。部署到模拟器/真机前需在 DevEco Studio 中开启一次自动签名（File > Project Structure > Signing Configs > 勾选 Automatically generate signature，需登录华为账号），之后 CLI 构建即可带签名
- hdc 工具：/Applications/DevEco-Studio.app/Contents/sdk/26.0.0/toolchains/hdc（v3.2.0e）