摆脱线缆束缚！HarmonyOS无线调试与本地真机运行全攻略_鸿蒙系统无线调试

目录

一、引言

二、前期必备条件

2.1 开启设备开发者模式

2.2 应用 / 服务签名

三、无线调试环境配置

3.1 确保设备与 PC 处于同一网络

3.2 开启无线调试开关并获取 IP 和端口

四、配置 hdc 环境变量（重点）

4.1 Windows 系统配置步骤

4.2 MacOS 系统配置步骤

四、使用命令连接设备

4.1 执行连接命令

4.2 常见问题及解决

五、在本地真机运行应用 / 服务

5.1 在 DevEco Studio 中运行

5.2 运行结果查看

六、总结

一、引言

在 HarmonyOS 开发的旅程中，大家或许都有过这样的困扰：每次调试应用，都要被一根数据线束缚，不仅活动范围受限，还可能因为接口松动、数据线损坏等问题，耗费大量时间排查，严重影响开发效率。比如，在会议室进行项目展示和调试时，拖着数据线会显得十分不便，破坏演示的流畅性；又或者在多个设备间切换调试时，频繁插拔数据线，不仅麻烦，还可能损坏设备接口。

而无线调试的出现，就像是为开发者打开了一扇新的大门。它让我们摆脱了数据线的物理束缚，只要设备处于同一网络环境，就能轻松实现调试。同时，本地真机运行应用，能让我们更真实地感受应用在实际设备上的性能表现，及时发现并解决潜在问题。那么，如何在 HarmonyOS 中开启这一便捷的无线调试连接方式，实现本地真机运行应用 / 服务呢？接下来，就跟着我一步步探索吧 。

二、前期必备条件

2.1 开启设备开发者模式

在使用无线调试之前，我们首先要开启设备的开发者模式。以 Phone 或 Tablet 为例，具体步骤如下：

1. 打开设备的 “设置” 应用。

1. 在设置中找到 “关于手机” 或 “关于设备” 选项，点击进入。

1. 在关于手机页面中，找到 “版本号”，连续点击 7 次（不同设备可能点击次数略有差异，一般为 5 - 7 次）。此时，系统会提示 “您现在是开发者” 或 “已开启开发者选项” 。

1. 输入设备的 PIN 码（如果已设置），完成身份验证。

1. 设备将自动重启，请耐心等待设备完成重启。

开启开发者模式后，我们就可以访问一系列高级设置和调试选项，为后续的无线调试做好准备。不过需要注意的是，开发者模式中的部分设置可能会影响设备的稳定性和安全性，非必要情况下，不要随意更改不熟悉的选项。

2.2 应用 / 服务签名

签名是 HarmonyOS 应用开发中不可或缺的一环，它就像是应用的 “身份证”，用于确保应用的完整性和来源可靠性 。当我们在本地真机上运行应用 / 服务时，同样需要对其进行签名。

签名的大致流程如下：

1. 生成密钥和证书请求文件：可以通过 DevEco Studio 或命令行工具来生成。密钥存储在格式为.p12 的密钥库文件中，证书请求文件格式为.csr ，包含了公钥和一些公共信息。

1. 申请调试数字证书和调试 Profile 文件：将生成的证书请求文件提交到 AppGallery Connect，申请调试所需的数字证书（.cer 文件）和 Profile 文件（.p7b 文件）。数字证书由华为 AppGallery Connect 颁发，Profile 文件则包含了应用的包名、数字证书信息、权限列表以及允许调试的设备列表等内容。

1. 配置签名信息到工程中：将生成的密钥文件、数字证书文件和 Profile 文件配置到 DevEco Studio 工程中，完成签名配置。

如果你的应用需要使用受限开放权限，从 DevEco Studio 4.0 Release 版本起，在调测阶段可以通过自动签名快速申请。但在申请前，请务必审视是否符合受限权限的使用场景，因为当前仅少量符合特殊场景的应用可在通过审批后使用受限权限。涉及受限权限的应用，在上架时，应用市场（AGC）将根据应用的使用场景审核是否可以使用对应的受限权限，如不符合，应用的上架申请将被驳回。 如果你还未完成应用 / 服务的签名，建议提前按照上述流程进行操作，以免影响后续的无线调试和真机运行。

三、无线调试环境配置

3.1 确保设备与 PC 处于同一网络

要实现 HarmonyOS 设备的无线调试，首先得确保设备与 PC 处于同一网络环境。这就好比让两个人在同一个房间里交流，才能保证信息的顺畅传递 。具体操作很简单，你只需检查设备和 PC 是否连接到同一个 WLAN

美容知识