目录

使用本地真机运行应用

在本地真机中运行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”,可使用设备连接助手来排查问题。点击设备下拉框,并点击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(6.1.1.300)及以上版本:单击菜单栏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(6.1.1.300)以下版本:单击菜单栏Tools > IP Connection,输入连接设备的IP地址和端口号,单击,连接正常后,设备状态为online。

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

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

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