从建错项目到云手机跑起来:鸿蒙案例云端实践踩的四个坑

举报
yd_254958141 发表于 2026/11/15 23:52:09 2026/11/15
【摘要】 成长中心的「每周实践一次鸿蒙案例」任务,要求是:案例详情页点「云端实践」→ 作业中心建项目并拉取 Git 仓代码 → 成功编译打包。看起来是一条流水线,实际动手时我在四个地方卡了很久。这篇把过程和我踩的坑记下来,给同样在做这个任务的开发者省点时间。坑一:项目建出来是个空目录第一次建项目时,我只填了项目名,没注意「案例公仓地址」那一栏。创建是成功的,工作区也进去了,但目录里空空如也,没有 hv...

成长中心的「每周实践一次鸿蒙案例」任务,要求是:案例详情页点「云端实践」→ 作业中心建项目并拉取 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。每一步都验证过再往下走,比一路冲到底回头排查要快得多。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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