harmony 鸿蒙常见问题

  • 2025-06-12
  • 浏览 (3)

常见问题

编译或运行时无法找到头文件

问题现象

编译或运行时提示“usb/usb_ddk_api.h not found”、“hid/hid_ddk_api.h not found” 等。

解决措施

  • 编译时报错:请确认OpenHarmony版本,是否为最新版本。
  • 运行时报错:请确认设备的版本是否为4.1 Release及以上。

安装HAP时提示版本不匹配

问题现象

安装HAP时提示 “compileSdkVersion and releaseType of the app do not match the apiVersion and releaseType on the device”。

解决措施

请根据参考信息提供的对应关系,检查设备系统版本是否匹配

参考信息

接口类型 支持的最小API 对应OpenHarmony版本
应用开发接口(ArkTS接口) API10 4.0 Release及以上
USB DDK接口 API10 4.0 Release及以上
HID DDK接口 API11 4.1 Release及以上
USB Serial DDK接口 API18 5.1 Release及以上
SCSI Peripheral DDK接口 API18 5.1 Release及以上

安装HAP时提示解析本地so文件失败

问题现象

安装HAP时提示”code:9568347 error: install parse native so failed”。

解决措施

根据应用调试中提供的解决方法,在build-profile.json5中的buildOption/externalNativeOptions内手动配置abiFilters的值。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Driver Development Kit(驱动开发服务)

harmony 鸿蒙Driver Development Kit简介

harmony 鸿蒙开发无UI界面基础驱动

harmony 鸿蒙环境准备

harmony 鸿蒙开发带UI界面基础驱动

harmony 鸿蒙开发适用HID协议的设备驱动

harmony 鸿蒙开发使用SCSI协议的设备驱动

harmony 鸿蒙扩展外设驱动开发术语

harmony 鸿蒙开发适用USB协议的设备驱动

harmony 鸿蒙开发适用串口协议的设备驱动

0  赞