Hệ thống tệp tăng dần

Mô-đun hạt nhân Hệ thống tệp tăng dần (IncFS) được giới thiệu trong Android 11 cho phép hệ điều hành Android nhận các APK phát trực tuyến qua Cầu gỡ lỗi Android (ADB).

Mô-đun hạt nhân độc lập này tạo ra một hệ thống tệp ảo mới nằm trên hệ thống tệp Android hiện có. Điều này bổ sung cho những thay đổi trong khung và SDK để cho phép các nhà phát triển ứng dụng và trò chơi triển khai các APK lớn thông qua ADB cho thiết bị chạy trên Android 11 trở lên.

Thay đổi hạt nhân cho phép định dạng APK Signature Lược đồ v4 mới và hỗ trợ các thay đổi khung Android trong Trình quản lý gói Android, các dịch vụ hệ thống mới và các thay đổi đối với ADB.

Thực hiện

Để triển khai IncFS, các nhà sản xuất OEM và SoC phải thêm trình điều khiển hạt nhân mới vào bản dựng thiết bị Android của họ.

Chỉ dành cho Android 11 , nếu trình điều khiển hạt nhân được xây dựng dưới dạng mô-đun thì trình điều khiển này sẽ được tải theo yêu cầu. Nếu không có bất kỳ ứng dụng nào được cài đặt thông qua cài đặt tăng dần ADB thì thiết bị sẽ không tải trình điều khiển hạt nhân.

Mặt khác, khi nó được xây dựng như một phần của ảnh hạt nhân, trình điều khiển luôn được tải. Việc triển khai này hợp lệ cho Android 12 trở lên và có thể được sử dụng với Android 11 . Để biết thông tin về cách nâng cấp trình điều khiển hạt nhân lên Android 12, hãy xem Nâng cấp trình điều khiển hạt nhân .

Trình điều khiển hạt nhân là một phần của hệ thống lớn hơn để cho phép cài đặt APK phát trực tuyến. OEM và nhà cung cấp không cần sử dụng mã IncFS chính xác được cung cấp trong quá trình triển khai mẫu. Tuy nhiên, để đảm bảo trải nghiệm nhất quán trên các thiết bị, bạn phải đảm bảo việc triển khai API có hệ thống tệp có chức năng đọc tệp và chức năng đọc-ghi thư mục như được xác định trong giao diện Không gian người dùng dành cho tài liệu FS tăng dần .

Ngoài ra, việc triển khai phải có các tùy chọn gắn kếtcác tệp đặc biệt phù hợp về mặt chức năng với việc triển khai mẫu IncFS.

Sau đây liệt kê những thay đổi cần thiết để triển khai:

  1. Thiết lập máy phát triển để xây dựng kernel.
  2. Nhắm mục tiêu hạt nhân chung từ nhánh common-android-mainline .
    repo init -u https://android.googlesource.com/kernel/manifest -b common-android-mainline
    repo sync
  3. Xác thực rằng những thay đổi cần thiết sau đây cho IncFS đều có trong quá trình kiểm tra chi nhánh:
  4. Thêm CONFIG_INCREMENTAL_FS=y hoặc chỉ dành cho Android 11 , CONFIG_INCREMENTAL_FS=m ở cuối tệp defconfig . Để xem ví dụ, hãy nhấp vào một trong các liên kết bên dưới:
  5. Xây dựng hạt nhân
  6. Nhúng hạt nhân vào bản dựng hình ảnh thiết bị Android .
  7. Đối với thiết bị Android mục tiêu của bạn, hãy thêm một trong các dòng thuộc tính hệ thống dành riêng cho nhà cung cấp sau vào tệp device.mk của bạn ( tùy chọn trong các thiết bị chạy Android 12 trở lên ):
  8. Khi bạn đang sử dụng CONFIG_INCREMENTAL_FS=y , hãy thêm tệp bằng một trong các tệp sau:

    • PRODUCT_PROPERTY_OVERRIDES += \
    • ro.incremental.enable=yes

    Khi bạn đang sử dụng CONFIG_INCREMENTAL_FS=m ( chỉ dành cho Android 11 ), hãy thêm tệp bằng một trong các tệp sau:

    • PRODUCT_PROPERTY_OVERRIDES += \
    • ro.incremental.enable=module:/vendor/lib/modules/incrementalfs.ko
  9. Xem các tệp device.mk mẫu cho trình mô phỏng Android và Pixel 4 .
  10. Chỉ dành cho Android 11 : Nếu bạn đang sử dụng CONFIG_INCREMENTAL_FS=m , hãy thêm SE Linux Rules .
  11. Tạo và thêm tệp vold.te vào thư mục /system/sepolicy/vendor trên thiết bị của bạn với nội dung sau:

    • vold.te

    Cho phép nó tải trình điều khiển hệ thống tệp gia tăng:

    • allow vold self:capability sys_module;
    • allow vold vendor_incremental_module:file r_file_perms;
    • allow vold vendor_incremental_module:system module_load;

    Nối các quy tắc SE Linux sau vào tệp file.te hiện có trong thư mục /system/sepolicy/vendor của bạn:

    • file.te - Để biết ví dụ, hãy xem tệp file.te này.)
    • Trình điều khiển hệ thống tập tin gia tăng
    • type vendor_incremental_module, vendor_file_type, file_type;

    Nối các quy tắc SE Linux sau vào tệp file_contents hiện có được tìm thấy trong thư mục /system/sepolicy/vendor của bạn:

    • tệp file_contents - Để biết ví dụ, hãy xem tệp file_contents này.
    • # Incremental file system driver
    • /vendor/lib/modules/incrementalfs\.ko
    • u:object_r:vendor_incremental_module:s0

Nâng cấp trình điều khiển hạt nhân

Các thiết bị nâng cấp lên Android 12 có thể bao gồm phiên bản trình điều khiển IncFS cũ hơn. Đối với những thiết bị đó, AOSP khuyên bạn nên cập nhật trình điều khiển IncFS lên phiên bản hiện tại (trong trường hợp này là v2) vì những lý do sau:

  • Phiên bản được phát hành cùng với Android 11 là phiên bản triển khai IncFS ban đầu, chỉ nhằm mục đích hỗ trợ cài đặt ADB.
  • Android 12 sử dụng trình điều khiển IncFS để phát trực tuyến các bản cài đặt trò chơi Play. Điều này yêu cầu các tính năng mới và tính năng tối ưu hóa của IncFS v2 để mang lại trải nghiệm tốt hơn cho người dùng.
  • V1 hỗ trợ phát trực tuyến trò chơi nhưng làm như vậy với hiệu suất kém và mức sử dụng pin, CPU và RAM cao hơn v2.
  • V2 cung cấp trải nghiệm người dùng được cải tiến để phát trực tuyến, với hình ảnh động tiến trình mượt mà, báo cáo mức sử dụng dung lượng ổ đĩa chính xác và ngăn chặn sự can thiệp vào quá trình phát trực tuyến của ứng dụng bên thứ 3.

Để nâng cấp trình điều khiển IncFS trong kernel của bạn, hãy áp dụng các bản vá sau cho kernel 4.14 hoặc kernel 4.19:

Đối với tất cả các phiên bản kernel tùy chỉnh khác, vui lòng chuyển một trong các bản vá. Chúng chỉ ảnh hưởng đến thư mục fs/incfs và áp dụng rõ ràng cho mã v1 hiện có.

Tiếp tục sử dụng trình điều khiển IncFS theo cách tương tự như đối với Android 11 gốc nhưng hiện đã được nâng cấp, dưới dạng một phần tích hợp của hình ảnh hạt nhân hoặc dưới dạng một mô-đun riêng biệt. Không thay đổi bo mạch hệ thống hoặc cấu hình thuộc tính hệ thống.

Các thiết bị mới sử dụng hình ảnh hạt nhân GKI sẽ tự động nhận được trình điều khiển IncFS (v2) mới nhất, được định cấu hình như một phần của hình ảnh hạt nhân. Điều này không yêu cầu các bước bổ sung.

Cấu hình mô-đun có thể tải không còn được dùng trong Android 12 và không được hỗ trợ trên các thiết bị mới. Nó chỉ được phép nâng cấp hoặc đóng băng hình ảnh của nhà cung cấp khi hạt nhân ban đầu đã được xây dựng dưới dạng mô-đun.

Triển khai tham khảo

Việc triển khai này có thể được coi là một phần của hình ảnh hạt nhân hoặc ( chỉ dành cho Android 11 ) dưới dạng mô-đun có thể tải.

Mô-đun có thể tải (thiết bị Pixel 4) Trình giả lập Android (là một phần của hình ảnh hạt nhân)

Xác nhận và thử nghiệm

Xác thực việc triển khai bằng cách sử dụng Kiểm tra đơn vị tính năng, CTS và GTS.

CTS

Sử dụng CtsIncrementalInstallHostTestCases .

GTS

atest GtsIncrementalInstallTestCases :

/gts-tests/tests/packageinstaller/incremental/src/com/google/android/packageinstaller/incremental/gts/IncrementalInstallerTest.java

Kiểm tra IncFS

  1. Thiết lập môi trường phát triển.
  2. Hoàn thành các nhiệm vụ triển khai được nêu trong phần triển khai.
  3. Chạy các kiểm tra thủ công sau:
    mmma system/incremental_delivery/incfs/tests
    atest libincfs-test
    atest IncrementalServiceTest
    atest PackageManagerShellCommandTest
    PackageManagerShellCommandIncrementalTest

Cách kiểm tra IncFS bằng SDK Android (ADB và apksigner)

  • Thiết lập môi trường phát triển.
  • Hoàn thành các nhiệm vụ triển khai được nêu trong phần triển khai.
  • Flash bản dựng trên thiết bị vật lý hoặc trình mô phỏng mục tiêu.
  • Tạo hoặc lấy APK hiện có.
  • Tạo khóa ký gỡ lỗi .
  • APK có định dạng chữ ký v4 từ thư mục build-tools .
    ./apksigner sign --ks debug.keystore game.apk
  • Cài đặt APK trên thiết bị từ thư mục platform-tools .
    ./adb install game.apk
Ví dụ về cài đặt
Hình 1 : Ví dụ cài đặt

Xác định vị trí các bài kiểm tra này