Historically, Android has only supported 4 KB memory page sizes, which has optimized system memory performance for the average amount of total memory that Android devices have typically had. Beginning with Android 15, AOSP supports devices that are configured to use a page size of 16 KB (16 KB devices). If your app uses any NDK libraries, either directly or indirectly through an SDK, then you will need to rebuild your app for it to work on these 16 KB devices.
As device manufacturers continue to build devices with larger amounts of physical memory (RAM), many of these devices will adopt 16 KB (and eventually greater) page sizes to optimize the device's performance. Adding support for 16 KB page size devices enables your app to run on these devices and helps your app benefit from the associated performance improvements. Without recompiling, apps won't work on 16 KB devices in future Android releases.
To help you add support for your app, we've provided guidance on how to check if your app is impacted, how to rebuild your app (if applicable), and how to test your app in a 16 KB environment using emulators (including Android 15 system images for the Android Emulator).
优势和性能提升
配置为使用 16 KB 页面大小的设备平均会使用略多一些的内存，但系统和应用的性能也会得到各种提升：
- 缩短了系统内存压力时的应用启动时间：平均降低了 3.16%；对于我们测试的某些应用而言，改进幅度更大（最高可达 30%）
- 应用启动期间的功耗降低：平均降低了 4.56%
- 相机启动更快：热启动速度平均提高了 4.48%，冷启动速度平均提高了 6.60%
- 缩短了系统启动时间：平均缩短了 8%（约 950 毫秒）
这些改进基于我们的初始测试，实际设备上的结果可能会有所不同。随着测试的继续进行，我们将进一步分析应用的潜在收益。
检查您的应用是否受到影响
If your app uses any native code, then you should rebuild your app with support for 16 KB devices. If you are unsure if your app uses native code, you can use the APK Analyzer to identify whether any native code is present and then check the alignment of ELF segments for any shared libraries that you find. Android Studio also provides features that help you to automatically detect alignment issues.
If your app only uses code written in the Java programming language or in Kotlin, including all libraries or SDKs, then your app already supports 16 KB devices. Nevertheless, we recommend that you test your app in a 16 KB environment to verify that there are no unexpected regressions in app behavior.
您的应用是否使用了原生代码？
如果您的应用符合以下任一情况，则表明其使用了原生代码：
- 您的应用使用了任何 C/C++（原生）代码。如果您的应用使用了 Android NDK，则表明您的应用使用了原生代码。
- 您的应用与使用这些库的任何第三方原生库或依赖项（例如 SDK）相关联。
- 您的应用是通过使用设备上的原生库的第三方应用构建程序构建而成。
使用 APK 分析器识别原生库
APK 分析器是一款可用于对所构建的 APK 进行各方面评估的工具。如需检查您的应用是否使用了原生代码（无论是否兼容 16 KB），请执行以下操作：
- 打开 Android Studio，然后依次点击 File > Open 并选择任意项目。
在菜单栏中，依次点击 Build > Analyze APK...
选择要分析的 APK。
查看
lib文件夹，其中会托管共享对象 (.so) 文件（如有）。如果存在任何共享对象文件，则表明您的应用使用了原生代码。对齐列会针对存在对齐问题的任何文件显示警告消息。如果没有共享对象文件或没有lib文件夹，则表示您的应用未使用原生代码。
通过自动检查检测对齐问题
如果预构建的库或 APK 不符合 16 KB 的要求，Android Studio 会主动发出警告。使用 APK 分析器工具查看哪些库需要更新，或者是否需要进行任何代码更改。
Android Studio 中的 Lint 还会突出显示未按 16 KB 对齐的原生库。
检查共享库的 ELF 段的对齐情况
对于任何共享库，请验证共享库的 ELF 段是否使用 16 KB ELF 对齐方式正确对齐。如果您是在 Linux 或 macOS 上进行开发，则可以使用 check_elf_alignment.sh 脚本，如下一部分中所述。您还可以直接使用命令行工具。
使用 check_elf_alignment.sh 脚本（Linux 或 macOS）
请按照以下步骤使用 check_elf_alignment.sh 脚本检查 ELF 段的对齐情况：
将
check_elf_alignment.sh脚本保存到文件中。对应用的 APK 文件运行脚本：
check_elf_alignment.sh APK_NAME.apk该脚本会针对所有
arm64-v8a共享库输出ALIGNED或UNALIGNED。如果任何
arm64-v8a或x86_64共享库是UNALIGNED，您需要更新这些库的打包，然后重新编译应用，并按照本部分中的步骤重新测试。
直接使用命令行工具
请按照以下步骤直接使用命令行工具检查 ELF 段的对齐情况：
- 确保使用 Android Studio 中的 SDK 管理器或
sdkmanager命令行工具安装 Android SDK Build-Tools 版本 35.0.0 或更高版本以及 Android NDK。 提取应用的 APK 文件：
Linux 或 macOS
unzip APK_NAME.apk -d /tmp/my_apk_outWindows (PowerShell)
Expand-Archive -Path .\APK_NAME.apk -DestinationPath ~\tmp\my_apk_out在您将 APK 文件提取到的临时目录中，检查
lib目录的内容，看看是否有共享对象 (.so) 文件。这些是您在使用 APK 分析器识别原生库时看到的相同共享对象文件。对每个共享对象文件运行以下命令：Linux 或 macOS
SDK_ROOT_LOCATION/Android/sdk/ndk/NDK_VERSION/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-objdump -p SHARED_OBJECT_FILE.so | grep LOADWindows (PowerShell)
SDK_ROOT_LOCATION\Android\sdk\ndk\NDK_VERSION\toolchains\llvm\prebuilt\windows-x86_64\bin\llvm-objdump.exe -p SHARED_OBJECT_FILE.so | Select-String -Pattern "LOAD"其中，
SDK_ROOT_LOCATION是您安装 Android SDK 的目录的路径，SHARED_OBJECT_FILE是您要检查的共享对象文件的名称，NDK_VERSION是您已安装的 Android NDK 的版本（例如28.0.12433566）。对于您检查的每个文件，输出结果将类似于以下内容：LOAD off 0x0000000000000000 vaddr 0x0000000000000000 paddr 0x0000000000000000 align 2**14 LOAD off 0x0000000000042a90 vaddr 0x0000000000043a90 paddr 0x0000000000043a90 align 2**14 LOAD off 0x0000000000046230 vaddr 0x0000000000048230 paddr 0x0000000000048230 align 2**14检查输出行，确保负载段的值不小于
2**14。如果任何加载段的值为2**13、2**12或更低，您需要更新这些库的封装，然后按照本部分中的步骤重新编译应用并重新测试。接下来，对应用的 APK 文件运行
zipalign命令行工具：Linux 或 macOS
SDK_ROOT_LOCATION/Android/sdk/build-tools/35.0.0/zipalign -v -c -P 16 4 APK_NAME.apkWindows (PowerShell)
SDK_ROOT_LOCATION\Android\sdk\build-tools\35.0.0\zipalign.exe -v -c -P 16 4 APK_NAME.apk其中，
SDK_ROOT_LOCATION是您安装 Android SDK 的目录的路径，APK_NAME是您应用的 APK 文件的名称。如果所有共享库都正确对齐，则输出的最后一行将显示“验证成功”。
构建支持 16 KB 设备的 Android 应用
如果您的应用使用原生代码，请完成以下各部分中列出的步骤，以确保您的应用支持 16 KB 设备：
更新共享库的打包方式
我们建议您升级到 AGP 8.5.1 版或更高版本，并使用未压缩的共享库。
AGP 版本 8.5.1 或更高版本
对于随附未压缩共享库的应用，16 KB 设备要求这些共享库在 16 KB ZIP 对齐边界上对齐。为此，您需要升级到 Android Gradle 插件 (AGP) 版本 8.5.1 或更高版本。如需详细了解升级流程，请参阅 Android Gradle 插件升级助理部分。
AGP 版本 8.5 或更低版本
如果您无法将 AGP 升级到 8.5.1 版或更高版本，则可以改用压缩共享库。更新 Gradle 配置，以便 Gradle 在打包应用时压缩共享库，从而避免因共享库未对齐而导致应用安装问题。
Groovy
在 build.gradle 文件中，添加以下选项：
android {
...
packagingOptions {
jniLibs {
useLegacyPackaging true
}
}
}
Kotlin
在 build.gradle.kts 文件中，添加以下选项：
android {
...
packagingOptions {
jniLibs {
useLegacyPackaging = true
}
}
}
使用 16 KB ELF 对齐方式编译应用
16 KB 设备要求共享库的 ELF 段使用 16 KB ELF 对齐方式正确对齐，以便您的应用能够运行。
对于游戏开发者，如果您的游戏基于 Unity 游戏引擎运行，请参阅 Unity 指南。如果您的游戏基于 Unreal 游戏引擎运行，请参阅 Unreal 指南。对于原生游戏引擎，请继续阅读本指南。
如需使用 16 KB ELF 对齐方式编译应用，请根据您使用的 Android NDK 版本完成以下部分中的步骤。
Android NDK r28 及更高版本
NDK 版本 r28 及更高版本默认编译为 16 KB 对齐。
Android NDK r27
为了支持使用 Android NDK 版本 r27 及更高版本编译 16 KB 对齐的共享库，您需要按如下方式更新 ndk-build、build.gradle、build.gradle.kts 或链接器标志：
ndk-build
在 Application.mk 中：
APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true
Groovy
在 build.gradle 文件中，设置实参 -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON：
android {
...
defaultConfig {
...
// This block is different from the one you use to link Gradle
// to your CMake or ndk-build script.
externalNativeBuild {
// For ndk-build, instead use the ndkBuild block.
cmake {
// Passes optional arguments to CMake.
arguments "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
}
}
}
}
Kotlin
在 build.gradle.kts 文件中，设置实参 -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON：
android {
...
defaultConfig {
...
// This block is different from the one you use to link Gradle
// to your CMake or ndk-build script.
externalNativeBuild {
// For ndk-build, instead use the ndkBuild block.
cmake {
// Passes optional arguments to CMake.
arguments += listOf("-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON")
}
}
}
}
其他构建系统
指定以下链接器标志：
-Wl,-z,max-page-size=16384
Android NDK r26 及更低版本
如需支持使用 Android NDK 版本 r26 或更低版本编译 16 KB 对齐的共享库，您需要按如下方式更新 ndk-build 或 cmake 配置：
ndk-build
更新 Android.mk 以启用 16 KB ELF 对齐：
LOCAL_LDFLAGS += "-Wl,-z,max-page-size=16384"
CMake
更新 CMakeLists.txt 以启用 16 KB ELF 对齐：
target_link_options(${CMAKE_PROJECT_NAME} PRIVATE "-Wl,-z,max-page-size=16384")
Android NDK r22 及更低版本
除了 NDK r26 及更低版本中所述的步骤之外，如果您使用的是 NDK r22 或更低版本，还必须设置 common-page-size=16384。由于 GNU ld 和 LLVM lld 链接器的早期版本存在 bug，因此需要设置 common-page-size=16384。不过，我们强烈建议您将工具更新到较新版本，以完全避免这些 bug。
如需使用 Android NDK 版本 r22 或更低版本编译 16 KB 兼容的共享库，请按如下方式更新 ndk-build 或 cmake 配置：
ndk-build
更新 Android.mk 以构建 16 KB 兼容的 ELF：
LOCAL_LDFLAGS += "-Wl,-z,max-page-size=16384"
LOCAL_LDFLAGS += "-Wl,-z,common-page-size=16384"
CMake
更新 CMakeLists.txt 以构建 16 KB 兼容的 ELF：
target_link_options(${CMAKE_PROJECT_NAME} PRIVATE "-Wl,-z,max-page-size=16384")
target_link_options(${CMAKE_PROJECT_NAME} PRIVATE "-Wl,-z,common-page-size=16384")
修复代码并解决运行时问题
即使您的应用已对齐到 16 KB，如果代码中的某些位置假定设备使用的是特定页面大小，您的应用仍可能会遇到错误。为避免这种情况，请完成以下步骤：
在某些情况下，如果您的应用使用 PAGE_SIZE 作为与底层页面大小无关的便捷值，那么在 16 KB 模式下使用时，这不会导致应用崩溃。不过，如果使用 mmap 将此值传递给内核，而不使用 MAP_FIXED，内核仍会使用整个页面，从而浪费一些内存。出于这些原因，在 NDK r27 及更高版本上启用 16 KB 模式时，PAGE_SIZE 是未定义的。
如果您的应用以这种方式使用 PAGE_SIZE，并且从不直接将此值传递给内核，那么请创建一个具有新名称的新变量，以反映它用于其他目的，而不是反映真实的内存页，而不是使用 PAGE_SIZE。
检查 SDK 是否支持 16 KB
许多 SDK 都与 16 KB 页面大小兼容，尤其是当您自行构建这些 SDK 或获取最新的预构建版本时。不过，由于某些 SDK 预构建版本或 SDK 版本与 16 KB 不兼容，您应查看每个 SDK 提供商的网站，以确定哪个版本可与 16 KB 搭配使用。
在 16 KB 环境中测试应用
构建支持 16 KB 设备的 app 后，您需要在 16 KB 环境中测试该 app，看看它是否出现任何回归问题。为此，请按以下步骤操作：
设置以下测试环境之一：
启动测试设备，然后运行以下命令，验证该设备是否使用 16 KB 环境：
adb shell getconf PAGE_SIZE该命令应返回
16384的值。运行以下
zipalign命令，验证您的应用是否按 16 KB 边界对齐，其中 APK_NAME 是应用 APK 文件的名称：zipalign -c -P 16 -v 4 APK_NAME.apk全面测试您的应用，重点关注可能受到更改引用特定页面大小的代码实例影响的任何方面。
使用基于 16 KB 的 Android 15 系统映像设置 Android 模拟器
如需使用 Android 模拟器设置 16 KB 环境，请按以下步骤操作：
基于 16 KB 的 Android 15 模拟器系统映像与 Android Studio Jellyfish | 2023.3.1 或更高版本兼容。不过，为了在处理 16 KB 设备时获得最佳体验，请使用 Android Studio Ladybug | 2024.2.1 或更高版本。
我们一直在努力开发新功能，因此建议您在有新版本或 Android Studio 最新预览版时下载。
请注意，您可以保留已安装的现有 Android Studio 版本，因为您可以并行安装多个版本。
在 Android Studio 中，依次点击 Tools > SDK Manager。
在 SDK Platforms 标签页中，勾选 Show Package Details，然后展开 Android VanillaIceCream 或更高版本部分，并根据要创建的虚拟设备选择以下一个或两个模拟器系统映像：
- Google APIs Experimental 16 KB Page Size ARM 64 v8a 系统映像
- Google APIs 实验性 16 KB 页面大小 Intel x86_64 Atom 系统映像
点击应用 > 确定，下载所选的系统映像。
按照步骤为 Android 15 设置虚拟设备，并在系统提示选择系统映像时，选择您下载的 16 KB 系统映像。如果系统未自动推荐，您可以在其他映像标签页中找到 16 KB 的系统映像。
针对某些模拟器版本和系统映像的额外步骤
对于 Android 模拟器版本 35.1.5 到 35.1.20，以及 SDK 管理器中提供的 Android 15.0 16 KB 页面大小系统映像的修订版 4 之前，若要在 x86_64 系统上模拟 16 KB 环境，您还需要完成以下步骤。在版本 35.1.21 之后，以及在 Android 15.0 16 KB 页面大小系统映像的修订版 4 或更高版本中，无需执行这些步骤。
- 在设备管理器中，点击 16 KB 映像旁边的 3 个点，然后点击在磁盘上显示。
- 在此文件夹中，找到
config.ini文件。 将以下行添加到
config.ini文件中，然后保存更改：kernel.parameters = androidboot.page_shift=14如需验证更改，请运行以下命令，该命令应返回
16384：adb shell getconf PAGE_SIZE
启动模拟器
完成 Android 模拟器和虚拟设备的设置后，从目标设备菜单或从命令行启动模拟器。
Enable 16 KB mode on a device using developer options
Toggle the Boot with 16KB page size developer option to boot a device in 16 KB mode.
Starting with Android 15 QPR1, you can use the developer option that's available on certain devices to boot the device in 16 KB mode and perform on-device testing. Before using the developer option, go to Settings > System > Software updates and apply any updates that are available.
This developer option is available on the following devices:
Pixel 8 and 8 Pro (with Android 15 QPR1 or higher)
Pixel 8a (with Android 15 QPR1 or higher)
Pixel 9, 9 Pro, and 9 Pro XL (with Android 15 QPR2 Beta 2 or higher)
Google Play 兼容性要求
随着设备制造商为设备配备更多 RAM 以优化性能，许多制造商将采用更大的页面大小（例如 16 KB）。为了迎接这些即将推出的设备，Google Play 推出了一项新的兼容性要求：自 2025 年 11 月 1 日起，提交到 Google Play 且以搭载 Android 15（API 级别 35）及更高版本的设备为目标平台的所有新应用和现有应用更新都必须支持 16 KB 的页面大小。
如需详细了解此兼容性要求，请参阅这篇博文。