Hình ảnh khôi phục

Trên các thiết bị không phải A/B, hình ảnh khôi phục phải chứa thông tin từ một blob cây thiết bị (DTB) hoặc hình ảnh lớp phủ Giao diện nguồn và cấu hình nâng cao (ACPI). Khi các thiết bị như vậy khởi động vào chế độ khôi phục, trình tải khởi động có thể tải hình ảnh lớp phủ tương thích với hình ảnh khôi phục. Những thiết bị hỗ trợ bản cập nhật A/B (liền mạch) nên sử dụng chế độ khôi phục làm chế độ khởi động thay vì một phân vùng khôi phục riêng biệt (để biết thông tin chi tiết, hãy xem phần Triển khai bản cập nhật A/B).

Các lựa chọn để đưa DTBO/ACPIO khôi phục vào hình ảnh khởi động/khôi phục khác nhau giữa các bản phát hành Android.

Phát hành Cập nhật lược đồ Tuân thủ GKI Phiên bản tiêu đề khởi động (thiết bị khởi chạy) Phiên bản tiêu đề khởi động (thiết bị nâng cấp) Bắt buộc phải có hình ảnh khôi phục chuyên dụng
11 A/B,
A/B ảo
3* Không áp dụng Không
A/B,
A/B ảo
Không 2, 3 0, 1, 2, 3 Không
không phải A/B 3 Không áp dụng
không phải A/B Không 2, 3 0, 1, 2, 3
10 (Q) A/B Không áp dụng 2 0, 1, 2 Không
không phải A/B Không áp dụng 2 0, 1, 2
9 (P) A/B Không áp dụng 1 0, 1 Không
không phải A/B Không áp dụng 1 0, 1
8 (O) A/B Không áp dụng Không áp dụng (được coi là 0) Không áp dụng (được coi là 0) Không
không phải A/B Không áp dụng Không áp dụng (được coi là 0) Không áp dụng (được coi là 0)

* Các thiết bị A/B chạy Android 11 trở lên và sử dụng Hình ảnh hạt nhân chung (GKI) phải sử dụng phiên bản tiêu đề khởi động chính là 3 để tương thích với phân vùng khởi động của nhà cung cấp.

Các điểm chính:

  • Các thiết bị A/B không cần chỉ định hình ảnh khôi phục vì bản cập nhật A/B sử dụng 2 nhóm phân vùng (bao gồm bootdtbo) và chuyển đổi giữa các phân vùng này trong quá trình cập nhật, giúp loại bỏ nhu cầu về hình ảnh khôi phục. Các thiết bị A/B vẫn có thể sử dụng một hình ảnh khôi phục chuyên dụng.

  • Các thiết bị không phải A/B khởi chạy bằng Android 11 trở lên và sử dụng phiên bản tiêu đề khởi động 3 phải chỉ định rõ ràng phiên bản tiêu đề khởi động 2 cho hình ảnh khôi phục riêng biệt. Ví dụ:

    BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
    
  • Đối với những cấu trúc không hỗ trợ cây thiết bị, hình ảnh khôi phục có thể bao gồm hình ảnh ACPIO thay vì hình ảnh DTBO.

Giới thiệu về lỗi OTA và hình ảnh khôi phục

Để ngăn chặn lỗi qua mạng không dây (OTA) trên các thiết bị không phải A/B, hình ảnh khôi phục phải tự túc và độc lập với các hình ảnh khác. Trong quá trình cập nhật qua mạng không dây (OTA), nếu xảy ra vấn đề sau khi hình ảnh lớp phủ được cập nhật (nhưng trước khi hoàn tất quá trình cập nhật đầy đủ), thiết bị sẽ cố gắng khởi động vào chế độ khôi phục để hoàn tất quá trình cập nhật OTA. Tuy nhiên, vì phân vùng lớp phủ đã được cập nhật, nên có thể xảy ra trường hợp không khớp với hình ảnh khôi phục (chưa được cập nhật).

Để ngăn quá trình khôi phục phụ thuộc vào phân vùng DTBO/ACPIO trong quá trình cập nhật, các thiết bị không phải A/B chạy Android 9 trở lên có thể chỉ định hình ảnh DTBO/ACPIO khôi phục chứa thông tin từ hình ảnh lớp phủ dưới dạng một phần riêng biệt trong định dạng hình ảnh khởi động (phải sử dụng phiên bản tiêu đề khởi động 1 hoặc 2).

Thay đổi hình ảnh khởi động

Để cho phép hình ảnh khôi phục chứa DTBO hoặc ACPIO khôi phục trên các thiết bị không phải A/B chạy Android 9 trở lên, hãy cập nhật cấu trúc hình ảnh khởi động như sau.

Phần hình ảnh khởi động Số trang
Đầu trang khởi động (1 trang) 1
Kernel (l trang) l = (kernel_size + page_size – 1) / page_size
Ramdisk (m trang) m = (ramdisk_size + page_size – 1) / page_size
Trình tải khởi động giai đoạn thứ hai (n trang) n = (second_size + page_size – 1) / page_size
DTBO hoặc ACPIO khôi phục (o pages) o = (recovery_[dtbo|acpio]_size + page_size – 1) / page_size

Để biết thông tin chi tiết về các đối số của công cụ mkbootimg để chỉ định phiên bản tiêu đề hình ảnh khởi động và đường dẫn hình ảnh lớp phủ, hãy xem phần Phiên bản tiêu đề hình ảnh khởi động.

Triển khai DTBO

Các thiết bị không phải A/B chạy phiên bản 9 trở lên có thể điền vào phần recovery_dtbo của hình ảnh khôi phục. Để đưa hình ảnh recovery_dtbo vào recovery.img, hãy làm như sau trong BoardConfig.mk của thiết bị:

  • Đặt cấu hình BOARD_INCLUDE_RECOVERY_DTBO thành true:

     BOARD_INCLUDE_RECOVERY_DTBO := true
    
  • Mở rộng biến BOARD_MKBOOTIMG_ARGS để chỉ định phiên bản tiêu đề hình ảnh khởi động:

    BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
    
  • Đảm bảo rằng biến BOARD_PREBUILT_DTBOIMAGE được đặt thành đường dẫn của hình ảnh DTBO. Hệ thống xây dựng Android sử dụng biến này để đặt đối số recovery_dtbo của công cụ mkbootimg trong quá trình tạo hình ảnh khôi phục.

Nếu bạn đặt chính xác các biến BOARD_INCLUDE_RECOVERY_DTBO, BOARD_MKBOOTIMG_ARGSBOARD_PREBUILT_DTBOIMAGE, hệ thống xây dựng Android sẽ bao gồm DTBO do biến BOARD_PREBUILT_DTBOIMAGE chỉ định trong recovery.img.

Triển khai ACPIO

Các thiết bị không phải A/B chạy Android 9 trở lên có thể sử dụng hình ảnh lớp phủ ACPIO (thay vì hình ảnh DTBO) và có thể điền vào phần recovery_acpio (thay vì phần recovery_dtbo) của hình ảnh khôi phục. Để đưa hình ảnh recovery_acpio vào recovery.img, trong BoardConfig.mk của thiết bị:

  • Đặt cấu hình BOARD_INCLUDE_RECOVERY_ACPIO thành true:

    BOARD_INCLUDE_RECOVERY_ACPIO := true
    
  • Mở rộng biến BOARD_MKBOOTIMG_ARGS để chỉ định phiên bản tiêu đề hình ảnh khởi động. Biến phải lớn hơn hoặc bằng 1 để hỗ trợ ACPIO khôi phục.

    BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
    
  • Đảm bảo rằng biến BOARD_RECOVERY_ACPIO được đặt thành đường dẫn của hình ảnh ACPIO. Hệ thống xây dựng Android sử dụng biến này để đặt đối số recovery_acpio của công cụ mkbootimg trong quá trình tạo hình ảnh khôi phục.

Nếu các biến BOARD_INCLUDE_RECOVERY_ACPIO, BOARD_MKBOOTIMG_ARGSBOARD_RECOVERY_ACPIO được đặt đúng cách, hệ thống xây dựng Android sẽ bao gồm ACPIO do biến BOARD_RECOVERY_ACPIO chỉ định trong recovery.img.