从案例仓到云端编译:鸿蒙「像素画板」案例在 AI 开发者空间的实践记录
一、为什么把鸿蒙案例放到云端做
本地做鸿蒙开发,最容易卡在环境上:DevEco 工具链、SDK、模拟器、编译依赖,任何一环版本不匹配都要折腾半天。华为云「鸿蒙开发实践中心」提供的云端作业中心把这一层屏蔽掉了——浏览器打开就是一台预装好工具链的独享容器,案例代码自动拉取,编译、打包、模拟器都在云端完成。
我这次选的是「像素画板」案例(ArkTS + ArkUI + Canvas,属于元服务形态,纯端侧、无云依赖),用它跑一遍"从案例仓到云端编译"的完整链路。
二、进入云端实践环境
- 打开鸿蒙开发实践中心,进入案例详情页,点击 云端实践;
- 页面会要求选择运行版本:
- 体验版:免费试用,秒级启动,不消耗额度,但容器 3 小时后释放、数据不保留;
- 持久化版:核时计费,关机自动保存数据。
一次性验证选体验版即可;
- 首次进入会提示「临时访问凭据(AK/SK)同步到 AI 开发者空间」,该凭据只存放在沙箱环境内,用于免手动配置;
- 进入后在「新建项目」里填写本地工作目录(英文、数字、
-、_,不能含中文或空格),系统会把案例公仓代码克隆到该目录,并自动建立 CodeArts CLI 的工作目录。
三、拉下来的是"案例仓",不一定是"工程"
这一步是我踩到的第一个坑。项目创建完成后,工作目录里的内容是:
LICENSE README.md cases data docs meta_service scripts
这是案例资料仓(多个案例共用),并不是一个能直接 hvigor 编译的 HarmonyOS 工程——没有 hvigorfile.ts、build-profile.json5、entry 模块。像「像素画板」这类"从空项目实践"的案例,需要按详情页给出的分阶段提示词,配合 AI 先把工程搭出来再编译。
所以编译前先做一次定位,别急着敲构建命令:
find ~/.harmony-practice-center/projects/pixel-paint -name hvigorfile.ts
有输出,说明该案例自带可编译工程;没有输出,就要先按案例文档生成工程骨架。
四、工具链是现成的
云端容器里已经装好了命令行构建工具:
which hvigorw # /root/command-line-tools/bin/hvigorw
hvigorw --version # 6.26.8
也就是说,只要工程目录就位,编译打包一条命令即可:
cd <工程根目录>
hvigorw assembleHap --mode module -p product=default
产物默认落在 entry/build/default/outputs/default/*.hap。如果编译通过、BUILD SUCCESSFUL,就可以直接在「设备管理 → 鸿蒙云手机」里安装运行,验证端侧效果。
五、GitCode 协作:绑定与 Star
鸿蒙实践中心的案例代码托管在 GitCode 的 harmony-practice-center 组织下。在实践任务里绑定 GitCode 账户后,可以:
- 在案例仓点 Star 收藏感兴趣的项目(每日任务要求 Star 不同项目,且不可取消);
- 通过组织的 Issues / Pull Requests 参与案例改进。
绑定入口在「实践任务 → Star 鸿蒙开发实践中心案例仓 → 管理绑定」,绑定后可以直接从弹窗跳到案例仓,省去自己找仓库地址。
六、几点经验
- 先确认工程,再编译:案例仓 ≠ 可编译工程,
find -name hvigorfile.ts一步就能判断; - 体验版适合试水:不耗核时、启动快,但数据不保留,重要内容要及时导出;
- 注意容器生命周期:体验版容器 3 小时释放,重新进入是全新容器;
- 编译打包是验收点:云端实践类任务最终以"成功编译打包"为准,只创建项目、拉完代码不算完成。
整体感受:把环境这件事交给云端后,注意力可以真正回到代码和案例本身。对想快速过一遍鸿蒙端侧开发流程的同学,这是一条成本很低的路径。
- 点赞
- 收藏
- 关注作者
评论(0)