在华为云 CodeArts 云端编译鸿蒙 HAP:hvigorw assembleHap 全流程与 5 个坑
背景
鸿蒙应用要在 CI 或者云端环境里出包,绕不开 hvigor 的构建链路。本文记录一次在华为云 CodeArts 云端工作台里,把 HarmonyOS 案例工程从代码仓拉下来、编译成 HAP 的完整过程,以及期间真实踩到的 5 个坑。
环境和目标
- 工作区:云端开发环境(CodeArts Web 终端),临时体验容器
- 工程:HarmonyOS 元服务案例(ArkTS,API 24)
- 目标:产出 debug HAP,验证代码在目标 SDK 上可编译
第一步:把工程拉进工作区
云端项目创建时即使填写了「案例公仓地址」,也经常不会自动拉代码——关联仓库一栏显示 -,目录里只有 .codearts。所以不要等它自动完成,进终端手动 clone 最省时间:
cd /root/workspace
git clone <案例公仓地址> <repo>
cd <repo>
公开仓库可以匿名 clone,不需要任何 token。clone 完后先确认一下根目录结构:build-profile.json5、hvigorfile.ts、oh-package.json5 这三件套在,才说明拉的是工程根,而不是外层包装目录。
第二步:hvigorw assembleHap
cd <module 目录>
hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon
几个参数的用法值得说明:
--mode module:只编当前模块,比整包构建快很多,适合验证某个 HAP 是否能过编译;-p product=default:指定产品维度,多 product 工程必须显式给,否则会报产品未定义;-p buildMode=debug:debug 包不要求正式签名,云端没有签名材料时这是唯一能出包的模式;--no-daemon:每次都起独立进程,避免容器里守护进程残留导致的增量缓存错乱,代价是首次构建慢一些。
本次输出:
BUILD SUCCESSFUL in 1s 512ms
33 tasks: 16 executed, 17 cached
同时会有一行 WARN: Will skip sign 'hos_hap'。这不是错误:调试构建没有配置签名证书时,hvigor 会跳过签名步骤,HAP 仍然会产出,可以直接装到已开调试的设备上,只是不能用于上架。
五个坑
1. 不是所有工作台都能敲命令
云端工作台有两种入口:一种是 TUI 形态的 CLI 代理,另一种是 Web 形态的对话/终端面板。TUI 里合成的 Enter、Tab、Esc 经常完全不生效,命令停在「QUEUED」,权限弹窗也点不动,很容易误判成环境卡死。要跑构建,优先用 Web 界面的终端。
2. 不要给 AI 代理模糊指令
如果让 AI 代理代跑,提示词里必须写清「不要删除或修改任何文件,只做编译」。否则它可能先执行一次目录清理,把刚拉下来的源码删掉。
3. 缓存会骗人
17 cached 说明大部分任务命中了上一次的构建缓存。改了代码却看到任务数一样、耗时极短,先看 executed 的数量,别把「有缓存」当成「没重新编」。
4. 首次构建会下载依赖
容器是全新的,ohpm 依赖和 hvigor 插件都要现下。第一次构建耗时主要在网络上,第二次才会落到秒级。遇到「卡住不动」,先看是不是在联网拉包,而不是编译死锁。
5. 容器是按时间计费的资源
体验版容器通常有 3 小时倒计时,到点自动释放、数据不保留;持久化版本按核时计费。验证编译这种一次性任务,用体验版就够,别为了一次构建长期占着核时。
小结
把鸿蒙工程放进云端编译,核心就是三件事:确认拉的是工程根、用对 hvigorw 的参数组合、接受 debug 包没有签名这个事实。其余时间基本都花在等容器启动和等依赖下载上,属于正常现象,不必反复重启环境。
- 点赞
- 收藏
- 关注作者
评论(0)