harmony 鸿蒙FAQs

  • 2025-06-06
  • 浏览 (5)

FAQs

Failed to Find the Header File During Compilation or Running

Symptom

The message “usb/usb_ddk_api.h not found” or “hid/hid_ddk_api.h not found” is displayed during compilation or running.

Solution

  • If an error is reported during compilation, check whether the OpenHarmony version is the latest.
  • If an error is reported during running, check whether the device version is 4.1 Release or later.

Version Mismatch Displayed During HAP Installation

Symptom

The message “compileSdkVersion and releaseType of the app do not match the apiVersion and releaseType on the device” is displayed during HAP installation.

Solution

Check whether the system version of the device is correct according to the mapping provided in Version Mapping.

Version Mapping

API Type Minimum API Version OpenHarmony Version
Application development APIs (ArkTS APIs) API10 4.0 Release or later
USB DDK APIs API10 4.0 Release or later
HID DDK APIs API11 4.0 Release or later
USB Serial DDK API API18 5.1 Release or later
SCSI Peripheral DDK API API18 5.1 Release or later

Failed to Parse the Local .so File During HAP Installation

Symptom

The message “code:9568347 error: install parse native so failed” is displayed during HAP installation.

Solution

Configure the value of abiFilters in buildOption/externalNativeOptions in the build-profile.json5 file. For details, see Application Debugging.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Driver Development Kit

harmony 鸿蒙Introduction to Driver Development Kit

harmony 鸿蒙UI-free Driver Development

harmony 鸿蒙Setting Up the Environment

harmony 鸿蒙UI-based Driver Development

harmony 鸿蒙HID DDK Development

harmony 鸿蒙SCSI Peripheral DDK Development

harmony 鸿蒙Terms

harmony 鸿蒙USB DDK Development

harmony 鸿蒙USB Serial DDK Development

0  赞