ReactNative进阶（三十八）：Android ndk abiFilters 详解

Posted 2021-06-17 No Silver Bullet

• • 一、前言
  • 二、ABI 是什么
  • 三、为何设置ndk的abiFilters
  • 四、如何配置 gardle
  • 五、ABI支持详解
  • 六、支持建议
  • 七、拓展阅读

---

一、前言

android 系统本质是一个经过改造的 Linux 系统，so库是Linux系统上使用的共享库（类似windows上的dll）。最初，Android 系统只支持 ARMv5 的 CPU 构架，随着 Android 系统的发展，又加入了 ARMv7 (2010), x86 (2011), MIPS (2012), ARMv8, MIPS64 和 x86_64 (2014)。每一种 CPU 构架，都定义了一种 ABI（Application Binary Interface），ABI 决定了二进制文件如何与系统进行交互。

二、ABI 是什么

ABI 是 Application Binary Interface （应用二进制界面）的缩写。

不同 Android 手机使用不同的 CPU，因此支持不同的指令集。CPU 与指令集的每种组合都有其自己的应用二进制界面（或 ABI）。 ABI 可以非常精确地定义应用的机器代码在运行时如何与系统交互。 必须为应用要使用的每个 CPU 架构指定 ABI。

典型的 ABI 包含以下信息：

• 机器代码应使用的 CPU 指令集。
• 运行时内存存储和加载的字节顺序。
• 可执行二进制文件（例如程序和共享库）的格式，以及它们支持的内容类型。
• 用于解析内容与系统之间数据的各种约定。这些约定包括对齐限制，以及系统如何使用堆栈和在调用函数时注册。
• 运行时可用于机器代码的函数符号列表 - 通常来自非常具体的库集。

三、为何设置ndk的abiFilters

其实这个可以不设置，这样编译时，就会将项目里所有依赖资源包里的so库都编译到最终的apk里。

但是有些平台，我们是不需要支持的，如果不删除依赖的话，apk就臃肿了。如果那些so库是我们自己编译出来的，那可以直接在工程中删除对应so文件，但是如果是第三方提供的，就不好删除了，所以就需要使用abiFilters来过滤了。

当前市面绝大多数是arm架构的CPU，而且都是V7或V8架构，所以可以保留armeabi或者armeabi-v7a即可。

如果仅保留armeabi-v7a，而有些第三方包未提供v7a的包，则可以将对应armeabi包拷贝到armeabi-v7a。

如果同时保留armeabi和armeabi-v7a，则需要保证两个目录下的so库文件数相同。

四、如何配置 gardle

build.gradle配置信息如下所示：

ndk {
    //设置支持的SO库架构
    abiFilters "armeabi", "armeabi-v7a", "x86_64" //, "arm64-v8a"
}

五、ABI支持详解

ABI	支持的指令集（说明）
armeabi	ARMV5TE 和更高版本 Thumb-1 （ 无硬浮点。）
armeabi-v7a	armeabi、Thumb-2、VFPv3-D16、其他（可选）（与 ARMv5、v6 设备不兼容。）
arm64-v8a	AArch-64
x86	x86 (IA-32)、MMX、SSE/2/3、SSSE3（不支持 MOVBE 或 SSE4。）
x86_64	x86-64、MMX、SSE/2/3、SSSE3、SSE4.1、4.2、POPCNT
mips	MIPS32r1 及更高版本（使用硬浮点，并且假设 CPU:FPU 时钟比率为 2:1 以获取最大兼容性。 不提供 micromips 或 MIPS16。）
mips64	MIPS64r6

六、支持建议

由于处理器架构为armeabi-v7a、arm64-v8a占市场的99%以上的份额，因此我们必须要支持。

Android 处理器架构汇总建议：

• mips (已弃用)
• mips64 (已弃用)
• armeabi (已弃用)
• armeabi-v7a (需要支持— 现在最流行的处理器架构)
• arm64-v8a (需要支持 — armeabi-v7a的新版本)
• x86 (可选, 设备非常有限，可以用于模拟器debugging)
• x86_64 (可选, 设备非常有限，可以用于模拟器debugging)

七、拓展阅读

• ABI