在我最近的工作中,在提交应用到 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. 未压缩共享库 :这个错误通常与应用中包含的 共享库 (
*.so文件)有关。通常.so文件需要满足一定的对齐要求,特别是在包含 未压缩的共享库 时,Google Play 要求这些库在 16KB ZIP 对齐边界上对齐。 -
2. 验证失败 :运行
bundletool时出现语法错误,这表明.aab文件的 ZIP 对齐方式 存在问题。 -
根据错误提示,问题的核心在于应用中的共享库没有按照 16KB 对齐边界来进行布局。为了解决这个问题,我按照官方提供的方案进行了操作:
1. 升级 Android Gradle 插件(AGP):
为了解决这一问题,Google 官方推荐将 Android Gradle 插件(AGP) 升级到 8.5.1 或 更高版本。AGP 8.5.1 引入了对共享库在 16KB 内存页面对齐的支持。
步骤:
-
① 打开
build.gradle文件 -
②修改
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 或更高版本,成功解决了这个问题。
关键步骤:
-
升级 AGP 到 8.5.1 或更高版本。
-
重新构建
.aab文件。 -
使用
bundletool验证文件的对齐方式,确保alignment为 PAGE ALIGNMENT_16K。
通过这种方式,我成功解决了这个问题,并顺利提交了更新后的应用。
这篇文章可以帮助其他开发者在遇到类似的 16KB 内存页面对齐问题时,快速定位和解决问题,同时也能帮助大家理解如何通过 AGP 升级 来解决相关的共享库对齐问题。