目录

常用开发任务

以开发一个音乐类型的HarmonyOS应用为例,介绍DevEco CLI常用命令。

开发准备

[h2]初始化CLI环境

输入自然语言“将devecocli的skills或mcp服务配置到opencode中”,让Agent调用鸿蒙开发相关能力。

[h2]登录华为账号

登录华为账号,以便进行签名配置、构建或发布等需要账号权限的操作。

[h2]查询文档

搜索并查看鸿蒙开发文档,了解指定组件或API的用法。

创建项目

[h2]创建音乐应用工程

创建一个音乐类型的应用工程,自动生成基础目录结构和示例代码。

[h2]配置签名

配置调试签名,使应用可以安装到真机或模拟器上进行调试。

生成代码

[h2]编写播放器核心功能

编写音乐播放器的核心功能代码,并在编写代码过程中自动查看相关API的用法,对生成的功能代码进行检查。

[h2]检查代码规范

检查代码是否符合ArkTS编码规范,并给出改进建议。

[h2]检查兼容性

检查项目在目标设备上的兼容性,排查潜在的兼容问题。

构建与运行

[h2]调试构建

执行调试构建,将应用安装到设备或模拟器上进行调试。

[h2]清理构建产物

清理构建产生的中间文件和产物,释放磁盘空间。

热重载开发

将主题色改为亮色,通过热重载在不重启应用的情况下验证UI改动生效。

模拟器测试

[h2]镜像管理

查询适用于当前工程的模拟器镜像。Agent读取工程的API配置,调用DevEco CLI的镜像查询能力,检查手机镜像的系统版本和下载状态。

Agent选择本地已下载的HarmonyOS 7.0手机镜像,供后续创建测试实例使用。需要其他版本时,可以继续获取所需镜像。

[h2]创建专用测试模拟器

为音乐应用创建专用测试模拟器。确定名称后,Agent调用 DevEco CLI的实例创建能力,再查询实例列表,确认MusicApp_Phone已创建成功。

[h2]启动模拟器

启动测试实例。Agent调用 DevEco CLI启动模拟器,并查询运行状态和连接信息,为后续部署应用确定目标设备。

启动完成后,模拟器显示系统界面。

[h2]在模拟器上调试运行应用

将音乐应用运行到已启动的模拟器。Agent结合工程模块和目标设备,调用DevEco CLI完成调试构建、安装和启动,并根据返回结果反馈部署状态。

应用启动后,可在模拟器上查看首页的推荐歌单和歌曲列表。

[h2]调整模拟器音量

在测试过程中,调整模拟器音量。Agent调用DevEco CLI的模拟器控制能力,将音量操作应用到当前测试实例。

结合系统音量面板,观察播放器页面和应用首页的显示效果。

调试与日志

[h2]查看设备日志

获取测试设备最近的日志。Agent调用DevEco CLI的日志采集能力,读取最近100行内容。

当返回内容主要为系统应用日志时,可以进一步限定应用范围,继续筛选。

[h2]音乐应用专项日志

只查看当前音乐应用的日志。Agent根据工程包名调用DevEco CLI的应用日志筛选能力,提取应用启动和页面加载等信息。

Agent将生命周期日志解释为应用创建、窗口创建、进入前台和页面加载完成,帮助判断启动过程。需要进一步分析播放行为时,可以按播放器的业务标记筛选相关事件。

[h2]实时日志跟踪

持续跟踪应用日志,同时操作播放、暂停和切歌。Agent使用DevEco CLI的实时日志能力采集运行信息,将新产生的日志与界面操作对应起来。

[h2]查看历史日志

查询指定时间段内的应用日志,例如当前时刻10分钟前至5分钟前这段时间。Agent 将时间范围转换为日志查询条件,调用DevEco CLI获取对应记录,并解释该时段发生的操作。

查询结果包含应用创建、进入前台和页面加载记录,可用于回溯启动过程,或与异常发生的时间进行对照。

[h2]分析崩溃日志

在测试代码中加入越界访问,点击“下一首”触发崩溃,用于演示故障定位流程。

应用崩溃后,分析原因。Agent调用DevEco CLI获取崩溃日志,提取异常类型和调用栈,再读取对应源码进行定位。

Agent定位到“下一首”逻辑中的歌单越界访问:读取不存在的歌曲后继续访问其名称,引发异常。根据这一结果,可以继续移除演示故障代码、检查歌单边界,并通过DevEco CLI重新构建运行,按相同操作复验。

Skills(可选)

[h2]列举可用Skills

查询HarmonyOS应用开发可用的技能。Agent调用DevEco CLI的技能查询能力,获取skill列表,并按ArkUI开发、崩溃分析、多设备适配等用途进行整理。

[h2]查找所需Skills

Agent结合各项技能的描述,选择多设备适配入口,以及折叠状态、窗口尺寸、屏幕方向和交互方式相关技能,并说明选择理由。

[h2]安装Skills

将选定skill安装到当前工程。

Agent调用DevEco CLI的skill安装能力,完成五项技能的安装,并反馈安装结果。Agent可加载对应技能,依据其中的指导开展适配开发。

应用发布前检查

[h2]兼容性检查

检查当前代码的系统版本兼容性。Agent先调用 DevEco CLI查询可用的检查版本,再结合工程配置确定源版本和目标版本,执行工程扫描。

DevEco CLI返回API变更及代码位置,Agent据此整理接口定义、视觉布局和接口行为等方面的影响,指出需要关注的调用。

[h2]签名检查

检查工程签名配置和材料,确认是否满足构建及发布要求。

Agent读取工程配置,检查构建产品与签名配置的关联,再核对证书、密钥库、profile、应用包名和有效期,汇总检查结果。

[h2]发布构建

执行发布构建。Agent根据工程配置调用DevEco CLI的release构建能力,检查构建结果,并查找生成的应用包。

构建完成后,Agent汇总已签名和未签名产物的位置,便于继续测试或准备交付。