鸿蒙 HAP 云上编译实录:CodeArts Web 配 hvigorw 的 6 个坑

举报
yd_226289576 发表于 2026/11/18 16:49:53 2026/11/18
【摘要】 在华为云 CodeArts 体验版容器里跑通鸿蒙 HAP 编译的完整流程,附 6 个实测踩到的坑:版本选择、Vue 表单赋值、CLI 无法自动化、AI 代理误删文件、公仓不自动拉取、签名告警。

手上没有 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 大概二十多分钟,比在本地装工具链省心。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。