OpenHarmony开发-连接开发板调试应用 原创 精华

Damon小智
发布于 2024-4-12 17:36
浏览
1收藏

在 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环境变量” 。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

后面一直Next,直到安装完成。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

安装完需要对电脑重启。 


2、安装 Node.js 和 ohpm

首次运行 DevEco Studio 会来到这个页面。
HarmonyOS 应用开发需要我们的电脑上安装 Node.js 和 ohpm (鸿蒙生态三方库的包管理工具)
这里华为官方提供了镜像,如果本机上之前没有装过,直接勾选 install 然后下一步即可。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区


3、安装HarmonyOS SDK

基础组件安装后,我们需要安装 HarmonyOS 的 SDK。HarmonyOS SDK 提供应用及服务开发所需的一系列系统开放能力,包括框架、Ability、分布式服务、安全、方舟编译器、HMS Core、基础软件服务、硬件服务等。

这里选择安装路径即可,我直接默认路径,点击下一步。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

这个页面展示了所有需要安装的包,点击下一步安装。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

几分钟后安装完成。


二、开发OpenHarmony应用

前面我们已经介绍了如何从零到一开发一款HarmonyOS应用,这里只做简单回顾,详细流程参考我之前的文章:​​HarmonyOS应用开发-使用低代码快速开发一个应用​

1、创建Stage模式应用

创建时,我们需要选择模型,模型有两种,一种是FA模型,一种是Stage模型。API 8及以前的接口基于FA模型提供;从API 9开始,OpenHarmony主推Stage模型。这里我们使用Stage模式创建,并勾选低代码开发模式。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

创建好之后,我们进入项目开发界面。


2、低代码开发应用

参考我之前文章的步骤,很快我们就可以使用低代码做出一个简单应用。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

代码完成后,我们可以使用DevEco Studio自带的模拟器进行调试。

添加模拟设备,然后点击启动。 

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

模拟器调试效果如下:

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区HarmonyOS应用开发-搭建开发环境-鸿蒙开发者社区

确保我们的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)​

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

下载完成后进行安装。

① 安装RK驱动助手

双击安装程序,选择驱动安装,安装完成后电脑连接开发板时才可以识别。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

② 安装AndroidTool烧录工具

选择安装路径安装,安装完成后打开如下,在没有连接设备时显示 No Devices Found。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区


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​

下载链接②:
​developtools_hdc_standard: Device debug connector that provides the device connection capability and a command line tool | 设备调试连接器,提供了连接设备的能力,并提供了对外的命令行工具​

下载链接③:
访问:​​每日构建 | OpenHarmony CI​

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

下载后解压,进入目录 ohos-sdk\windows,继续解压 toolchains-windows 开头的压缩包。

在解压后的 toolchains-windows 开头的文件夹 \toolchains 目录下,找到 hdc.exe。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

配置环境变量,把 hdc.exe 的路径配置到 path 里。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

验证下 HDC 是否安装成功,使用查看版本的命令

hdc -v

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

可以看到 HDC 安装成功了。


4、连接电脑和开发板

在开发板断电情况下按住烧录键,通过双USB数据线连接电脑和开发板,再给开发板通电,此时开发板进入烧录模式。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区


5、下载OpenHarmony镜像

访问:​​每日构建 | OpenHarmony CI​

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区


6、烧录OpenHarmony系统

在镜像下载完成后,我们需要导入镜像配置到烧录工具中。右键 Loader 导入配置,选择解压的镜像包中的 config.cfg 文件。导入新配置后,misc、sys-prod、chip-prod三个分区不存在镜像,烧写时不能勾选。点击执行,出现下载完成,即表示烧录成功。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

烧录完成后,我们给板子断电重插,板子开机进入OpenHarmony系统页面。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

开机完成后,可以看到 OpenHarmony 自带的系统应用。 

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区OpenHarmony开发-系统烧录-鸿蒙开发者社区

到此,OpenHarmony 系统烧录到开发板的步骤完成。


四、连接开发板调试应用

1、下载OpenHarmony的SDK

DevEco-Studio 与 OpenHarmony 系统联调,需要下载 OpenHarmony 的 SDK。如果之前下载过的只需要导入路径就可以,没有下载过的可以在 DevEco Studio 里直接下载。

我们先打开 DevEco Studio 的设置。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

给 OpenHarmony-SDK 添加路径,或者直接下载 OpenHarmony 的 SDK。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

这里我是没安装过,所以直接下载。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

大概两分钟,下载进度条走到头,我们的 OpenHarmony-SDK 就安装完成了。


2、连接开发设备与开发板

我们给开发板接好电源,连接显示器和鼠标,然后USB连接我们的电脑。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

连接成功后,DevEco-Studio 上方可以看到我们的设备名,如果线没有插好,则还是显示 No Devices。


3、设置项目签名 

我们需要为项目设置签名,才可以和开发板进行联调。

连接设备,上方出现设备名后(图截早了,应该是显示设备名),点击右上角项目结构按钮。选择签名设置,进入签名设置页面。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

签名设置里勾选,自动生成签名。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

如果没有登录华为云开发者账号,会提示我们需要先登录。 

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

点击登录,会自动弹出浏览器,用华为账号登录即可。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

登录完成,返回我们的 DevEco Studio 客户端。


4、启动DevEco-Studio项目

点击运行按钮即可。

可以看到我们的开发板自动安装并运行了刚刚开发好的 HarmonyOS 应用。

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

APP在首页上也有显示。 

OpenHarmony开发-连接开发板调试应用-鸿蒙开发者社区

至此,我成功完成了 OpenHarmony 环境的部署、应用的开发、开发板烧录和生产设备联调的过程,希望本文可以对大家开发中遇到的困难进行答疑解惑。


©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
4
收藏 1
回复
举报
2条回复
按时间正序
/
按时间倒序
红叶亦知秋
红叶亦知秋

官方提供的工具越来越方便了

回复
2024-4-12 17:45:47
麻辣香锅配馒头
麻辣香锅配馒头

真是超级详细

回复
2024-5-13 14:45:08
回复
    相关推荐