从历史上看,Android 仅支持 4 KB 内存页面大小,这优化了系统内存性能,以适应 Android 设备通常拥有的平均总内存量。从 Android 15 开始,AOSP 支持配置为使用 16 KB 页面大小的设备(16 KB 设备)。如果您的应用直接或通过 SDK 间接使用任何 NDK 库,则需要重新构建应用,才能在这些 16 KB 设备上运行。
随着设备制造商不断制造出具有更大物理内存 (RAM) 的设备,许多此类设备将采用 16 KB(最终甚至更大)的页面大小来优化设备性能。添加对 16 KB 页面大小设备的支持,可让您的应用在这些设备上运行,并帮助您的应用受益于相关的性能改进。如果不重新编译,应用将无法在未来 Android 版本的 16 KB 设备上运行。
为帮助您为应用添加支持,我们提供了相关指南,介绍了如何检查应用是否受到影响、如何重新构建应用(如果适用),以及如何使用模拟器(包括 Android 模拟器的 Android 15 系统映像)在 16 KB 环境中测试应用。
היתרונות ושיפורי הביצועים
配置为使用 16 KB 页面大小的设备平均会使用略多一些的内存,但系统和应用的性能也会得到各种提升:
- 缩短了系统内存压力时的应用启动时间:平均降低了 3.16%;对于我们测试的某些应用而言,改进幅度更大(最高可达 30%)
- 应用启动期间的功耗降低:平均降低了 4.56%
- 相机启动更快:热启动速度平均提高了 4.48%,冷启动速度平均提高了 6.60%
- 缩短了系统启动时间:平均缩短了 8%(约 950 毫秒)
这些改进基于我们的初始测试,实际设备上的结果可能会有所不同。随着测试的继续进行,我们将进一步分析应用的潜在收益。
איך בודקים אם האפליקציה מושפעת
如果您的应用使用了任何原生代码,则应重新构建应用,使其支持 16 KB 设备。如果您不确定自己的应用是否使用了原生代码,可以使用 APK 分析器来确定是否存在任何原生代码,然后检查您找到的任何共享库的 ELF 段对齐情况。Android Studio 还提供了一些功能,可帮助您自动检测对齐问题。
如果您的应用仅使用以 Java 或 Kotlin 编程语言编写的代码(包括所有库或 SDK),则该应用已支持 16 KB 设备。不过,我们建议您在 16 KB 环境中测试应用,以验证应用行为是否出现意外的回归。
האם האפליקציה שלך משתמשת בקוד מקורי?
האפליקציה שלך משתמשת בקוד מקורי אם אחד מהתנאים הבאים מתקיים:
- האפליקציה שלך משתמשת בקוד C/C++ (קוד מקורי). אם האפליקציה שלכם משתמשת ב-Android NDK, היא משתמשת בקוד מקורי.
- האפליקציה שלך מקשרת לספריות או לתלות של צד שלישי (כמו ערכות SDK) שמשתמשות בהן.
- האפליקציה שלך נוצרה על ידי כלי לפיתוח אפליקציות של צד שלישי שמשתמש בספריות Native במכשיר.
זיהוי ספריות Native באמצעות הכלי לניתוח APK
APK Analyzer הוא כלי שמאפשר להעריך היבטים שונים של קובץ APK בנוי. כדי לבדוק אם האפליקציה משתמשת בקוד Native (גם אם היא תואמת לדפים בגודל 16 KB):
- פותחים את Android Studio, לוחצים על File > Open (קובץ > פתיחה) ובוחרים פרויקט כלשהו.
בסרגל התפריטים, לוחצים על Build > Analyze APK...
בוחרים את קובץ ה-APK שרוצים לנתח.
בודקים בתיקייה
lib
אם יש קבצים של אובייקטים משותפים (.so
). אם יש קבצי אובייקט משותפים, האפליקציה משתמשת בקוד מקורי. בעמודה התאמה מוצגות הודעות אזהרה לגבי קבצים שבהם יש בעיות בהתאמה. אם אין קבצים של אובייקטים משותפים או שאין תיקייה בשםlib
, סימן שהאפליקציה לא משתמשת בקוד מקורי.
זיהוי בעיות התאמה באמצעות בדיקות אוטומטיות
אם הספריות או קובצי ה-APK שנוצרו מראש לא עומדים בדרישות של 16 KB, מוצגת אזהרה ב-Android Studio. משתמשים בכלי APK Analyzer כדי לבדוק אילו ספריות צריך לעדכן או אם נדרשים שינויים בקוד.

כלי Lint ב-Android Studio גם מדגיש ספריות Native שלא מיושרות ל-16 KB.

בדיקת ההתאמה של פלחי ELF בספריות משותפות
בספריות משותפות, צריך לוודא שפלח ה-ELF של הספריות המשותפות מיושר בצורה נכונה באמצעות יישור ELF של 16KB. אם אתם מפתחים ב-Linux או ב-macOS, אתם יכולים להשתמש בסקריפט check_elf_alignment.sh
כמו שמתואר בקטע הבא. אפשר גם להשתמש ישירות בכלי שורת הפקודה.
שימוש בסקריפט check_elf_alignment.sh (Linux או macOS)
כדי לבדוק את ההתאמה של פלחי ELF באמצעות הסקריפט check_elf_alignment.sh
:
שומרים את הסקריפט
check_elf_alignment.sh
בקובץ.מריצים את הסקריפט בקובץ ה-APK של האפליקציה:
check_elf_alignment.sh APK_NAME.apk
הפלט של הסקריפט הוא
ALIGNED
אוUNALIGNED
לכלarm64-v8a
הספריות המשותפות.אם יש ספריות משותפות מסוג
arm64-v8a
אוx86_64
שהןUNALIGNED
, תצטרכו לעדכן את האריזה של הספריות האלה, ואז לקמפל מחדש את האפליקציה ולבדוק אותה מחדש לפי השלבים שמופיעים בקטע הזה.
שימוש ישיר בכלי שורת הפקודה
כדי לבדוק את ההתאמה של פלחי ELF באמצעות כלים של שורת הפקודה ישירות:
- מוודאים שגרסה 35.0.0 ואילך של Android SDK Build-Tools ו-Android NDK מותקנים באמצעות SDK Manager ב-Android Studio או באמצעות כלי שורת הפקודה
sdkmanager
. מחפשים את קובץ ה-APK של האפליקציה:
Linux או macOS
unzip APK_NAME.apk -d /tmp/my_apk_out
Windows (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 LOAD
Windows (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
או פחות, צריך לעדכן את האריזה של הספריות האלה, ואז לקמפל מחדש את האפליקציה ולבדוק אותה מחדש לפי השלבים שמופיעים בקטע הזה.לאחר מכן, מריצים את כלי שורת הפקודה
zipalign
בקובץ ה-APK של האפליקציה:Linux או macOS
SDK_ROOT_LOCATION/Android/sdk/build-tools/35.0.0/zipalign -v -c -P 16 4 APK_NAME.apk
Windows (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
אם האפליקציה שלך משתמשת בקוד Native, צריך לבצע את השלבים שמפורטים בקטעים הבאים כדי לוודא שהאפליקציה תומכת במכשירים עם דפי זיכרון בגודל 16 KB:
- עדכון האריזה של הספריות המשותפות
- הידור האפליקציה באמצעות יישור ELF בגודל 16 KB
- תיקון קוד ופתרון בעיות בזמן ריצה
- בדיקה של ערכות SDK לתמיכה ב-16 KB
עדכון האריזה של הספריות המשותפות
מומלץ לשדרג ל-AGP בגרסה 8.5.1 ואילך ולהשתמש בספריות משותפות לא דחוסות.
גרסה 8.5.1 ומעלה של AGP
במכשירים עם 16KB, אפליקציות שמופצות עם ספריות משותפות לא דחוסות צריכות להיות מיושרות בגבול של 16KB ב-zip. כדי לעשות את זה, צריך לשדרג לגרסה 8.5.1 ואילך של Android Gradle Plugin (AGP). פרטים על תהליך השדרוג מופיעים בקטע כלי השדרוג של הפלאגין של Android Gradle.
AGP מגרסה 8.5 ומטה
אם אי אפשר לשדרג את AGP לגרסה 8.5.1 ואילך, אפשרות חלופית היא לעבור לשימוש בספריות משותפות דחוסות. כדי למנוע בעיות בהתקנת האפליקציה בגלל ספריות משותפות לא מיושרות, צריך לעדכן את ההגדרה של Gradle כך ש-Gradle ידחס את הספריות המשותפות כשיוצרים חבילת אפליקציה.
מגניב
מוסיפים את האפשרות הבאה לקובץ build.gradle
:
android {
...
packagingOptions {
jniLibs {
useLegacyPackaging true
}
}
}
Kotlin
מוסיפים את האפשרות הבאה לקובץ build.gradle.kts
:
android {
...
packagingOptions {
jniLibs {
useLegacyPackaging = true
}
}
}
הידור האפליקציה באמצעות יישור ELF בגודל 16 KB
כדי שהאפליקציה תפעל במכשירים עם 16 KB, צריך ליישר את פלחי ה-ELF של הספריות המשותפות בצורה נכונה באמצעות יישור ELF של 16 KB.
מפתחי משחקים שמשתמשים במנוע המשחק Unity יכולים לעיין במדריך Unity. אם המשחק שלכם פועל על מנוע המשחק Unreal, כדאי לעיין במדריך של Unreal. אם אתם משתמשים במנועי משחקים מקוריים, אתם יכולים להמשיך עם המדריך הזה.
כדי להדר את האפליקציה באמצעות יישור ELF בגודל 16KB, צריך לבצע את השלבים באחד מהקטעים הבאים, בהתאם לגרסה של Android NDK שבה אתם משתמשים.
Android NDK r28 ואילך
ב-NDK מגרסה r28 ואילך, ההידור מיושר ל-16 KB כברירת מחדל.
Android NDK r27
כדי לתמוך בהידור של ספריות משותפות בגודל 16 KB באמצעות Android NDK בגרסה r27 ואילך, צריך לעדכן את ndk-build
, build.gradle
, build.gradle.kts
או את דגלי ה-linker באופן הבא:
ndk-build
ב-Application.mk
:
APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true
מגניב
בקובץ 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")
}
}
}
}
מערכות build אחרות
מציינים את דגלי ה-linker הבאים:
-Wl,-z,max-page-size=16384
Android NDK r26 ומטה
כדי לתמוך בהידור של ספריות משותפות עם יישור של 16 KB באמצעות Android NDK בגרסה r26 או בגרסאות מוקדמות יותר, צריך לעדכן את ההגדרות של ndk-build
או cmake
באופן הבא:
ndk-build
כדי להפעיל יישור ELF בגודל 16 KB, צריך לעדכן את Android.mk
:
LOCAL_LDFLAGS += "-Wl,-z,max-page-size=16384"
CMake
כדי להפעיל יישור ELF בגודל 16 KB, צריך לעדכן את CMakeLists.txt
:
target_link_options(${CMAKE_PROJECT_NAME} PRIVATE "-Wl,-z,max-page-size=16384")
Android NDK r22 ומטה
בנוסף לשלב שמתואר עבור NDK r26 ומטה, צריך להגדיר את common-page-size=16384
אם משתמשים ב-NDK r22 ומטה. ההגדרה
common-page-size=16384
נדרשת בגלל באגים בגרסאות קודמות של מקשרים GNU ld ו-LLVM lld. עם זאת, מומלץ מאוד לעדכן את כלי הפיתוח לגרסה עדכנית יותר כדי להימנע מהבאגים האלה לחלוטין.
כדי להדר ספריות משותפות שתואמות ל-16 KB באמצעות Android NDK בגרסה r22 או בגרסאות מוקדמות יותר, צריך לעדכן את ההגדרה של ndk-build
או cmake
באופן הבא:
ndk-build
מעדכנים את Android.mk
כדי ליצור קובץ ELF שתואם לדפים בגודל 16 KB:
LOCAL_LDFLAGS += "-Wl,-z,max-page-size=16384"
LOCAL_LDFLAGS += "-Wl,-z,common-page-size=16384"
CMake
מעדכנים את CMakeLists.txt
כדי ליצור קובץ ELF שתואם לדפים בגודל 16 KB:
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
).במקום זאת, צריך להשתמש ב-
getpagesize()
או ב-sysconf(_SC_PAGESIZE)
.מחפשים שימושים ב-
mmap()
ובממשקי API אחרים שדורשים ארגומנטים שתואמים לדף, ומחליפים אותם בחלופות במקומות שבהם זה נדרש.
במקרים מסוימים, אם האפליקציה משתמשת בערך PAGE_SIZE
כערך נוח שלא קשור לגודל הדף הבסיסי, השימוש בערך הזה במצב 16 KB לא יגרום לאפליקציה להפסיק לפעול. עם זאת, אם הערך הזה מועבר לליבה עם mmap
בלי MAP_FIXED
, הליבה עדיין משתמשת בדף שלם, מה שגורם לבזבוז של חלק מהזיכרון. לכן, PAGE_SIZE
לא מוגדר כשמצב 16KB מופעל ב-NDK r27 ומעלה.
אם האפליקציה שלכם משתמשת ב-PAGE_SIZE
בצורה הזו ואף פעם לא מעבירה את הערך הזה ישירות לליבת המערכת, במקום להשתמש ב-PAGE_SIZE
, צריך ליצור משתנה חדש עם שם חדש כדי לשקף את העובדה שהוא משמש למטרות אחרות ולא משקף דף זיכרון אמיתי.
בדיקה של ערכות SDK לתמיכה ב-16 KB
הרבה ערכות SDK תואמות לגודלי דפים של 16 KB, במיוחד אם אתם בונים אותן בעצמכם או אם אתם מקבלים גרסאות עדכניות מוכנות מראש. עם זאת, יש גרסאות או קבצים מוכנים מראש של SDK שלא תואמים ל-16 KB, ולכן כדאי לבדוק באתר של כל ספק SDK כדי לדעת באיזו גרסה להשתמש עם 16 KB.
בדיקת האפליקציה בסביבה של 16 KB
אחרי שיוצרים את האפליקציה עם תמיכה במכשירים עם 16KB, כדאי לבדוק את האפליקציה בסביבה של 16KB כדי לראות אם יש באפליקציה רגרסיות. לשם כך, בצע את הצעדים הבאים:
מגדירים אחת מסביבות הבדיקה הבאות:
מפעילים את מכשיר הבדיקה ומריצים את הפקודה הבאה כדי לוודא שהוא משתמש בסביבה של 16 KB:
adb shell getconf PAGE_SIZE
הפקודה צריכה להחזיר את הערך
16384
.מריצים את הפקודה הבאה
zipalign
כדי לוודא שהאפליקציה מיושרת ל-16 KB, כאשר APK_NAME הוא השם של קובץ ה-APK של האפליקציה:zipalign -c -P 16 -v 4 APK_NAME.apk
חשוב לבדוק את האפליקציה באופן יסודי, תוך התמקדות באזורים שעשויים להיות מושפעים משינוי מופעי קוד שמפנים לגדלים ספציפיים של דפים.
הגדרה של Android Emulator עם קובץ אימג' של מערכת Android 15 שמבוסס על 16KB
כדי להגדיר סביבה של 16 KB באמצעות Android Emulator, מבצעים את השלבים הבאים:
תמונות מערכת של אמולטור Android 15 מבוססות-16KB תואמות ל-Android Studio Jellyfish | 2023.3.1 או לגרסאות מתקדמות יותר. עם זאת, כדי לקבל את החוויה הטובה ביותר כשעובדים עם מכשירים בנפח 16 KB, מומלץ להשתמש ב-Android Studio Ladybug | 2024.2.1 ואילך.
אנחנו תמיד עובדים על תכונות חדשות, ולכן מומלץ להוריד גרסאות חדשות יותר או את גרסת הטרום-השקה האחרונה של Android Studio כשהן זמינות.
חשוב לזכור שאפשר להשאיר את הגרסה הקיימת של Android Studio מותקנת, כי אפשר להתקין כמה גרסאות זו לצד זו.
ב-Android Studio, לוחצים על Tools > SDK Manager (כלים > SDK Manager).
בכרטיסייה SDK Platforms (פלטפורמות SDK), מסמנים את התיבה Show Package Details (הצגת פרטי החבילה), מרחיבים את הקטע Android VanillaIceCream (Android VanillaIceCream) או גרסה מתקדמת יותר, ובוחרים אחת או יותר מתמונות המערכת הבאות של האמולטור, בהתאם למכשירים הווירטואליים שרוצים ליצור:
- תמונת מערכת Google APIs Experimental 16 KB Page Size ARM 64 v8a
- Google APIs Experimental 16 KB Page Size Intel x86_64 Atom System Image
לוחצים על החלה > אישור כדי להוריד את תמונות המערכת שבחרתם.
פועלים לפי השלבים להגדרת מכשיר וירטואלי ל-Android 15, וכשמוצגת בקשה לבחירת תמונת מערכת, בוחרים את תמונת המערכת בגודל 16KB שהורדתם. אם היא לא מומלצת באופן אוטומטי, אפשר למצוא את תמונת המערכת בגודל 16 KB בכרטיסייה תמונות אחרות.
שלבים נוספים לחלק מגרסאות האמולטור ותמונות המערכת
כדי לדמות סביבה של 16KB במערכות x86_64, צריך לבצע גם את השלבים הבאים בגרסאות Android Emulator 35.1.5 עד 35.1.20, ולפני עדכון 4 של תמונות המערכת של Android 15.0 בגודל 16KB שמוצעות ב-SDK Manager. השלבים האלה לא נדרשים אחרי גרסה 35.1.21, ועם עדכון 4 של תמונות המערכת של Android 15.0 בגודל דף של 16 KB ומעלה.
- במרכז ניהול המכשירים, לוחצים על סמל האפשרויות הנוספות (3 נקודות) לצד התמונה בגודל 16 KB, ואז לוחצים על הצגה בדיסק.
- בתיקייה הזו, מחפשים את הקובץ
config.ini
. מוסיפים את השורה הבאה לקובץ
config.ini
ושומרים את השינויים:kernel.parameters = androidboot.page_shift=14
כדי לוודא שהשינויים בוצעו, מריצים את הפקודה הבאה, שאמורה להחזיר
16384
:adb shell getconf PAGE_SIZE
הפעלת האמולטור
אחרי שמסיימים להגדיר את Android Emulator ואת המכשירים הווירטואליים, מפעילים את האמולטור מתפריט מכשיר היעד או משורת הפקודה.
使用开发者选项在设备上启用 16 KB 模式

切换以 16KB 页面大小启动设备开发者选项,以在 16 KB 模式下启动设备。
从 Android 15 QPR1 开始,您可以使用某些设备上提供的开发者选项,以 16 KB 模式启动设备并执行设备端测试。在使用开发者选项之前,请依次前往设置 > 系统 > 软件更新,并应用所有可用的更新。
此开发者选项适用于以下设备:
Pixel 8 和 8 Pro(搭载 Android 15 QPR1 或更高版本)
Pixel 8a(搭载 Android 15 QPR1 或更高版本)
Pixel 9、9 Pro 和 9 Pro XL(搭载 Android 15 QPR2 Beta 2 或更高版本)
דרישת התאימות ל-Google Play
יצרני מכשירים מציידים את המכשירים ב-RAM גדול יותר כדי לשפר את הביצועים, ולכן רבים מהם יאמצו גדלים גדולים יותר של דפים כמו 16 KB. כדי להתכונן להשקת המכשירים החדשים האלה, אנחנו מציגים ב-Google Play דרישת תאימות חדשה: החל מ-1 בנובמבר 2025, כל האפליקציות החדשות והעדכונים לאפליקציות קיימות שנשלחים אל Google Play ומטרגטים מכשירים עם Android 15 (רמת API 35) ומעלה, צריכים לתמוך בגודלי דפים של 16 KB.
מידע נוסף על דרישת התאימות הזו זמין בפוסט הזה בבלוג.