把构建委托给 AI Shell:一次 HAP 打包链路里的权限闸门与可复现性
在云端开发环境里,最容易让人产生错觉的一句话是「帮我打包一下」。它听起来只是一个动作,实际却是一条包含环境探测、依赖解析、编译、签名、产物定位的链路。最近在华为云 AI 开发者空间的体验版环境里,用 CodeArts CLI 连上项目后把这句话交给 AI Shell 执行,整个过程跑通了,但暴露出来的几个细节值得单独记一笔——它们决定了「AI 帮你构建」到底是可复现的工程能力,还是一次性的演示。
一、构建请求被翻译成了什么
自然语言进去,出来的不是一条命令,而是一串工具调用:先读项目结构,确认 build-profile.json5 里的 SDK 配置,再判断用 hvigorw 还是 hvigor,然后执行 assemble 任务,最后在 entry/build/default/outputs/default/ 下找产物。
这个顺序本身没有问题,问题在于它是隐式的。你看到的是「AI 在跑」,看不到的是它凭什么选了这条路径。如果换一个项目、换一个 SDK 版本,这套隐式判断可能给出完全不同的命令序列,而你没有任何记录可以对照。
所以第一件要做的事不是催它快点跑完,而是在它开始之前先把基线固定下来:
- SDK 版本(compileSdkVersion / compatibleSdkVersion / targetSdkVersion)
- 构建工具版本(hvigor 及其插件)
- JDK / Node 版本
- 依赖清单是否带锁文件
这四样任何一样漂移,构建结果就不再可比。AI 只是执行器,构建定义不能由它临时决定。
二、权限闸门:终端 UI 里的弹窗不吃鼠标
构建过程中出现了一个很有意思的卡点。AI 要执行写文件、跑命令这类动作时,会弹出一个 Permission required 的确认层,默认高亮的是「Allow once」。这个弹窗渲染在终端 UI 内部,用鼠标点它没有任何反应,Playwright 的 click() 会一直等到超时;唯一有效的方式是把焦点交回终端,按回车确认。
如果连续有多个动作需要授权,就要连按几次回车。这件事的工程含义比它看起来重要:自动化的边界不是「能不能点到」,而是「授权模型长什么样」。一次性授权、会话内授权、永久授权,三种模式的自动化写法完全不同。云端 IDE 选择「每次确认」是安全上的合理选择,但它同时也意味着任何「无人值守构建」都得先解决授权通道,而不是解决点击坐标。
三、失败模式:00303313 与自动修复的边界
第一次编译没有通过,报的是 00303313,指向 SDK 版本不兼容。AI 的处理方式是读 build-profile.json5,把三个版本字段统一改成环境里实际存在的版本,然后重新编译,第二次通过,耗时约九秒。
这个行为值得肯定,但也值得警惕。它修的是配置与环境的错配,这类修复是安全的,因为目标明确、可回滚、有编译结果做验证。但如果失败原因是代码层面的类型错误,自动修改就可能变成「为了让编译过去而改代码」,那是另一回事。
一个可操作的判断标准:看它改的是声明还是实现。改版本号、改路径、改构建参数属于声明层,风险可控;改业务逻辑、改接口签名属于实现层,必须人工介入。
四、产物:unsigned 意味着什么
编译成功后拿到的是 entry-default-unsigned.hap。文件名里的 unsigned 是个容易被忽略的信息:它说明这条链路只完成了「编译 + 打包」,没有走签名。未签名的 HAP 不能直接安装到真机,需要再走签名配置(证书、Profile、密钥库)。
这意味着「打包成功」和「可交付」之间还有一步。把这一步漏掉,就会出现「本地构建绿的、装不上机器」的经典问题。在流水线里,签名应该是一个显式阶段,而不是构建脚本里的隐式分支。
五、可观测性缺口:xterm 读不到文本
云端环境的终端是 xterm 渲染的,innerText 拿不到任何内容,只能靠截图判断。这对人来说够用,对自动化来说是个硬缺口:你无法在日志里检索错误码,无法在失败时断言哪一行出了问题。
可行的补法是绕开终端这一层——让构建命令自己把日志写到文件,再从文件系统读。这样无论终端怎么渲染,日志都是可检索、可归档、可 diff 的。判断构建是否成功,也应该基于退出码和产物存在性,而不是「屏幕上看起来像成功了」。
六、把「委托」变成「可复现」的四个动作
综合这次的经验,如果要在团队里真的用起来,建议按这四步落地:
- 固定基线:把 SDK、构建工具、JDK、Node 版本写进仓库,构建前先校验,不匹配就报错而不是自动改。
- 显式阶段:依赖安装、编译打包、签名、产物归档,四个阶段分开,每段有自己的退出码。
- 日志落盘:不依赖终端回显,构建输出重定向到文件,失败时保留上下文。
- 产物校验:拿到 HAP 后校验文件名、大小、哈希,unsigned 的产物必须单独标记,不能混进交付目录。
AI 在这套流程里的位置很清楚:它负责把「我要什么」翻译成命令序列,负责在报错时给出候选修复,负责把散落的步骤串起来。它不负责定义构建是什么。把定义权交出去的那一刻,构建就不可复现了。
七、一点对比
手动在本地 IDE 里点 Build,快、直观、出错能立刻看到堆栈;云端 CLI 构建慢一点、需要授权、终端可读性差,但胜在环境一致、可脚本化、可多人共享同一套基线。两者不是替代关系:本地用于开发迭代,云端用于验证「在干净环境里能不能构建出来」。真正容易出问题的是只用其中一种——只在本地构建,容易积累环境依赖;只在云端构建,调试成本太高。
体验版容器三小时后释放、数据不保留,这个约束反过来是个优点:它逼着你把基线写进仓库,而不是留在某个人的机器上。构建能不能在新容器里一次跑通,是比任何文档都硬的验收标准。
- 点赞
- 收藏
- 关注作者
评论(0)