SuperAPI AI 工具集

harmonyos-build-deploy

部署与运维

查看项目

更新于 10-15 12:28

技能介绍

用途

该技能用于 HarmonyOS 应用的构建、清理、打包与设备安装,覆盖使用 hvigorw 构建 HAP/APP 包、使用 ohpm 管理依赖、使用 hdc 与设备通信并安装应用,以及通过 bm、aa 命令管理与启动应用的完整流程。

使用方式与操作确认

执行任何构建或部署操作前,技能要求先与用户确认要执行的具体操作,候选操作包括:清理构建产物、安装依赖、构建项目、安装到设备、以及完整流水线(清理 → 安装依赖 → 构建 → 部署到设备)。确认后再执行所选操作并报告进度与结果。

主要能力

  • 清理构建产物:hvigorw clean --no-daemon,以及针对依赖问题的深度清理流程。
  • 安装依赖:ohpm install --all,可使用自定义仓库参数 --registry。
  • 构建项目:增量构建(默认)与全量构建命令,示例为 hvigorw assembleApp --mode project -p product=default -p buildMode=release --no-daemon。
  • 单模块构建:支持 assembleHap、assembleHsp、assembleHar,模块名格式为 {moduleName}@{targetName},并支持一次构建多个模块。
  • 项目同步:在修改 build-profile.json5 或 oh-package.json5 后执行 hvigorw --sync -p product=default -p buildMode=release --no-daemon。
  • 设备安装:使用 hdc 列出设备、推送文件、安装 HAP/HSP、校验安装、启动 Ability、卸载应用。
  • 应用管理:bm 安装、卸载、查询、清理缓存与数据;aa 启动 Ability 或强制停止应用。
  • 构建参数与输出:包括 -p product、-p buildMode、-p module、--mode project/module、--no-daemon、--analyze=advanced,构建输出位于 outputs/。
  • 模块类型说明:HAP、HSP、HAR、APP 的定义与扩展名;模块类型由 {module}/src/main/module.json5 的 type 字段决定,并对应不同构建命令。
  • 故障排查:覆盖版本码不一致、签名/配置文件不匹配、SDK 版本过低、设备未找到、签名验证失败等常见问题的原因与处理方向。
  • 关键配置文件:AppScope/app.json5、build-profile.json5、模块的 module.json5 与 oh-package.json5。

适用场景

适用于 HarmonyOS 项目开发中的日常增量构建、单模块调试、首次克隆后的依赖安装、清理构建、真机安装与启动、缓存/数据清理,以及 CI 场景中禁用守护进程的构建。

限制与注意事项

技能说明构建、清理与部署操作耗时较长(构建约 30 秒,文件传输约 20 秒),建议委派给子代理执行以避免超时并获得更好的错误处理与进度反馈。另外,在 Git Bash 环境下需注意 MSYS_NO_PATHCONV=1 以禁用路径转换。具体适用范围、平台支持及更多未在资料中说明的内容暂未提供。