在 OpenHarmony 开发过程中,连接开发板进行应用调试是一个关键步骤,只有在真实的硬件环境下,我们才能测试出应用更多的潜在问题,以便后续我们进行优化。本文详细介绍了连接开发板调试 OpenHarmony 应用的操作步骤。
首先,我们搭建了OpenHarmony的开发环境,安装 OpenHarmony SDK 和所需的驱动程序。接着,我们通过USB连接方式将开发板连接到开发机。在连接成功后,我们使用 DevEco-Studio 部署和启动应用。通过监控应用在开发板上的运行情况,我们可以利用日志输出进行问题诊断。
一、搭建OpenHarmony开发环境
前面我们已经介绍了如何从零到一搭建HarmonyOS应用开发环境,这里只做简单回顾,详细流程参考我之前的文章:HarmonyOS应用开发-搭建开发环境
1、安装DevEco Studio
官网:HUAWEI DevEco Studio和SDK下载和升级 | HarmonyOS开发者
下载 DevEco Studio 3.1.1 Release 最新版本。
下载完成后,点击安装,根据大家自己的喜好选择路径安装即可,需要 2GB 的存储空间。
记得勾选 “生成快捷方式” 和 “添加到path环境变量” 。
后面一直Next,直到安装完成。
安装完需要对电脑重启。
2、安装 Node.js 和 ohpm
首次运行 DevEco Studio 会来到这个页面。
HarmonyOS 应用开发需要我们的电脑上安装 Node.js 和 ohpm (鸿蒙生态三方库的包管理工具)
这里华为官方提供了镜像,如果本机上之前没有装过,直接勾选 install 然后下一步即可。
3、安装HarmonyOS SDK
基础组件安装后,我们需要安装 HarmonyOS 的 SDK。HarmonyOS SDK 提供应用及服务开发所需的一系列系统开放能力,包括框架、Ability、分布式服务、安全、方舟编译器、HMS Core、基础软件服务、硬件服务等。
这里选择安装路径即可,我直接默认路径,点击下一步。
这个页面展示了所有需要安装的包,点击下一步安装。
几分钟后安装完成。
二、开发OpenHarmony应用
前面我们已经介绍了如何从零到一开发一款HarmonyOS应用,这里只做简单回顾,详细流程参考我之前的文章:HarmonyOS应用开发-使用低代码快速开发一个应用
1、创建Stage模式应用
创建时,我们需要选择模型,模型有两种,一种是FA模型,一种是Stage模型。API 8及以前的接口基于FA模型提供;从API 9开始,OpenHarmony主推Stage模型。这里我们使用Stage模式创建,并勾选低代码开发模式。
创建好之后,我们进入项目开发界面。
2、低代码开发应用
参考我之前文章的步骤,很快我们就可以使用低代码做出一个简单应用。
代码完成后,我们可以使用DevEco Studio自带的模拟器进行调试。
添加模拟设备,然后点击启动。
模拟器调试效果如下:
确保我们的HarmonyOS应用在模拟器里可以运行,后面就可以直接在开发板上部署了。
三、开发板安装OpenHarmonyOS
先确认一下开发板是否已经预装OpenHarmony系统,如果没有,我们需要自行烧录OpenHarmony系统到开发板。
前面我们已经介绍了如何从零到一烧录OpenHarmony系统到开发板,这里只做简单回顾,详细流程参考我之前的文章:OpenHarmony开发-烧录OpenHarmony系统到开发板
本次我们演示使用的开发板是鸿诚志远 HCPAD-100 ,是基于瑞芯微 RK3568 设计的一款人工智能开发板,其他开发板,例如 RK3568 或者 HiHope DAYU200 都是可以的。
1、准备工作
硬件准备:
- RK3568开发板(或HCPAD-100开发板、HiHope DAYU200开发板等)
- 双USB口数据线
- 电源适配器等。
软件准备:
- 获取OpenHarmony的源代码。
- 准备RK3568的烧录工具,例如RKDevTool。
- 安装并配置开发环境,比如确保有适合的编译工具链。
2、下载RK驱动和烧录工具
下载RK驱动助手和AndroidTool烧录工具。
地址:Firefly | 让科技更简单,让生活更智能 (t-firefly.com)
下载完成后进行安装。
① 安装RK驱动助手
双击安装程序,选择驱动安装,安装完成后电脑连接开发板时才可以识别。
② 安装AndroidTool烧录工具
选择安装路径安装,安装完成后打开如下,在没有连接设备时显示 No Devices Found。
3、下载HDC命令工具
HDC (OpenHarmony Device Connector) 是为开发人员提供的用于设备连接调试的命令行工具,PC 端开发机使用命令行工具hdc_std进行调试,该工具支持部署在 Windows/Linux/Mac 等系统上与 OpenHarmony 设备(或模拟器)进行连接调试通信。
官方或者社区链接下载均可,压缩包里包含 Windows 和 Linux 两个版本。
下载链接①:
https://repo.huaweicloud.com/harmonyos/os/3.2-Release/ohos-sdk-windows_linux-public.tar.gz
下载链接③:
访问:每日构建 | OpenHarmony CI ,在 CICD 的每日构建中找到 ohos_sdk,下载最新版本。
下载后解压,进入目录 ohos-sdk\windows,继续解压 toolchains-windows 开头的压缩包。
在解压后的 toolchains-windows 开头的文件夹 \toolchains 目录下,找到 hdc.exe。
配置环境变量,把 hdc.exe 的路径配置到 path 里。
验证下 HDC 是否安装成功,使用查看版本的命令
hdc -v
可以看到 HDC 安装成功了。
4、连接电脑和开发板
在开发板断电情况下按住烧录键,通过双USB数据线连接电脑和开发板,再给开发板通电,此时开发板进入烧录模式。
5、下载OpenHarmony镜像
访问:每日构建 | OpenHarmony CI ,在 CICD 的每日构建中找到 dayu200,下载最新版本。
6、烧录OpenHarmony系统
在镜像下载完成后,我们需要导入镜像配置到烧录工具中。右键 Loader 导入配置,选择解压的镜像包中的 config.cfg 文件。导入新配置后,misc、sys-prod、chip-prod三个分区不存在镜像,烧写时不能勾选。点击执行,出现下载完成,即表示烧录成功。
烧录完成后,我们给板子断电重插,板子开机进入OpenHarmony系统页面。
开机完成后,可以看到 OpenHarmony 自带的系统应用。
到此,OpenHarmony 系统烧录到开发板的步骤完成。
四、连接开发板调试应用
1、下载OpenHarmony的SDK
DevEco-Studio 与 OpenHarmony 系统联调,需要下载 OpenHarmony 的 SDK。如果之前下载过的只需要导入路径就可以,没有下载过的可以在 DevEco Studio 里直接下载。
我们先打开 DevEco Studio 的设置。
给 OpenHarmony-SDK 添加路径,或者直接下载 OpenHarmony 的 SDK。
这里我是没安装过,所以直接下载。
大概两分钟,下载进度条走到头,我们的 OpenHarmony-SDK 就安装完成了。
2、连接开发设备与开发板
我们给开发板接好电源,连接显示器和鼠标,然后USB连接我们的电脑。
连接成功后,DevEco-Studio 上方可以看到我们的设备名,如果线没有插好,则还是显示 No Devices。
3、设置项目签名
我们需要为项目设置签名,才可以和开发板进行联调。
连接设备,上方出现设备名后(图截早了,应该是显示设备名),点击右上角项目结构按钮。选择签名设置,进入签名设置页面。
签名设置里勾选,自动生成签名。
如果没有登录华为云开发者账号,会提示我们需要先登录。
点击登录,会自动弹出浏览器,用华为账号登录即可。
登录完成,返回我们的 DevEco Studio 客户端。
4、启动DevEco-Studio项目
点击运行按钮即可。
可以看到我们的开发板自动安装并运行了刚刚开发好的 HarmonyOS 应用。
APP在首页上也有显示。
至此,我成功完成了 OpenHarmony 环境的部署、应用的开发、开发板烧录和生产设备联调的过程,希望本文可以对大家开发中遇到的困难进行答疑解惑。