鸿蒙 HAP 云上编译实录:CodeArts Web 配 hvigorw 的 6 个坑
手上没有 M 系列芯片的 Mac、本地又不想装一整套 DevEco 工具链时,把鸿蒙工程扔到云上编译是个很划算的选择。华为云 CodeArts 的体验版容器给的是完整的 HarmonyOS 构建环境,浏览器里就能跑 hvigorw assembleHap。这篇记录我实际跑通一次 HAP 编译的流程,重点是那几个文档里没写、但一定会踩到的坑。
1. 环境从哪进
入口是鸿蒙开发实践中心的任意一个案例详情页,点「云端实践」,在版本选择页挑「体验版」。页面会明确写「免费试用 · 不消耗任何额度」,容器起来后开始 3 小时倒计时,到点自动释放。
- 选版本必须用 JS 点
.ver-card,用坐标点经常没反应;点完class变成ver-card sel才算选中。 - 容器起来后记下地址,形如
18000-<容器ID>.workspace.developer.huaweicloud.com,直接访问这个地址比在页面里翻入口稳。
2. 新建项目:名字随手填,模板不要动
进项目管理页点「新建项目」,填名称、本地工作目录、描述即可。技术模板保持默认,动它反而容易生成一个和案例不匹配的骨架。
表单输入框是 Vue 绑定的,用普通的 fill_input 有时读回是空的,要用原生 setter:
Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')
.set.call(el, 'pixelpaint');
el.dispatchEvent(new Event('input', { bubbles: true }));
el.dispatchEvent(new Event('change', { bubbles: true }));
3. 别指望 CodeArts CLI 能自动化
左侧菜单里有 CLI(终端界面)和 Web 两个入口。CLI 是 TUI,用 CDP 合成的按键基本喂不进去:输入框能进字符,但 Enter、Tab、Esc 全部无效,命令永远停在 QUEUED,权限弹窗也点不动。想脚本化就用 Web,那里是 textarea 加一个可点的发送按钮。
4. 提示词里必须写「不要删除文件」
CodeArts 的 AI 代理是自主执行型的。我第一次只写了「编译这个项目」,它理解成要重构目录,准备 rm -rf 清空工作区——幸好带审批,被拒了。稳妥的写法是把边界讲清楚:
在项目目录克隆仓库到当前目录(临时目录 clone 后 rsync 过来也行),
不要删除或修改任何文件;然后 cd meta_service &&
hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon
5. 「案例公仓」填了也可能不拉代码
新建项目表单里有一栏「案例公仓地址」,填了之后不一定会自动拉代码:关联仓库 URL 可能显示 -,目录里只有 .codearts。别在这卡住,直接在对话里让它手动 clone 就行,公开仓库匿名可拉,不需要任何凭据。
6. 成功长什么样
构建命令跑完,回复里会出现:
BUILD SUCCESSFUL;- 任务统计,例如 33 个任务、执行 16 个、命中缓存 17 个、耗时 1.5 秒;
- 一条
WARN: Will skip sign 'hos_hap'—— 没配签名证书就会这样,只做编译验证的话属于正常。
产物在 build/default/outputs/default/ 下,能下载就说明整条链路通了。
最后两点
体验版容器 3 小时自动释放、数据不保留,做完就结束,不用想着保活;需要反复构建的场景才考虑持久化版本,那个是按核时计费的。另外整个流程里没有产生任何云资源费用——免费试用就是真的免费,前提是别在案例里顺手开桶、开数据库。
把上面六条记住,从零到 BUILD SUCCESSFUL 大概二十多分钟,比在本地装工具链省心。
- 点赞
- 收藏
- 关注作者
评论(0)