使用本地真机运行应用
==========

在本地真机中运行HarmonyOS应用/元服务，可以采用USB连接方式或者无线连接方式。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ae/v3/ebrIauSMS6ueE_PEBK8goA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=F808CA08B22155FEB81A532D462C137E88997B2BCD81C3CF29DC189673BD6444)

Wearable设备仅支持无线连接方式（Lite Wearable设备不支持）。

#### 前提条件

*   确保设备系统版本升级到[HarmonyOS NEXT Developer Beta1](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/overview-500#section849861583816)或以上。
*   在真机设备上查看**设置 > 系统**中开发者选项是否存在，如果不存在，可在**设置 > _具体的设备名称_**中，连续七次单击**软件版本**，直到提示“开启开发者选项”，点击**确认开启**后输入PIN码（如果已设置），设备将自动重启，请等待设备完成重启。
*   在设备运行应用/元服务需要根据[配置调试签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)章节，提前对应用/元服务进行签名。

#### 使用USB连接方式

1.  使用USB方式，将真机设备与PC端进行连接。
2.  在**设置 > 系统 > 开发者选项**中，打开**USB调试**开关（确保设备已连接USB）。
3.  在真机设备中会弹出“允许USB调试”的弹框，单击**允许**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f0/v3/Z_QVEwnNTL-Nv84XWwctmQ/zh-cn_image_0000002625074723.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=C0F8E614BA97AAA47FCDDC292377263084671BEE26CABAD1733BC7C279AA99F1)
    
4.  在菜单栏中，单击**Run>Run'模块名称'**或![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/Yb4VDo0eRVmHsfLaNH_3_A/zh-cn_image_0000002594475222.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=5C0D9DE8F35A1C8EA6723E83879EE8799D0D877832B67DB9A9B9BE5068368D51)，或使用默认快捷键**Shift+F10**（macOS为**Control+R**）运行应用/元服务。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e5/v3/tMnIEGTWTaeyE4XcQ1WClQ/zh-cn_image_0000002594635152.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=76EF164CDE162E1B67C26E7C65670EE510C5A6D6CE0E1B83228896B34FFF5C7E)
    
5.  DevEco Studio启动HAP的编译构建和安装。安装成功后，设备会自动运行安装的HarmonyOS应用/元服务。

#### \[h2\]使用设备连接助手排查问题

从DevEco Studio 5.1.1 Beta1版本开始，设备连接后，如果DevEco Studio无法识别到设备，显示“No Devices”，可使用设备连接助手来排查问题。点击设备下拉框，并点击**Troubleshoot Device Connections**打开该功能，分为三个步骤，每个步骤排查完后点击**Next**排查下一个。

1.  **通过USB连接设备：**根据界面提示，使用USB连接设备后，点击**Rescan Devices**按钮，扫描已连接的设备，确保扫描结果中包含待调试的设备。
2.  **启用USB调试：**根据界面提示，确保设备系统版本正确，并且启用开发者选项和USB调试。
3.  **重启HDC服务：**如果DevEco Studio仍然无法识别设备，点击**Restart hdc Service**按钮重启HDC服务，重启后HDC会重新识别设备。如果重启后仍识别不到设备，请参考[设备连接后，无法识别设备的处理指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-app-debugging-3)或[如何解决设备无法识别问题](https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-performance-analysis-kit-32)。

#### 使用无线连接方式

1.  将真机设备和PC连接到同一WLAN网络。
2.  在**设置 > 系统 >** **开发者选项**中，打开**无线调试**或**通过WLAN调试**（Wearable设备）开关，并获取设备端的IP地址和端口号。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/33/v3/_3KiMvbnSXyD_q6Z3PPU-Q/zh-cn_image_0000002594635148.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=CE50801388B82141528171F76FF6373890F7CD95067E44AA705584E02E304350 "点击放大")
    
3.  连接设备，有两种方式。
    
    *   在DevEco Studio菜单栏中，单击**Tools > IP Connection**，输入连接设备的IP地址和端口号，单击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/12/v3/OZ0Kji6rQX2sK7tBPvnmGQ/zh-cn_image_0000002625074721.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=396C6BA379B76542ED428D2AD4F40D1D177649865C3B0008209508C25958537C)，连接正常后，设备状态为**online**。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9b/v3/R6vPF1zMS5SkfZzGbBfhUw/zh-cn_image_0000002625074727.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=8A9D66C2BA945634FE1043609AD7D5C531C703E72874B0ADB8F86253AB4F0E55)
        
    *   执行hdc命令，关于hdc工具的使用指导请参考[hdc](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hdc)。
        
        hdc tconn _设备IP地址:端口号_
        
    
4.  在菜单栏中，单击**Run>Run'模块名称'**或![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e3/v3/D7IDYIKeRqGFjvpzECEzmQ/zh-cn_image_0000002594635146.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=1DFB9C314D52CE88276C4B665C45055E744EA7181EB0E56D3535B6150B21AA47)，或使用默认快捷键**Shift+F10**（macOS为**Control+R**）运行应用/元服务。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4c/v3/OzfChBPNQv-LZcqnEru9PA/zh-cn_image_0000002594475224.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=B0803BEEAAAC70F63F5E16D51BDAEC18E06B0B2713F509392DDA3B6D3F136A56)
    
5.  DevEco Studio启动HAP的编译构建和安装。安装成功后，设备会自动运行安装的HarmonyOS应用/元服务。