从建错项目到云手机跑起来:鸿蒙案例云端实践踩的四个坑
成长中心的「每周实践一次鸿蒙案例」任务,要求是:案例详情页点「云端实践」→ 作业中心建项目并拉取 Git 仓代码 → 成功编译打包。看起来是一条流水线,实际动手时我在四个地方卡了很久。这篇把过程和我踩的坑记下来,给同样在做这个任务的开发者省点时间。
坑一:项目建出来是个空目录
第一次建项目时,我只填了项目名,没注意「案例公仓地址」那一栏。创建是成功的,工作区也进去了,但目录里空空如也,没有 hvigorfile.ts,没有 oh-package.json5,更没有 entry。这个字段的作用是「新建项目时的首次公仓代码拉取」,漏填就等于建了个空壳。
解决办法是删掉重建,创建时就把案例仓地址填进去。重建之后工作区里直接就是完整工程,连 git clone 都省了。
坑二:输入框直接赋值不生效
第二次创建时我用脚本往输入框里塞地址,创建出来还是空目录。原因是这类基于前端框架的表单不认直接改 value,必须走原生 setter 再派发事件:
const setter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value").set;
setter.call(el, url);
el.dispatchEvent(new Event("input", { bubbles: true }));
el.dispatchEvent(new Event("change", { bubbles: true }));
换成这种写法之后,地址才真正进入表单状态,创建出来的项目才带着代码。
坑三:编译前缺两个配置文件
工程有了,直接跑 hvigorw 会报找不到 SDK。补上 local.properties 指向 API 26 的 sdk.dir,再加一个 .npmrc 指向 npmmirror 镜像,否则依赖下载会一直卡住。补完之后编译只用了 9 秒 900 毫秒,输出 BUILD SUCCESSFUL,没有错误,只有几条警告,产物在:
entry/build/default/outputs/default/entry-default-unsigned.hap
坑四:云手机的权限弹窗会挡住 UI 验证
平台只允许同时存在一个云手机实例,所以先确认有没有在跑的,有就复用,没有就按 API 26 申请 HarmonyOS 7.0.0 镜像。装包用 hdc install,启动用 start ability,都挺顺利。
但应用第一次启动会弹相册读取权限,弹窗不点掉,截图里永远是那个对话框。用 uitest dumpLayout 拿到节点坐标,再 uiInput click 点 Allow,主界面才真正出来。
结果
最终在云手机上看到的是完整的备份主界面:顶部四个标签页,三张统计卡(本地项目、待备份/失败、已备份),本地图库的空状态提示,还有筛选标签和底部的备份按钮。右上角显示「未配置」,说明 OBS 凭据还没填——这是下一步要做的,需要自己建桶并配置 Endpoint 和密钥。
几句总结
这个任务的技术难度其实不高,卡人的全是平台交互细节:表单字段漏填、前端框架的赋值方式、构建前的环境配置、云手机的权限弹窗。四个坑都过了之后,从建项目到真机跑起来不到半小时。
建议按这个顺序做:先确认案例仓地址填对 → 进工作区 ls 看一眼有没有 hvigorw → 补 SDK 和镜像配置 → 编译 → 申请云手机 → 装包启动 → 截图确认 UI。每一步都验证过再往下走,比一路冲到底回头排查要快得多。
- 点赞
- 收藏
- 关注作者
评论(0)