以往 Android 僅支援 4 KB 的記憶體頁面大小， 最佳化系統記憶體效能 通常 Android 裝置都有這樣的功能。從 Android 15 開始，Android 開放原始碼計畫會支援 已設定頁面大小為 16 KB (16 KB) 的裝置 裝置)。如果應用程式直接使用任何 NDK 程式庫 或者間接透過 SDK 來重建應用程式， 支援這些 16 KB 裝置
隨著裝置製造商持續開發數量更多 實體記憶體 (RAM)，這類裝置中有許多 16 KB ( ，以便最佳化裝置效能。正在新增 網頁大小支援 16 KB 頁面大小的裝置，可讓您的應用程式在這些裝置上執行 ，有助應用程式享有相關效能 如未重新編譯，應用程式可能無法在 16 KB 裝置上運作 。
為協助您為應用程式添加支援服務，我們提供了指南說明 如果您的應用程式受到影響，您可以瞭解如何 重新建構應用程式 (如適用)，以及如何在 使用模擬器的 16 KB 環境 (包括 Android 15) Android Emulator 的系統映像檔)。
優點和效能提升
以 16 KB 頁面大小設定的裝置平均會耗用較多記憶體，但系統和應用程式也能獲得各種效能改善：
- 系統面臨記憶體壓力時，應用程式啟動時間越短：平均低 3.16%，部分受測的應用程式還大幅改善 (最多提升 30%)
- 應用程式啟動期間的耗電量降幅：平均減少 4.56%
- 相機啟動速度更快：熱啟動速度平均快了 4.48%，冷啟動速度平均快了 6.60%
- 縮短系統啟動時間：縮短 8% (平均約 950 毫秒)
這些改善項目是根據初步測試結果而來，實際裝置上的結果可能會有所不同。我們會在持續測試的過程中，針對應用程式可能獲得的效益提供額外分析。
確認應用程式是否受到影響
如果應用程式使用任何原生程式碼，則應重新建構應用程式，以支援 16 KB 裝置。如果您不確定應用程式是否使用原生程式碼，可以使用 APK 分析工具來判斷是否存在原生程式碼，然後檢查所找到的任何共用程式庫的 ELF 區段是否對齊。
如果應用程式只使用以 Java 程式設計語言或 Kotlin 編寫的程式碼 (包括所有程式庫或 SDK)，則應用程式已可支援 16 KB 裝置。不過，我們建議您在 16 KB 環境中測試應用程式，確認應用程式行為不會出現任何意外的回歸現象。
應用程式是否使用原生程式碼？
如果符合下列任一條件，即表示應用程式使用原生程式碼：
- 應用程式使用任何 C/C++ (原生) 程式碼。如果應用程式使用 Android NDK，則表示應用程式使用原生程式碼。
- 您的應用程式會連結使用這些程式庫或依附元件 (例如 SDK) 的任何第三方原生程式庫。
- 您的應用程式是由使用裝置原生資料庫的第三方應用程式建構工具建構。
使用 APK 分析工具找出原生資料庫
APK 分析工具可用來多方評估已建構的 APK。如要檢查應用程式是否使用原生程式碼 (無論是否支援 16 KB)，請按照下列步驟操作：
- 開啟 Android Studio，然後依序點選「File」>「Open」，然後選擇任何專案。
在選單列中，依序按一下「Build」>「Analyze APK...」
選擇要分析的 APK。
查看
lib資料夾，查看有否代管共用物件 (.so) 檔案。如果有任何共用物件檔案，表示應用程式使用原生程式碼。如果沒有共用物件檔案或lib資料夾，則表示應用程式未使用原生程式碼。
檢查共用程式庫的 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 Manager 或
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 裝置的應用程式
如果應用程式使用原生程式碼，請完成下列各節所述步驟，確保應用程式支援 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 裝置需要使用 16 KB ELF 對齊方式，正確對齊共用程式庫的 ELF 區段，才能執行應用程式。
遊戲開發人員：如果遊戲是使用 Unity 遊戲引擎執行，請參閱 Unity 指南。如果您的遊戲是使用 Unreal 遊戲引擎執行，請參閱 Unreal 指南。如需使用原生遊戲引擎，請繼續參閱本指南。
如要使用 16 KB ELF 對齊方式編譯應用程式，請根據您使用的 Android NDK 版本，完成下列任一節中的步驟。
Android NDK r28 以上版本
NDK 版本 r28 以上版本預設會編譯 16 KB 對齊。
Android NDK r27
如要支援使用 Android NDK 7 以上版本編譯 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 連結器存在錯誤，因此必須設定 common-page-size=16384。不過，我們強烈建議您將工具更新至較新的版本，以便完全避免這些錯誤。
如要使用 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常數或程式碼邏輯中的例項，並假設裝置的頁面大小為 4 KB (4096)。找出需要使用頁面對齊引數的
mmap()和其他 API 的用法，並視需要以其他方法取代。
在某些情況下，如果應用程式使用 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 裝置的應用程式後，建議您在 16 KB 環境中測試應用程式，看看應用程式是否會發生任何回歸現象。如要採用這種方式，請按照下列步驟進行：
設定下列其中一個測試環境：
啟動測試裝置，然後執行下列指令，確認裝置使用 16 KB 環境：
adb shell getconf PAGE_SIZE這個指令應傳回
16384值。執行下列
zipalign指令，確認應用程式是否已對齊 16 KB，其中 APK_NAME 是應用程式 APK 檔案的名稱：zipalign -c -P 16 -v 4 APK_NAME.apk請徹底測試應用程式，並著重於變更參照特定頁面大小的程式碼例項可能受到影響的任何部分。
使用 16 位元 Android 15 系統映像檔設定 Android Emulator
如要使用 Android Emulator 設定 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 頁面大小 ARM 64 v8a 版系統映像檔
- Google API 實驗性 16 KB 頁面大小 Intel x86_64 Atom 系統映像檔
依序按一下「Apply」>「OK」，即可下載所選系統映像檔。
按照步驟設定 Android 15 的虛擬裝置，當系統提示您選取系統映像檔時，請選取您下載的 16 KB 系統映像檔。如果系統未自動建議，您可以在「Other Images」分頁中找到 16 KB 的系統映像檔。
適用於部分模擬器版本和系統映像檔的額外步驟
針對 Android Emulator 35.1.5 至 35.1.20 版，以及 SDK Manager 提供的 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 Emulator 和虛擬裝置設定後，請從目標裝置選單或從指令列啟動模擬器。
使用開發人員選項在裝置上啟用 16 KB 模式
切換「Boot with 16KB page size」 開發人員選項，以 16 KB 模式啟動裝置。
從 Android 15 QPR1 開始，您可以使用特定裝置上的開發人員選項，以 16 KB 模式啟動裝置，並執行裝置端測試。使用開發人員選項前，請依序前往「設定」->「系統」->「軟體更新」，然後套用任何可用的更新。
這個開發人員選項適用於下列裝置：
Pixel 8 和 8 Pro (搭載 Android 15 QPR1 以上版本)
警告：由於已知的 Android 15 QPR2 Beta 版 3 問題，在安裝 Android 15 QPR2 Beta 版 3 並以 16 KB 模式啟動裝置後，Pixel 8 裝置的觸控螢幕就無法運作。這項問題不會影響 Pixel 8 Pro 裝置。
Pixel 8a (搭載 Android 15 QPR1 以上版本)
警告：由於已知的 Android 15 QPR2 Beta 版 3 問題，在安裝 Android 15 QPR2 Beta 版 3 並以 16 KB 模式啟動裝置後，Pixel 8a 裝置上的觸控螢幕就無法運作。
Pixel 9、Pixel 9 Pro 和 Pixel 9 Pro XL (搭載 Android 15 QPR2 Beta 2 以上版本)
Google Play 相容性規定
由於裝置製造商會為裝置配備更多 RAM 來提升效能，因此許多裝置都會採用較大的頁面大小，例如 16 KB。為了準備推出這些即將推出的裝置，Google Play 自 2025 年 11 月 1 日起，針對所有新應用程式和現有應用程式更新，以及鎖定 Android 15 以上版本裝置的應用程式，推出相容性規定，要求支援 16 KB 分頁大小。
如要進一步瞭解相容性規定，請參閱這篇網誌文章。