> 技术文档 > 鸿蒙5应用真机调试超详细教程_鸿蒙5.0adb调试方法教程图片

鸿蒙5应用真机调试超详细教程_鸿蒙5.0adb调试方法教程图片


一、开发环境准备

  1. 工具安装

    • 下载 DevEco Studio 5.0.7+ 并安装(需预留至少15GB磁盘空间)
    • 配置 HarmonyOS 5.0 SDK 与 ArkTS Compiler(安装时勾选对应组件)
    • 验证JDK版本(需JDK 11+):
    java -version
  2. 项目创建

    • 选择 Empty Ability 模板,配置参数:
      • Language:ArkTS
      • Compile SDK:HarmonyOS 5.0
      • Device Type:Phone

二、真机调试配置

1. 设备准备

  1. 开启开发者模式:

    • 进入手机 设置 > 关于手机,连续点击 版本号 7次
    • 返回 系统和更新 > 开发人员选项,开启 USB调试 和 USB安装
  2. 连接设备:

    • 通过USB线连接电脑,首次连接需在手机端授权 允许USB调试

2. 签名配置

  1. 自动签名(推荐新手):

    • 在DevEco Studio中依次点击 File > Project Structure > Project > Signing Configs
    • 勾选 Automatically generate signing,系统自动生成调试证书
  2. 手动签名(需华为开发者账号):

    • 通过 Build > Generate Key and CSR 生成 .p12 和 .csr 文件
    • 在华为开发者平台添加证书并下载 .cer 文件

三、调试流程实战

1. 生成调试包

  1. 配置编译模式:
    • 点击左下角 Ohos Build Variants,选择 debug
  2. 编译HAP包:
    • 通过 Build > Build APP(s)/Hap(s) > Build Hap(s) 生成带签名的调试包

2. 启动调试

  1. 选择目标设备:
    • 设备连接成功后,工具栏显示设备名称(如 HUAWEI NOH-NA00
  2. 运行调试:
    • 点击 Run 按钮部署应用,或点击 Debug 启动断点调试

3. 调试技巧

  1. 断点调试

    • 在代码行号左侧单击设置断点,支持 条件断点 和 日志断点
    • 调试工具栏可查看变量值、调用栈和线程状态
  2. 性能监测

    // 监测CPU使用率console.log(\"CPU使用率:\", performance.getCpuUsage())

四、多设备协同调试

通过分布式能力实现设备联动(示例代码):

import distributedDeviceInfo from \'@kit.DistributedScheduleKit\'@Entry@Componentstruct DeviceCoordinator { @State deviceList: string[] = [] aboutToAppear() { distributedDeviceInfo.getDeviceList().then((devices) => { this.deviceList = devices.map(device => device.deviceName) }) } build() { List({ space: 10 }) { ForEach(this.deviceList, (device: string) => { ListItem() { Text(device).fontSize(18) } }) } }}

五、常见问题解决

  1. 设备无法识别

    • 检查USB驱动是否安装
    • 重启手机开发者模式
  2. 签名失败

    • 确保自动签名配置中未勾选 .p7b证书
    • 验证证书有效期(调试证书默认7天)
  3. HAP安装失败

    • 手机存储空间不足
    • 设备API版本与SDK不匹配

通过本教程,开发者可快速掌握鸿蒙5真机调试全流程。建议结合官方文档与社区资源持续探索高级调试技巧。