OpenHarmony应用怎样调试

在 OpenHarmony 上调试应用，常见方式分为 本地模拟器 / 真机调试、日志查看、断点调试 和 性能调试。下面按“从入门到常用”给你梳理。

一、开发环境准备

推荐使用：

• DevEco Studio（OpenHarmony 版）
• SDK：对应 OpenHarmony API 版本
• 工具：hdc（HarmonyOS Device Connector）

安装完成后，确认：

hdc version

能正常输出版本号。

二、运行与调试方式

1️⃣ 使用模拟器调试（推荐入门）

适用：快速验证 UI 和逻辑

步骤：

1. DevEco Studio → Device Manager
2. 创建 OpenHarmony 模拟器（Phone / Tablet）
3. 选择模拟器 → Run / Debug

优点：

• 不需要真机
• 支持断点调试

2️⃣ 真机调试（推荐正式开发）

适用：系统能力、硬件相关功能

步骤：

1. 打开开发者模式
   • 设置 → 关于 → 连续点击“版本号”
2. 开启：
   • USB 调试
   • 允许 hdc 调试
3. 连接电脑
4. 查看设备：

hdc list targets

5. DevEco Studio 选择真机 → Run

三、日志调试（最常用）

1️⃣ 使用 hilog

OpenHarmony 专用日志系统

import hilog from '@ohos.hilog';

hilog.info(0x0000, 'MyTag', 'value = %{public}d', 123);

查看日志：

hdc shell hilog

过滤：

hdc shell hilog | grep MyTag

2️⃣ 常用日志命令

# 清屏
hdc shell hilog -c

# 看某应用
hdc shell hilog -T 包名

# 导出日志
hdc shell hilog > log.txt

四、断点调试（DevEco Studio）

1. 在 .ts / .ets 文件左侧打 breakpoint
2. 选择 Debug 模式运行
3. 支持：
   • 单步执行
   • 查看变量
   • 调用栈

✅ 支持 ArkTS / JS / C++（NDK）

五、UI 调试

1️⃣ Layout Inspector

DevEco Studio：

• Tools → Layout Inspector
• 查看组件树、属性、布局层级

2️⃣ 常见问题

• 组件不显示 → 检查宽高 / 父容器
• 点击事件无效 → 检查 .onClick

六、性能调试

1️⃣ SmartPerf（系统工具）

用于：

• CPU
• 内存
• 帧率
• 启动耗时

2️⃣ DevEco Profiler

• 函数耗时
• 渲染性能
• JS 执行分析

七、常见问题排查

❌ 设备不识别

hdc kill
hdc start

❌ 安装失败

hdc install app.hap

❌ 权限问题

在 module.json5 中配置：

"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  }
]

八、调试建议总结

✅ 新手：模拟器 + hilog
✅ 正式：真机 + 断点
✅ 性能：Profiler
✅ 系统问题：hdc + log

如果你愿意，我可以：

• 给你 具体 API 版本的调试示例
• 讲 ArkTS 断点调试实战
• 或针对 某个报错信息 帮你分析

你现在是 模拟器还是真机调试？