目录

使用本地真机运行应用

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

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

前提条件

使用USB连接方式

  1. 使用USB方式，将真机设备与PC端进行连接。
  2. 在设置 > 系统 > 开发者选项中，打开USB调试开关（确保设备已连接USB）。
  3. 在真机设备中会弹出“允许USB调试”的弹框，单击允许。

  4. 在菜单栏中，单击Run>Run '模块名称'或，或使用默认快捷键Shift+F10（macOS为Control+R）运行应用/元服务。

  5. DevEco Studio启动HAP的编译构建和安装。安装成功后，设备会自动运行安装的HarmonyOS应用/元服务。

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

从DevEco Studio 5.1.1 Beta1版本开始，设备连接后，如果DevEco Studio无法识别到设备，显示No Devices或No Available Devices，可使用设备连接助手来排查问题。

DevEco Studio 6.1.1 Release及以上版本

单击运行或调试按钮可直接打开设备连接助手，也可以单击设备下拉框，并单击Troubleshoot Device Connections打开该功能。

开发者可以查看到设备的状态，根据界面提示初步排查问题，也可以尝试单击Restart hdc重启hdc服务，重新识别设备。

如果重启后仍识别不到设备，请参考真机设备识别常见问题。

DevEco Studio 6.1.1 Release以下版本

单击设备下拉框，并单击Troubleshoot Device Connections打开该功能，分为三个步骤，每个步骤排查完后单击Next排查下一个。

  1. 通过USB连接设备：根据界面提示，使用USB连接设备后，点击Rescan Devices按钮，扫描已连接的设备，确保扫描结果中包含待调试的设备。
  2. 启用USB调试：根据界面提示，确保设备系统版本正确，并且启用开发者选项和USB调试。
  3. 重启hdc服务：如果DevEco Studio仍然无法识别设备，单击Restart hdc Service按钮重启hdc服务，重启后hdc会重新识别设备。如果重启后仍识别不到设备，请参考真机设备识别常见问题。

使用无线连接方式

  1. 将真机设备和PC连接到同一WLAN网络。
  2. 在设置 > 系统 > 开发者选项中，打开无线调试或通过WLAN调试（Wearable设备）开关，并获取设备端的IP地址和端口号。

  3. 连接设备，有两种方式。

    • 通过DevEco Studio连接。
      • 6.1.1 Release及以上版本：单击菜单栏Tools > IP Connection，或者在设备下拉列表单击IP Connection，按照IP:port格式输入设备的IP地址和端口号，单击Connect连接设备，连接成功后会显示在列表中，默认开启屏幕常亮。

        开启屏幕常亮后，DevEco Studio会持续向设备发送亮屏指令，使设备屏幕常亮。即使手动将设备锁屏，屏幕也会自动亮起，这是DevEco Studio为保持屏幕常亮而发送亮屏指令的正常行为。

        如需退出屏幕常亮，有以下方式：

        • 方式一：在IP Connection面板中单击Disable Screen Always-On。
        • 方式二：断开设备连接。

        退出后，DevEco Studio将停止发送亮屏指令，设备可正常进入休眠。

      • 6.1.1 Release以下版本：单击菜单栏Tools > IP Connection，输入连接设备的IP地址和端口号，单击，连接正常后，设备状态为online。

    • 通过hdc连接，关于hdc工具的使用指导请参考hdc。
      hdc tconn 设备IP地址:端口号

  4. 在菜单栏中，单击Run>Run'模块名称'或，或使用默认快捷键Shift+F10（macOS为Control+R）运行应用/元服务。

  5. DevEco Studio启动HAP的编译构建和安装。安装成功后，设备会自动运行安装的HarmonyOS应用/元服务。

[h2]使用Wearable设备运行Lite Wearable应用

从26.0.1版本开始，DevEco Studio支持将Lite Wearable应用推包到支持双模式（全能模式和省电模式，在设置 > 双模式管理中查看）的Wearable设备上运行，但不支持调试。

在Wearable设备上运行时，仅支持手动签名。在获取签名需要的调试Profile时，可通过命令hdc shell hidumper -s 4606 -a "-b hybrid mcuUdid"获取设备的UDID。