文档开发者中心
我的
|

HarmonyOS 5

在模拟器安装应用时失败了

在真机上将功能调试正常了,为什么切到模拟器安装时直接失败,换了一个新的工程重新打包,模拟器上仍然报同样的错。

备注:我们这里调试是一个 .so 文件库,这个 .so 编译了 arm64-v8a 架构。

点赞
收藏
回复
3
分享
举报
浏览35 编辑于2026-09-20 02:55北京
全部评论
最多点赞
最新发布
最早发布
|
技术支持
尊敬的开发者,您好,
关于您的反馈的问题,
模拟器运行在 x86_64 架构上,而工程中集成的 .so 库仅编译了 arm64-v8a 架构,两者 ABI 类型不匹配,导致模拟器安装时解析 native so 失败(错误码 9568347)。真机是 ARM 架构设备,与 arm64-v8a 匹配,因此真机安装运行正常。
build-profile.json5 中 abiFilters 字段缺省配置为 arm64-v8a,默认只编译 arm64-v8a 一种 ABI。这也是为什么更换新工程重新打包后仍然报同样的错误——问题不在工程本身,而在 abiFilters 构建配置未包含 x86_64。
解决方法
在模块级 build-profile.json5 的 buildOption.externalNativeOptions 中增加 x86_64 架构:
收起
自动换行
深色代码主题
复制
{
  "buildOption": {
    "externalNativeOptions": {
      "abiFilters": [
        "x86_64",
        "arm64-v8a"
      ]
    }
  }
}
修改后执行 Build > Clean Project 清理缓存,再重新构建 HAP 包。
若该 .so 是第三方提供(非工程内源码编译),需要向 so 提供方获取 x86_64 版本的 so,并在模块 libs 目录下建立 x86_64 子目录放入对应架构的 so 文件。
验证方法
1. 重新构建后,确认构建产物 libs 目录下同时包含 arm64-v8a 和 x86_64 两个子目录。
2. 将 HAP 安装到模拟器,确认安装成功且不再报 9568347 错误。
3. 也可通过命令验证:hdc install xxx.hap,观察是否还出现 install parse native so failed。
注意事项
abiFilters 同时配置 x86_64 和 arm64-v8a 后,构建产物会包含两种架构的 so,包体积相应增大。发布到真机的正式包可按需移除 x86_64,仅在模拟器调试构建时保留。
备选方案
若 .so 无法提供 x86_64 版本(如三方库没有 x86_64 产物),由于模拟器与真机存在架构差异,涉及 native so 的功能建议直接使用真机进行调试测试。
参考文档
- 模拟器设备类型说明:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-devicetype
- 在编译架构中指定 ABI:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ohos-abi

 
展开全部
3楼回复于2026-09-21 08:45 来自广东

这个现象首先查 ABI:只有 arm64-v8a 的 .so 能在 ARM 真机运行,但 x86 模拟器需要 x86_64 版本,换空工程也不会改变三方库的架构。

收起
自动换行
深色代码主题
复制
"externalNativeOptions": {
  "abiFilters": ["arm64-v8a", "x86_64"]
}

这只是构建筛选,前提是你的 CMake/三方库真的能产出 x86_64 so;如果供应方只给 arm64,就只能自行补编 x86_64 或改用 ARM 真机。官方模拟器说明:https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/ide-emulator-devicetype

 

2楼回复于2026-09-21 08:29 来自四川
AI 生成内容,仅供参考

这是一个典型的 .so 文件 CPU 架构与模拟器不兼容的问题。您的 .so 文件只编译了 arm64-v8a 架构,而真机设备使用的是 ARM 架构(arm64),所以真机上可以正常运行。但 HarmonyOS 本地模拟器运行在 x86_64 架构上,模拟器无法加载 arm64-v8a 架构的 .so 文件,因此安装直接失败。换新工程重新打包后问题依旧,是因为根本原因在于 .so 文件本身缺少 x86_64 架构版本,与工程无关。

问题原因详解

HarmonyOS 应用中如果包含 C/C++ 编译的 native 库(.so 文件),这些库需要与目标设备的 CPU 架构匹配:

设备类型 CPU 架构 需要的 .so 架构
真机(手机/平板) ARM 64位 arm64-v8a
本地模拟器 x86 64位 x86_64

从 DevEco Studio 4.1.3.400 版本开始,abiFilters 字段缺省配置为 "arm64-v8a",默认只编译 arm64-v8a 一种 ABI。这意味着如果不手动添加 x86_64,构建出的包将无法在模拟器上运行。

解决方案

方案一:为 .so 文件补充 x86_64 架构(推荐)

如果 .so 文件是您自己通过 CMake 编译的,在模块级 build-profile.json5 文件中配置 abiFilters,同时包含 arm64-v8a 和 x86_64:

收起
自动换行
深色代码主题
复制
{
  "buildOption": {
    "externalNativeOptions": {
      "abiFilters": [
        "arm64-v8a",
        "x86_64"
      ]
    }
  }
}

这样在编译构建时,会同时生成 arm64-v8a 和 x86_64 两种架构的 .so 文件,真机和模拟器都可以正常运行。

方案二:手动放置 x86_64 架构的 .so 文件

如果 .so 文件是外部提供的三方库(非自行编译),需要确保在 libs 目录下同时包含两种架构的 .so 文件:

收起
自动换行
深色代码主题
复制
libs/
├── arm64-v8a/
│   └── libxxx.so    // 真机使用
└── x86_64/
    └── libxxx.so    // 模拟器使用

请向 .so 文件的提供方索取 x86_64 架构版本,放入对应的 libs/x86_64 目录中。

方案三:使用真机调试

如果短期内无法获取 x86_64 架构的 .so 文件,可以直接使用真机进行调试,绕过模拟器架构不兼容的问题。

验证设备支持的架构

可以通过 hdc 命令查询设备(包括模拟器)支持的 ABI 列表,确认目标设备需要哪种架构:

收起
自动换行
深色代码主题
复制
hdc shell param get const.product.cpu.abilist

返回结果会包含 arm64-v8a、x86_64 等一个或多个 ABI 类型,请确保您的 .so 文件至少包含返回结果中的一种架构。

补充说明

  • 如果工程依赖了 HSP 或 HAR 模块,请确保所有包含 C++ 代码的模块配置的 ABI 类型都包含目标设备支持的架构。
  • 对于 HarmonyOS 应用,在 DevEco Studio NEXT Developer Beta1(5.0.3.200)及以上版本不支持编译 armeabi-v7a 架构的 .so 文件,因此模拟器场景下只需关注 arm64-v8a 和 x86_64 两种架构。
  • 如果 .so 文件是三方闭源库且仅提供 arm64-v8a 版本,则该库无法在模拟器上使用,只能通过真机调试。
展开全部
1楼回复于2026-09-21 02:30 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。