目录

Native应用运行ABI配置报错问题排查

Q：在启动调试或运行C++应用/服务时，安装HAP出现错误，提示“error: install parse native so failed”错误信息，或者运行时提示“TypeError：Cannot read property xxx of undefined”错误。

A：该问题可能是由于设备支持的ABI类型与C++工程中配置的ABI类型不匹配导致，请通过如下步骤进行解决。

典型场景：

从4.1.3.400版本开始，abiFilters字段缺省配置为"arm64-v8a"，将默认只编译arm64-v8a一种ABI，若设备不支持64位ABI，构建出的包将无法运行在设备上，请根据设备支持的ABI，在build-profile.json5中的buildOption/externalNativeOptions内手动配置abiFilters的值。

// HarmonyOS工程
"buildOption": {
  "externalNativeOptions": {
    "abiFilters": ["arm64-v8a", "x86_64"]
  },
}
// OpenHarmony工程
"buildOption": {
  "externalNativeOptions": {
    "abiFilters": ["arm64-v8a", "x86_64", "armeabi-v7a"]
  },
}
  • 如果工程有依赖HSP或者HAR模块，请确保所有包含C++代码的模块配置的ABI类型包含设备支持的ABI类型。
  • 如果工程依赖的三方库包含so文件，请确保oh_modules/三方库/libs目录包含有设备支持的ABI目录，如libs/arm64-v8a、/libs/x86_64。
  • 对于HarmonyOS应用，在DevEco Studio NEXT Developer Beta1（5.0.3.200）及以上版本不支持编译armeabi-v7a架构的so文件。

通用场景：

  1. 将设备与DevEco Studio进行连接。
  2. 打开命令行终端，并进入hdc目录：DevEco Studio安装__目录/sdk/default/openharmony/toolchains。
  3. 执行如下命令，查询设备支持的ABI列表，返回结果为default/armeabi/arm64-v8a/x86/x86_64中的一个或多个ABI类型。
    hdc shell
param get const.product.cpu.abilist
  1. 根据查询返回结果，检查模块级build-profile.json5文件中的“abiFilters”参数中的配置，规则如下：
    • 若返回结果为default，请执行如下命令，查询是否存在lib64文件夹。
      cd /system/
ls

      • 存在lib64文件夹：则“abiFilters”参数中需要包含arm64-v8a类型。

      • 不存在lib64文件夹：则“abiFilters”参数中需要包含armeabi类型。

    • 若返回结果为armeabi/arm64-v8a/x86/x86_64中的一个或多个，需要在“abiFilters”参数中至少包含返回结果中的一个ABI类型。