OpenHarmony条形码如何调试

在 OpenHarmony 上调试“条形码（Barcode / 扫码）”相关功能，通常分为 系统能力调试、应用层调试 和 硬件/驱动调试 三类。下面按常见场景给你一个实用指南。

一、确认条形码能力来源

OpenHarmony 中条形码一般来自以下之一：

1. Camera + 扫码算法（应用层）

   • 使用 @ohos.multimedia.camera
   • 自己或第三方库做解码（ZXing / ZBar / 自研）

2. 系统扫码服务（如 Scan Kit 类似能力）

   • 标准系统（Standard System）可能提供扫码 API
   • 轻量/小型系统通常没有

3. 外部扫码设备（USB / 串口）

   • 条码枪模拟键盘输入
   • 或自定义驱动上报数据

二、应用层调试（最常见）

1. 打开相机调试日志

hdc shell hilog | grep camera

或只看你的应用：

hdc shell hilog | grep your.app.bundle

2. 检查相机权限

module.json5 中必须有：

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

调试权限是否生效：

hdc shell bm permission get <bundleName>

3. 检查相机是否出帧

在相机回调中加日志：

camera.on('frameArrived', () => {
  console.info('frame arrived');
});

如果没有 frameArrived：

• 相机未打开
• 分辨率不支持
• 被其他应用占用

4. 图像数据是否正确

常见错误：

• YUV 格式错误（NV21 / YV12）
• 图像旋转未处理
• 分辨率太低导致无法识别

调试建议：

console.info(`image size: ${width}x${height}, format: ${format}`);

5. 扫码库调试

如果你用 ZXing / ZBar：

• 先保存一帧图片到本地：

hdc file recv /data/storage/.../test.yuv ./

• 在 PC 上用工具验证是否能识别
• 再确认算法输入是否正确

三、系统 / 驱动层调试（设备厂商）

1. 相机 HAL 日志

hdc shell hilog | grep camera_host
hdc shell hilog | grep camera_device

重点看：

• open camera 是否成功
• stream 是否建立
• 帧率是否正常

2. 外接条码枪（HID）

如果是 USB 条码枪：

hdc shell hidumper -s input

或：

hdc shell getevent

扫码时应有 key event 输出。

3. 串口扫码模块

hdc shell ls /dev/tty*
hdc shell cat /dev/ttyS1

确认：

• 波特率
• 数据格式
• 是否有回车结束符

四、常见问题速查

五、调试工具推荐

• hdc
• hilog
• DevEco Studio 断点
• PC 扫码验证工具
• hidumper

如果你能告诉我：

• OpenHarmony 版本（3.2 / 4.0 / 5.0）
• 是 手机 / 开发板 / 设备
• 用的是 系统扫码 / 自己写 / 外接设备

我可以直接给你更具体的调试步骤或示例代码。