原生移动开发 / 系统课时

控制 ABI 与包体积

控制 ABI 与包体积

当应用或第三方 SDK 带有 Native .so 库时,ABI 会直接决定哪些设备能加载这些库,也会明显影响 APK/AAB 的体积。本节用 Release 构建配置控制架构与无用资源,并验证最终产物里真正包含了哪些 Native 文件。

学习目标

  • 理解 arm64-v8a、armeabi-v7a 等 ABI 与 Native 库目录的对应关系。
  • 能根据发布方式选择 ABI 过滤、AAB 按设备拆分和资源收缩策略。
  • 能构建 Release 产物并检查包内的 Native 库是否符合预期。

ABI 为什么会改变包体积

Kotlin/Java 代码主要运行在 Android Runtime 上,不需要为每种 CPU 架构各放一份;但 NDK 代码和部分第三方 SDK 会携带 .so。这些库通常按 lib/<abi>/ 分目录打包,同一个功能若同时提供四种 ABI,就可能出现四份 Native 二进制。

设备只能加载兼容自身 ABI 的 Native 库。缺少目标架构时,应用可能无法安装,或在真正调用 JNI/Native 功能时出现加载失败。因此,删 ABI 不是单纯“压缩文件”,而是在改变设备支持范围。

ABI 与 Native 库交付关系

先决定发布方式,再决定是否过滤

如果主要通过 Google Play 发布 AAB,通常应优先保留产品承诺支持的 ABI,让商店按设备配置生成和交付匹配的 APK。这样用户不会因为包中存在其他 ABI 就下载全部 Native 库,没必要为了“看起来更小”而随意砍掉仍需支持的架构。

如果直接分发 APK,单个通用 APK 会同时携带多个 ABI 的 .so,体积更敏感。此时可以生成按 ABI 拆分的 APK;而 abiFilters 更适合明确缩小支持范围,例如产品已经决定只支持 ARM 设备。

在 Release 构建里控制 ABI 与无用资源

下面是 app/build.gradle.kts 的片段示例,假设产品明确只支持两种 ARM ABI,并且 Release 已允许 R8 和资源收缩:

kotlin
android {
    defaultConfig {
        ndk {
            abiFilters += listOf("arm64-v8a", "armeabi-v7a")
        }
    }

    buildTypes {
        getByName("release") {
            isMinifyEnabled = true
            isShrinkResources = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
}

abiFilters 不会把缺失架构的 .so 自动转换出来,它只限制参与打包的 ABI。isShrinkResources 用于移除经代码收缩后确认未使用的资源,因此必须用 Release 场景完整回归,特别关注反射、动态资源名和第三方 SDK。

如果你仍要支持 x86/x86_64 设备或测试环境,就不要仅为了体积删除它们;先以实际设备覆盖范围和依赖支持情况为依据。

构建并检查最终 AAB

先生成 Release AAB,再查看包内 Native 目录。下面命令假设模块名为 app,且产物位于 Gradle 默认输出目录:

bash
./gradlew :app:bundleRelease
unzip -Z1 app/build/outputs/bundle/release/app-release.aab | grep '^base/lib/'

预期输出:

text
BUILD SUCCESSFUL in <TIME>
base/lib/arm64-v8a/<LIBRARY>.so
base/lib/armeabi-v7a/<LIBRARY>.so

<TIME> 和 <LIBRARY> 会随环境与依赖变化。若应用完全没有 Native 库,第二条命令可能没有匹配项;若出现计划外 ABI,则继续检查直接依赖、传递依赖以及各模块自己的 NDK 配置。

判断优化是否真的有效

不要只比较文件名或压缩包大小。对 AAB,应确认目标设备最终获得的 APK 集是否只包含匹配 ABI;对直接 APK,应比较通用包与按 ABI 拆分包的实际大小,同时确认仍覆盖目标设备。

体积优化的底线是“不改变承诺支持的设备和功能”。先让 ABI 支持范围与产品目标一致,再启用资源收缩并用 Release 产物验证,才能避免为了几 MB 把兼容性一起删掉。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制 ABI 与包体积

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通