解决 Google Play 提示的 16KB 内存页面大小对齐问题：通过升级 Android Gradle 插件（AGP）

在我最近的工作中，在提交应用到 Google Play 时遇到了一个内存对齐问题 ，提示应用不支持 16KB 内存页面大小 。经过一番排查和尝试，最终通过升级 Android Gradle 插件（AGP）版本解决了问题，具体过程如下。

问题背景

当提交 Android 应用到 Google Play 时，收到了以下错误提示：

我使用官网提供的方式验证 ZIP 对齐方式：通过命令执行

bundletool dump config --bundle=<my .aab>  | grep alignment

执行该命令后，结果如下：

Error while parsing the flags: Syntax error: flags should start with --(|)

目录

错误分析

1. 1. 未压缩共享库 ：这个错误通常与应用中包含的 共享库 （*.so 文件）有关。通常.so 文件需要满足一定的对齐要求，特别是在包含 未压缩的共享库 时，Google Play 要求这些库在 16KB ZIP 对齐边界上对齐。

2. 2. 验证失败 ：运行 bundletool 时出现语法错误，这表明 .aab 文件的 ZIP 对齐方式 存在问题。

3. 解决方案

4. 根据错误提示，问题的核心在于应用中的共享库没有按照 16KB 对齐边界来进行布局。为了解决这个问题，我按照官方提供的方案进行了操作：

1. 升级 Android Gradle 插件（AGP）：

为了解决这一问题，Google 官方推荐将 Android Gradle 插件（AGP） 升级到 8.5.1 或 更高版本。AGP 8.5.1 引入了对共享库在 16KB 内存页面对齐的支持。

步骤：

1. ① 打开 build.gradle 文件

2. ②修改 classpath 部分，确保使用 AGP 版本 8.5.1 或更高版本：

   classpath 'com.android.tools.build:gradle:8.5.1'

2. 更新后重新构建应用：

完成 AGP 升级后，我重新构建了应用，并生成了新的 .aab 文件。

3.验证对齐方式：

使用以下命令验证 .aab 文件的对齐方式：

bundletool dump config --bundle=<my .aab> | grep alignment

验证结果显示为：

"alignment": "PAGE ALIGNMENT_16K"

这意味着新的 .aab 文件已经符合 16KB 对齐要求，并通过了 Google Play 的验证。

总结

这个问题的核心在于 Android 应用中的 共享库 （*.so 文件）没有在 16KB 对齐边界上进行对齐。通过升级 Android Gradle 插件（AGP） 到 8.5.1 或更高版本，成功解决了这个问题。

关键步骤：

1. 升级 AGP 到 8.5.1 或更高版本。

2. 重新构建 .aab 文件。

3. 使用 bundletool 验证文件的对齐方式，确保 alignment 为 PAGE ALIGNMENT_16K。

通过这种方式，我成功解决了这个问题，并顺利提交了更新后的应用。

这篇文章可以帮助其他开发者在遇到类似的 16KB 内存页面对齐问题时，快速定位和解决问题，同时也能帮助大家理解如何通过 AGP 升级 来解决相关的共享库对齐问题。