Trang này được dịch bởi Cloud Translation API.

Hỗ trợ kích thước trang 16 khảo sát KB

Android 过去仅支持 4 KB 内存页面大小，优化了系统内存性能，以针对 Android 设备通常具备的功能。从 Android 15 开始，AOSP 支持配置为使用 16 KB (16 KB) 页面大小的设备设备）。如果您的应用使用任何 NDK 库，请直接使用或者通过 SDK 间接创建，那么，您需要重新构建自己的应用支持这些 16KB 设备。

随着设备制造商不断打造出物理内存 (RAM)，许多此类设备都会采用 16KB（以及页面大小以优化设备的性能。正在添加支持 16 KB 页面大小的设备，可使您的应用在这些设备上运行并有助于您的应用从相关的广告效果中获益改进。如果不重新编译，应用可能无法在 16KB 设备上运行在未来的 Android 版本中正式推出。

为帮助您为应用添加支持，我们提供了有关如何检查如果您的应用受到影响重新构建您的应用（如果适用），以及如何在 Google Play 中使用模拟器（包括 Android 15）的 16 KB 环境系统映像）。

Lợi ích và mức tăng hiệu suất

配置为使用 16 KB 页面大小的设备平均会使用略多一些的内存，但系统和应用的性能也会得到各种提升：

缩短了系统内存压力时的应用启动时间：平均降低了 3.16%；对于我们测试的某些应用而言，改进幅度更大（最高可达 30%）
应用启动期间的功耗降低：平均降低了 4.56%
相机启动更快：热启动速度平均提高了 4.48%，冷启动速度平均提高了 6.60%
缩短了系统启动时间：平均缩短了 8%（约 950 毫秒）

这些改进基于我们的初始测试，实际设备上的结果可能会有所不同。随着测试的继续进行，我们将进一步分析应用的潜在收益。

Kiểm tra xem ứng dụng của bạn có bị ảnh hưởng hay không

如果您的应用使用了任何原生代码，则应重新构建应用以支持 16 KB 设备。如果您不确定自己的应用是否使用了原生代码，可以使用 APK 分析器确定是否存在任何原生代码，然后检查您找到的任何共享库的 ELF 段对齐情况。

如果您的应用仅使用以 Java 或 Kotlin 编程语言编写的代码（包括所有库或 SDK），则该应用已经支持 16 KB 设备。不过，我们建议您在 16 KB 环境中测试应用，以验证应用行为是否没有意外回归。

Ứng dụng có sử dụng mã gốc không?

Ứng dụng sử dụng mã gốc nếu có bất kỳ điều kiện nào sau đây:

Ứng dụng của bạn sử dụng mã C/C++ (gốc) bất kỳ. Nếu ứng dụng của bạn sử dụng Android NDK, thì ứng dụng đó sẽ sử dụng mã gốc.
Ứng dụng của bạn liên kết với mọi thư viện gốc hoặc phần phụ thuộc (chẳng hạn như SDK) của bên thứ ba sử dụng các thư viện hoặc phần phụ thuộc đó.
Ứng dụng của bạn được tạo bằng một trình tạo ứng dụng bên thứ ba sử dụng các thư viện gốc trên thiết bị.

Xác định thư viện gốc bằng Công cụ phân tích APK

Công cụ phân tích APK là công cụ giúp bạn đánh giá nhiều khía cạnh của tệp APK đã tạo. Để xác định xem ứng dụng của bạn sử dụng mã gốc hay thư viện, hãy làm theo các bước sau:

Mở Android Studio, sau đó nhấp vào File > Open (Tệp > Mở) rồi chọn một dự án bất kỳ.
Trên thanh trình đơn, hãy nhấp vào Build > Analyze APK... (Tạo > Phân tích APK…)
Chọn tệp APK mà bạn muốn phân tích.
Tìm trong thư mục lib, thư mục này lưu trữ các tệp đối tượng dùng chung (.so) (nếu có). Nếu có bất kỳ tệp đối tượng dùng chung nào, ứng dụng của bạn sẽ sử dụng mã gốc. Nếu không có tệp đối tượng dùng chung hoặc không có thư mục lib, thì ứng dụng của bạn không sử dụng mã gốc.

Kiểm tra việc căn chỉnh các phân đoạn ELF cho thư viện dùng chung

Đối với mọi thư viện dùng chung, hãy xác minh rằng các phân đoạn ELF của thư viện dùng chung được căn chỉnh đúng cách bằng cách căn chỉnh ELF 16 KB. Nếu đang phát triển trên Linux hoặc macOS, bạn có thể sử dụng tập lệnh check_elf_alignment.sh như mô tả trong phần sau. Bạn cũng có thể trực tiếp sử dụng các công cụ dòng lệnh.

Sử dụng tập lệnh check_elf_alignment.sh (Linux hoặc macOS)

Hãy làm theo các bước sau để kiểm tra việc căn chỉnh các phân đoạn ELF bằng tập lệnh check_elf_alignment.sh:

Lưu tập lệnh check_elf_alignment.sh vào một tệp.
Chạy tập lệnh trên tệp APK của ứng dụng:
```
check_elf_alignment.sh APK_NAME.apk
```
Tập lệnh sẽ xuất ra ALIGNED hoặc UNALIGNED cho tất cả thư viện dùng chung arm64-v8a.
Nếu có bất kỳ thư viện dùng chung arm64-v8a hoặc x86_64 nào là UNALIGNED, bạn cần cập nhật gói cho các thư viện đó, sau đó biên dịch lại ứng dụng và kiểm thử lại bằng cách làm theo các bước trong phần này.

Trực tiếp sử dụng công cụ dòng lệnh

Hãy làm theo các bước sau để kiểm tra việc căn chỉnh các phân đoạn ELF bằng cách sử dụng trực tiếp các công cụ dòng lệnh:

Đảm bảo bạn đã cài đặt cả Công cụ bản dựng SDK Android phiên bản 35.0.0 trở lên và Android NDK bằng Trình quản lý SDK trong Android Studio hoặc công cụ dòng lệnh sdkmanager.

Giải nén tệp APK của ứng dụng:

Linux hoặc macOS

unzip APK_NAME.apk -d /tmp/my_apk_out

Windows (PowerShell)

Expand-Archive -Path .\APK_NAME.apk -DestinationPath ~\tmp\my_apk_out

Trong thư mục tạm thời mà bạn đã trích xuất tệp APK, hãy kiểm tra nội dung của thư mục lib để tìm các tệp đối tượng dùng chung (.so). Đây là những tệp đối tượng dùng chung mà bạn đã thấy trong khi xác định thư viện gốc bằng Công cụ phân tích APK. Chạy lệnh sau trên mỗi tệp đối tượng dùng chung:
Linux hoặc 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"
```
Trong đó, SDK_ROOT_LOCATION là đường dẫn đến thư mục mà bạn đã cài đặt SDK Android, SHARED_OBJECT_FILE là tên của tệp đối tượng dùng chung mà bạn đang kiểm tra và NDK_VERSION là phiên bản của Android NDK mà bạn đã cài đặt (ví dụ: 28.0.12433566). Kết quả sẽ có dạng như sau đối với mỗi tệp mà bạn kiểm tra:
```
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
```
Kiểm tra các dòng đầu ra để đảm bảo rằng các phân đoạn tải không có giá trị thấp hơn 2**14. Nếu có phân đoạn tải nào là 2**13, 2**12 hoặc giá trị thấp hơn, bạn cần cập nhật gói cho các thư viện đó, sau đó biên dịch lại ứng dụng và kiểm thử lại bằng cách làm theo các bước trong phần này.
Tiếp theo, hãy chạy công cụ dòng lệnh zipalign trên tệp APK của ứng dụng:
Linux hoặc 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
```
Trong đó, SDK_ROOT_LOCATION là đường dẫn đến thư mục bạn đã cài đặt SDK Android và APK_NAME là tên của tệp APK của ứng dụng. Dòng cuối cùng của kết quả sẽ hiển thị "Xác minh thành công" nếu tất cả thư viện dùng chung đều được căn chỉnh chính xác.

Nếu xác minh không thành công, bạn cần phải điều chỉnh lại một số thư viện dùng chung. Vì vậy, bạn cần cập nhật gói cho các thư viện đó, sau đó biên dịch lại ứng dụng và kiểm thử lại bằng cách làm theo các bước trong phần này.

Tạo ứng dụng có hỗ trợ thiết bị 16 KB

Để hỗ trợ các thiết bị 16 KB, các ứng dụng sử dụng mã gốc phải hoàn tất các bước được nêu trong các phần sau. Nếu bạn cập nhật lên AGP phiên bản 8.5.1 trở lên và NDK phiên bản r28 trở lên, đồng thời sử dụng các phần phụ thuộc tạo sẵn tương thích với 16 KB, thì theo mặc định, các ứng dụng sẽ tương thích với 16 KB.

Cập nhật gói của thư viện dùng chung

Bạn nên nâng cấp lên AGP phiên bản 8.5.1 trở lên và sử dụng thư viện dùng chung không nén.

AGP phiên bản 8.5.1 trở lên

Các thiết bị 16 KB yêu cầu ứng dụng đi kèm với thư viện dùng chung không nén để căn chỉnh các thư viện đó trên ranh giới nén 16 KB. Để làm việc này, bạn cần nâng cấp lên Trình bổ trợ Android cho Gradle (AGP) phiên bản 8.5.1 trở lên. Hãy tham khảo phần Trợ lý nâng cấp trình bổ trợ Android cho Gradle để biết thông tin chi tiết về quy trình nâng cấp.

AGP phiên bản 8.5 trở xuống

Nếu bạn không thể nâng cấp AGP lên phiên bản 8.5.1 trở lên, thì giải pháp thay thế là chuyển sang sử dụng thư viện dùng chung được nén. Cập nhật cấu hình Gradle để Gradle nén các thư viện dùng chung khi đóng gói ứng dụng nhằm tránh các vấn đề cài đặt ứng dụng với thư viện dùng chung không được căn chỉnh.

Groovy

Trong tệp build.gradle, hãy thêm tuỳ chọn sau:

android {
  ...
  packagingOptions {
      jniLibs {
        useLegacyPackaging true
      }
  }
}

Kotlin

Trong tệp build.gradle.kts, hãy thêm tuỳ chọn sau:

android {
  ...
  packagingOptions {
      jniLibs {
        useLegacyPackaging = true
      }
  }
}

Biên dịch ứng dụng bằng cách căn chỉnh ELF 16 KB

Các thiết bị 16 KB yêu cầu các phân đoạn ELF của thư viện dùng chung phải được căn chỉnh đúng cách bằng cách sử dụng tính năng căn chỉnh ELF 16 KB để ứng dụng của bạn chạy được.

Để biên dịch ứng dụng bằng cách căn chỉnh ELF 16 KB, hãy hoàn thành các bước trong một trong các phần sau, tuỳ thuộc vào phiên bản Android NDK mà bạn đang sử dụng.

Android NDK r28 trở lên

Theo mặc định, NDK phiên bản r28 trở lên biên dịch 16 KB được căn chỉnh.

Android NDK r27

Để hỗ trợ biên dịch các thư viện dùng chung được căn chỉnh 16 KB bằng Android NDK phiên bản r27 trở lên, bạn cần cập nhật ndk-build, build.gradle, build.gradle.kts hoặc cờ trình liên kết như sau:

ndk-build

Trong Application.mk:

APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true

Groovy

Trong tệp build.gradle, hãy đặt đối số -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

Trong tệp build.gradle.kts, hãy đặt đối số -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")
      }
    }
  }
}

Các hệ thống xây dựng khác

Chỉ định các cờ trình liên kết sau:

-Wl,-z,max-page-size=16384

Android NDK r26 trở xuống

Để hỗ trợ việc biên dịch các thư viện dùng chung được căn chỉnh 16 KB bằng Android NDK phiên bản r26 trở xuống, bạn cần cập nhật cấu hình ndk-build hoặc cmake như sau:

ndk-build

Cập nhật Android.mk để bật tính năng căn chỉnh ELF 16 KB:

LOCAL_LDFLAGS += "-Wl,-z,max-page-size=16384"

CMake

Cập nhật CMakeLists.txt để bật tính năng căn chỉnh ELF 16 KB:

target_link_options(${CMAKE_PROJECT_NAME} PRIVATE "-Wl,-z,max-page-size=16384")

Lưu ý quan trọng: Ngay cả khi ứng dụng của bạn liên kết động với thư viện chuẩn C++ (libc++_shared.so) từ NDK r26 trở xuống, một số thư viện không được căn chỉnh 16 KB, bạn vẫn nên cập nhật cách căn chỉnh của tất cả thư viện khác tại đây và cập nhật mã để tránh phụ thuộc vào PAGE_SIZE. Để kiểm thử trên các phiên bản NDK thấp hơn đó trên thiết bị 16 KB, các bản phát hành canary của phiên bản NDK LTS r23 và r25 có sẵn trên Android CI với thư viện libc++_shared.so được căn chỉnh 16 KB. Dù sao, bạn nên chuyển sang Android NDK r27 trở lên để cập nhật lên phiên bản thư viện tiêu chuẩn C++ được căn chỉnh ELF 16 KB. Nếu không, ứng dụng của bạn sẽ không cài đặt được trên các thiết bị 16 KB hiện nay.

Nếu không thể chuyển sang Android NDK mới hơn, bạn có thể cập nhật ứng dụng để biên dịch tĩnh thư viện chuẩn C++ vào thư viện dùng chung. Hãy tham khảo phần Hỗ trợ thư viện C++ để biết thông tin chi tiết về cách liên kết tĩnh với thư viện chuẩn C++ và nhớ đọc phần Những điều cần cân nhắc quan trọng.

Kiểm tra các thực thể mã tham chiếu đến kích thước trang cụ thể

Ngay cả khi ứng dụng của bạn được căn chỉnh 16 KB, ứng dụng vẫn có thể gặp lỗi nếu các vị trí trong mã giả định rằng thiết bị đang sử dụng một kích thước trang cụ thể. Để tránh điều này, hãy hoàn tất các bước sau:

Xoá mọi phần phụ thuộc được mã hoá cứng tham chiếu đến hằng số hoặc thực thể PAGE_SIZE trong logic mã của bạn giả định rằng kích thước trang của thiết bị là 4 KB (4096).

Thay vào đó, hãy sử dụng getpagesize() hoặc sysconf(_SC_PAGESIZE).
Tìm các trường hợp sử dụng mmap() và các API khác yêu cầu đối số được căn chỉnh theo trang và thay thế bằng các đối số thay thế nếu cần.

Trong một số trường hợp, nếu ứng dụng của bạn sử dụng PAGE_SIZE làm giá trị thuận tiện không liên kết với kích thước trang cơ bản, thì điều này sẽ không khiến ứng dụng của bạn bị lỗi khi sử dụng ở chế độ 16 KB. Tuy nhiên, nếu giá trị này được truyền đến hạt nhân bằng mmap mà không có MAP_FIXED, thì hạt nhân vẫn sử dụng toàn bộ trang, gây lãng phí một số bộ nhớ. Vì những lý do này, PAGE_SIZE không được xác định khi chế độ 16 KB được bật trên NDK r27 trở lên.

Nếu ứng dụng của bạn sử dụng PAGE_SIZE theo cách này và không bao giờ trực tiếp truyền giá trị này đến hạt nhân, thì thay vì sử dụng PAGE_SIZE, hãy tạo một biến mới có tên mới để phản ánh rằng biến đó được dùng cho các mục đích khác và không phản ánh trang bộ nhớ thực.

Kiểm tra SDK để xem có hỗ trợ 16 KB hay không

Nhiều SDK tương thích với kích thước trang 16 KB, đặc biệt là nếu bạn tự tạo SDK hoặc tải các SDK tạo sẵn gần đây. Tuy nhiên, do một số SDK tạo sẵn hoặc phiên bản SDK không tương thích với 16 KB, bạn nên kiểm tra trang web của từng nhà cung cấp SDK để xác định phiên bản nào sẽ sử dụng với 16 KB.

Kiểm thử ứng dụng trong môi trường 16 KB

Sau khi tạo ứng dụng hỗ trợ thiết bị 16 KB, bạn nên kiểm thử ứng dụng trong môi trường 16 KB để xem ứng dụng có bị hồi quy hay không. Để thực hiện việc này, hãy làm theo các bước sau:

Thiết lập SDK Android 15.
Thiết lập một trong các môi trường kiểm thử sau:
Khởi động thiết bị kiểm thử, sau đó chạy lệnh sau để xác minh rằng thiết bị đó đang sử dụng môi trường 16 KB:
```
adb shell getconf PAGE_SIZE
```
Lệnh này sẽ trả về giá trị 16384.
Chạy lệnh zipalign sau đây để xác minh rằng ứng dụng của bạn đã được căn chỉnh 16 KB, trong đó APK_NAME là tên của tệp APK của ứng dụng:
```
zipalign -c -P 16 -v 4 APK_NAME.apk
```
Kiểm thử kỹ lưỡng ứng dụng, tập trung vào mọi khía cạnh có thể bị ảnh hưởng bởi việc thay đổi các thực thể mã tham chiếu đến kích thước trang cụ thể.

Thiết lập Trình mô phỏng Android bằng hình ảnh hệ thống Android 15 dựa trên 16 KB

Để thiết lập môi trường 16 KB bằng Trình mô phỏng Android, hãy làm theo các bước sau:

Hình ảnh hệ thống trình mô phỏng Android 15 dựa trên 16 KB tương thích với Android Studio Jellyfish | 2023.3.1 trở lên. Tuy nhiên, để có trải nghiệm tốt nhất khi làm việc với Android 15 Beta, hãy tải phiên bản xem trước mới nhất của Android Studio xuống.

Hãy nhớ rằng bạn có thể giữ nguyên phiên bản Android Studio hiện có, vì bạn có thể cài đặt song song nhiều phiên bản Android Studio.
Trong Android Studio, hãy nhấp vào Tool (Công cụ) > SDK Manager (Trình quản lý SDK).
Trong thẻ SDK Platforms (Nền tảng SDK), hãy đánh dấu vào Show Package Details (Hiện chi tiết gói), sau đó mở rộng phần Android VanillaIceCream Preview (Bản dùng thử Android VanillaIceCream) và chọn một hoặc cả hai hình ảnh hệ thống trình mô phỏng sau đây, tuỳ thuộc vào thiết bị ảo mà bạn muốn tạo:
- Hình ảnh hệ thống ARM 64 v8a thử nghiệm của API của Google có kích thước trang 16k
- Hình ảnh hệ thống Intel x86_64 Atom có kích thước trang 16k thử nghiệm của API của Google
Lưu ý: Nếu dự định mô phỏng một thiết bị Google Pixel được hỗ trợ, bạn sẽ chỉ cần Hình ảnh hệ thống ARM 64 v8a.
Nhấp vào Apply > OK (Áp dụng > OK) để tải hình ảnh hệ thống mà bạn đã chọn xuống.
Làm theo các bước để thiết lập thiết bị ảo cho Android 15 và khi được nhắc chọn hình ảnh hệ thống, hãy chọn hình ảnh hệ thống 16 KB mà bạn đã tải xuống. Nếu hình ảnh hệ thống 16 KB không được đề xuất tự động, bạn có thể tìm thấy hình ảnh đó trong thẻ Hình ảnh khác.

Trong Trình quản lý thiết bị, hãy nhấp vào biểu tượng 3 dấu chấm bên cạnh hình ảnh 16 KB, sau đó nhấp vào Hiện trên ổ đĩa.
Trong thư mục này, hãy tìm tệp config.ini.
Thêm dòng sau vào tệp config.ini rồi lưu các thay đổi:
```
kernel.parameters = androidboot.page_shift=14
```
Để xác minh các thay đổi, hãy chạy lệnh sau. Lệnh này sẽ trả về 16384:
```
adb shell getconf PAGE_SIZE
```

Bật chế độ 16 KB trên thiết bị bằng tuỳ chọn cho nhà phát triển

Bật/tắt nhà phát triển Khởi động có kích thước trang 16KB khởi động thiết bị ở chế độ 16 KB.

Kể từ Android 15 QPR1, bạn có thể sử dụng tuỳ chọn dành cho nhà phát triển có sẵn trên một số khởi động thiết bị ở chế độ 16 KB và tiến hành kiểm tra trên thiết bị.

Tuỳ chọn cho nhà phát triển này có trên các thiết bị sau:

Pixel 8 và 8 Pro (chạy Android 15 QPR1 Beta 1 trở lên)

Hỗ trợ 64 bit