Triển khai thử nghiệm A/B ảo

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Để triển khai A/B ảo trên một thiết bị mới hoặc để cải tiến một thiết bị đã ra mắt, bạn phải thực hiện thay đổi đối với mã dành riêng cho thiết bị.

Cờ dựng

Các thiết bị sử dụng A/B ảo phải được định cấu hình dưới dạng thiết bị A/B và phải chạy bằng các phân vùng động.

Đối với các thiết bị khởi chạy bằng A/B ảo, hãy thiết lập các thiết bị đó để kế thừa cấu hình cơ sở của thiết bị A/B ảo:

$(call inherit-product, \
    $(SRC_TARGET_DIR)/product/virtual_ab_ota.mk)

Các thiết bị khởi chạy bằng A/B ảo chỉ cần một nửa kích thước bo mạch cho BOARD_SUPER_PARTITION_SIZE vì các khe B không còn ở chế độ siêu nữa. Tức là BOARD_SUPER_PARTITION_SIZE phải lớn hơn hoặc bằng sum(size of update groups) + overhead, và giá trị này phải lớn hơn hoặc bằng sum(size of partitions) + overhead.

Đối với Android 13 trở lên, để bật ảnh chụp nhanh nén bằng A/B ảo, hãy kế thừa cấu hình cơ sở sau:

$(call inherit-product, $(SRC_TARGET_DIR)/product/generic_ramdisk.mk)
$(call inherit-product, \
    $(SRC_TARGET_DIR)/product/virtual_ab_ota/vabc_features.mk)

Điều này cho phép tạo ảnh chụp nhanh không gian người dùng bằng A/B ảo trong khi sử dụng phương thức nén không hoạt động. Sau đó, bạn có thể định cấu hình phương thức nén thành một trong các phương thức được hỗ trợ,zstd và lz4. Đối với Android 15, bạn có thể tuỳ chỉnh thêm tính năng nén để phù hợp với nhu cầu của thiết bị. Để biết thêm thông tin, hãy xem phần Điều chỉnh nén.

PRODUCT_VIRTUAL_AB_COMPRESSION_METHOD := lz4
PRODUCT_VIRTUAL_AB_COMPRESSION_FACTOR := 65536

Đối với Android 12, để bật ảnh chụp nhanh nén bằng A/B ảo, hãy kế thừa cấu hình cơ sở sau:

$(call inherit-product, $(SRC_TARGET_DIR)/product/generic_ramdisk.mk)
$(call inherit-product, \
    $(SRC_TARGET_DIR)/product/virtual_ab_ota/compression.mk)

Nén XOR

Đối với các thiết bị nâng cấp lên Android 13 trở lên, tính năng nén XOR sẽ không được bật theo mặc định. Để bật tính năng nén XOR, hãy thêm nội dung sau vào tệp .mk của thiết bị.

PRODUCT_VENDOR_PROPERTIES += ro.virtual_ab.compression.xor.enabled=true

Tính năng nén XOR được bật theo mặc định cho các thiết bị kế thừa từ android_t_baseline.mk.

Hợp nhất không gian người dùng

Trong phiên bản hiện đại của Virtual A/B (Android T trở lên), quy trình hợp nhất ảnh chụp nhanh diễn ra hoàn toàn trong không gian người dùng. Thay đổi này là nhờ snapuserd và dm-user. Các thiết bị chạy Android 13 trở lên được bật tính năng hợp nhất không gian người dùng theo mặc định và đối với các thiết bị cũ đang nâng cấp, bạn có thể đặt thuộc tính này bằng cách sau:

PRODUCT_VENDOR_PROPERTIES += ro.virtual_ab.userspace.snapshots.enabled=true

HAL điều khiển khởi động

HAL điều khiển khởi động cung cấp giao diện cho ứng dụng OTA để kiểm soát các khe khởi động. A/B ảo yêu cầu nâng cấp phiên bản nhỏ của HAL điều khiển khởi động vì cần có các API bổ sung để đảm bảo trình tải khởi động được bảo vệ trong quá trình cài đặt ROM hoặc đặt lại về trạng thái ban đầu. Xem IBootControl.hal và types.hal để biết phiên bản mới nhất của định nghĩa HAL.

// hardware/interfaces/boot/1.1/types.hal
enum MergeStatus : uint8_t {
    NONE, UNKNOWN, SNAPSHOTTED, MERGING, CANCELLED };

// hardware/interfaces/boot/1.1/IBootControl.hal
package android.hardware.boot@1.1;
interface IBootControl extends @1.0::IBootControl {
    setSnapshotMergeStatus(MergeStatus status)
        generates (bool success);
    getSnapshotMergeStatus()
        generates (MergeStatus status);
}

// Recommended implementation

Return<bool> BootControl::setSnapshotMergeStatus(MergeStatus v) {
    // Write value to persistent storage
    // e.g. misc partition (using libbootloader_message)
    // bootloader rejects wipe when status is SNAPSHOTTED
    // or MERGING
}

Thay đổi về fstab

Tính toàn vẹn của phân vùng siêu dữ liệu là yếu tố thiết yếu đối với quá trình khởi động, đặc biệt là ngay sau khi áp dụng bản cập nhật OTA. Vì vậy, bạn phải kiểm tra phân vùng siêu dữ liệu trước khi first_stage_init gắn phân vùng đó. Để đảm bảo điều này xảy ra, hãy thêm cờ fs_mgr check vào mục nhập cho /metadata. Sau đây là ví dụ:

/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard,sync wait,formattable,first_stage_mount,check

Yêu cầu về hạt nhân

Để bật tính năng chụp nhanh, hãy đặt CONFIG_DM_SNAPSHOT thành true.

Đối với các thiết bị sử dụng F2FS, hãy đưa bản vá hạt nhân f2fs: export FS_NOCOW_FL flag to user (f2fs: xuất cờ FS_NOCOW_FL cho người dùng) vào để khắc phục lỗi ghim tệp. Cũng bao gồm bản vá hạt nhân f2fs: hỗ trợ tệp được ghim căn chỉnh.

A/B ảo dựa vào các tính năng được thêm vào kernel phiên bản 4.3: bit trạng thái overflow (tràn) trong các mục tiêu snapshot và snapshot-merge. Tất cả thiết bị chạy Android 9 trở lên đều phải có hạt nhân phiên bản 4.4 trở lên.

Để bật ảnh chụp nhanh được nén, phiên bản hạt nhân tối thiểu được hỗ trợ là 4.19. Đặt CONFIG_DM_USER=m hoặc CONFIG_DM_USER=y. Nếu sử dụng loại trước (mô-đun), bạn phải tải mô-đun đó trong ramdisk giai đoạn đầu. Bạn có thể thực hiện việc này bằng cách thêm dòng sau vào Makefile của thiết bị:

BOARD_GENERIC_RAMDISK_KERNEL_MODULES_LOAD := dm-user.ko

Thay đổi về công cụ khởi động nhanh

Android 11 thực hiện các thay đổi sau đối với giao thức khởi động nhanh:

• getvar snapshot-update-status – Trả về giá trị mà HAL kiểm soát khởi động đã thông báo cho trình tải khởi động:
  • Nếu trạng thái là MERGING, trình tải khởi động phải trả về merging.
  • Nếu trạng thái là SNAPSHOTTED, trình tải khởi động phải trả về snapshotted.
  • Nếu không, trình tải khởi động phải trả về none.
• snapshot-update merge – Hoàn tất thao tác hợp nhất, khởi động vào chế độ khôi phục/fastbootd nếu cần. Lệnh này chỉ hợp lệ nếu snapshot-update-status là merging và chỉ được hỗ trợ trong fastbootd.
• snapshot-update cancel – Đặt trạng thái hợp nhất của HAL điều khiển khởi động thành CANCELLED. Lệnh này không hợp lệ khi thiết bị bị khoá.
• erase hoặc wipe – erase hoặc wipe của metadata, userdata hoặc một phân vùng chứa trạng thái hợp nhất cho HAL kiểm soát khởi động phải kiểm tra trạng thái hợp nhất ảnh chụp nhanh. Nếu trạng thái là MERGING hoặc SNAPSHOTTED, thiết bị sẽ huỷ thao tác.
• set_active – Lệnh set_active thay đổi vị trí đang hoạt động phải kiểm tra trạng thái hợp nhất ảnh chụp nhanh. Nếu trạng thái là MERGING, thiết bị sẽ huỷ thao tác. Bạn có thể thay đổi khe một cách an toàn ở trạng thái SNAPSHOTTED.

Những thay đổi này được thiết kế để ngăn việc vô tình khiến thiết bị không khởi động được, nhưng có thể gây gián đoạn cho công cụ tự động. Khi các lệnh được dùng làm thành phần của quá trình cài đặt ROM cho tất cả các phân vùng, chẳng hạn như chạy fastboot flashall, bạn nên sử dụng quy trình sau:

1. Truy vấn getvar snapshot-update-status.
2. Nếu là merging hoặc snapshotted, hãy phát hành snapshot-update cancel.
3. Tiếp tục các bước cài đặt ROM.

Giảm các yêu cầu về dung lượng lưu trữ

Bạn nên sử dụng công cụ ánh xạ khối cho các thiết bị không có bộ nhớ A/B đầy đủ được phân bổ trong super và dự kiến sẽ sử dụng /data khi cần. Công cụ ánh xạ khối giúp duy trì tính nhất quán trong việc phân bổ khối giữa các bản dựng, giảm thiểu các hoạt động ghi không cần thiết vào ảnh chụp nhanh. Thông tin này được ghi lại trong phần Giảm kích thước OTA.

Thuật toán nén OTA

Bạn có thể điều chỉnh các gói OTA cho nhiều chỉ số hiệu suất. Android cung cấp một số phương thức nén được hỗ trợ (lz4, zstd và none) có sự đánh đổi giữa thời gian cài đặt, mức sử dụng không gian COW, thời gian khởi động và thời gian hợp nhất ảnh chụp nhanh. Tuỳ chọn mặc định được bật cho ab ảo có tính năng nén là lz4 compression method.

Tinh chỉnh chế độ nén

Bạn có thể tuỳ chỉnh thêm các thuật toán nén thông qua hai phương thức: (compression level) (mức độ nén đạt được với chi phí là tốc độ) và (compression factor) (hệ số nén) (kích thước cửa sổ nén tối đa). Mức độ nén có sẵn cho một số thuật toán nhất định như zstd và việc thay đổi mức độ này sẽ gây ra sự đánh đổi giữa tốc độ và tỷ lệ nén. Hệ số nén mô tả kích thước cửa sổ nén tối đa được sử dụng trong quá trình cài đặt OTA. Giá trị mặc định được đặt là 64k, nhưng bạn có thể ghi đè bằng cách tuỳ chỉnh tham số bản dựng PRODUCT_VIRTUAL_AB_COMPRESSION_FACTOR. Các hệ số nén được hỗ trợ là 4k, 8k, 16k, 32k, 64k, 128k và 256k.

PRODUCT_VIRTUAL_AB_COMPRESSION_FACTOR := 65536

Bản cập nhật OTA tăng dần trên Pixel 8 Pro

Bản cập nhật OTA đầy đủ trên Pixel 8 Pro