本文同步发表于我的微信公众号，微信搜索 程语新视界 即可关注，每个工作日都有文章更新

一、运行前准备

1.1 设备系统要求

• 设备系统必须升级到 HarmonyOS NEXT Developer Beta1 或以上版本

1.2 开启开发者选项

操作步骤：

1. 进入设备 设置

2. 找到 具体的设备名称 或 系统 选项

3. 连续七次单击"软件版本"

4. 直到提示"开启开发者选项"

5. 点击确认开启（如需PIN码则输入）

1.3 应用签名要求

• 在真机运行前必须对应用/元服务进行签名

• 参考官网链接：为应用/元服务进行签名

二、USB连接方式运行应用

2.1 连接步骤

1. 物理连接：使用USB数据线将真机设备与PC连接

2. 开启USB调试：

   • 进入 设置 > 系统 > 开发者选项

   • 打开 "USB调试" 开关

3. 授权确认：设备弹出"允许USB调试"对话框，点击 "允许"

2.2 运行应用

三种启动方式：

1. 菜单栏：Run > Run '模块名称'

2. 工具栏：点击运行图标（通常为三角形）

3. 快捷键：

   • Windows/Linux: Shift + F10

   • macOS: Control + R

2.3 运行结果

• DevEco Studio 自动启动 HAP的编译构建和安装

• 安装成功后，设备自动运行安装的HarmonyOS应用/元服务

三、设备连接问题排查

3.1 设备连接助手

适用情况：设备连接后DevEco Studio显示"No Devices"

开启方式：

1. 点击设备下拉框

2. 选择 "Troubleshoot Device Connections"

3.2 三步排查流程

步骤一：检查USB连接

• 使用USB连接设备

• 点击 "Rescan Devices" 按钮重新扫描

• 确保扫描结果中包含待调试设备

步骤二：验证USB调试设置

• 确认设备系统版本符合要求

• 确保已开启开发者选项和USB调试

步骤三：重启HDC服务

• 点击 "Restart hdc Service" 按钮重启HDC服务

• HDC服务重启后会重新识别设备

四、无线调试连接方式

4.1 网络环境准备

• 将真机设备和PC连接到同一WLAN网络

4.2 设备端设置

1. 进入 设置 > 系统 > 开发者选项

2. 打开 "无线调试" 开关（Wearable设备为"通过WLAN调试"）

3. 记录设备显示的IP地址和端口号

4.3 连接设备（两种方式）

方式一：通过DevEco Studio界面连接

1. 菜单栏：Tools > IP Connection

2. 输入设备的 IP地址 和 端口号

3. 点击连接图标（通常为插头形状）

4. 连接成功后设备状态显示为 "online"

方式二：通过hdc命令连接

hdc tconn 设备IP地址:端口号

4.4 运行应用

连接成功后，使用以下任一方式运行：

• 菜单栏：Run > Run '模块名称'

• 工具栏：点击运行图标

• 快捷键：

  • Windows/Linux: Shift + F10

  • macOS: Control + R

4.5 运行结果

• DevEco Studio 自动完成 HAP编译构建和安装

• 安装成功后设备自动运行应用/元服务