harmony-client/docs/build-deploy.md

Build & Deploy（构建与部署）

构建系统：hvigor（HarmonyOS 官方构建工具），配置见 hvigor/、hvigorfile.ts、build-profile.json5。

构建 / 运行 Build & Run

• 主路径：DevEco Studio → Build / Run（GUI）。首次打开自动同步依赖。
• 命令行（hvigorw wrapper 由 DevEco 首次同步生成）：

# 构建 debug HAP
hvigorw assembleHap --mode module -p product=default -p buildMode=debug

# 构建 release HAP
hvigorw assembleHap --mode module -p product=default -p buildMode=release

产物通常在 entry/build/default/outputs/ 下（default 为 product 名）。

签名 Signing

build-profile.json5 里 signingConfigs 目前为空，且 products[].signingConfig 引用了 "default" —— 签名尚未配置。 要跑真机/模拟器需先配置签名：

• DevEco Studio → File → Project Structure → Signing Configs → 勾选自动签名（登录华为账号）。
• 或手动配置 .p12 + .cer / .p7b。

该文件的签名部分属于 Agent 禁止修改 范围（见 AGENTS.md）。

产品与构建模式 Products & Build Modes

• products：当前只有一个 default（targetSdkVersion 6.0.2(22)，runtimeOS: HarmonyOS）。
• buildModeSet：debug / release。

部署 Deploy

1. 配置签名（见上）。
2. 连接真机（开启开发者模式 + USB 调试）或启动模拟器。
3. DevEco Studio 选择设备 → Run。

环境环境变量 / 本地配置

• local.properties：本机 SDK 路径等，已 gitignore，勿提交，勿写密钥。
• 依赖锁：oh-package-lock.json5，提交以固定依赖版本。