OTA cho các thiết bị A/B không có phân vùng động

Android 10 hỗ trợ phân vùng động, một hệ thống phân vùng không gian người dùng có thể tạo, đổi kích thước và huỷ phân vùng trong quá trình cập nhật qua mạng không dây (OTA).

Trang này mô tả cách ứng dụng OTA đổi kích thước phân vùng động trong quá trình cập nhật thiết bị A/B đã ra mắt mà không hỗ trợ phân vùng động và cách các ứng dụng OTA nâng cấp lên Android 10.

Thông tin khái quát

Trong quá trình cập nhật một thiết bị A/B để hỗ trợ phân vùng động, Bảng phân vùng GUID (GPT) trên thiết bị được giữ nguyên, vì vậy không có Phân vùng super trên thiết bị. Siêu dữ liệu được lưu trữ tại system_a và system_b, nhưng điều này có thể là được tuỳ chỉnh bằng cách thay đổi BOARD_SUPER_PARTITION_METADATA_DEVICE.

Mỗi thiết bị khối có 2 khe siêu dữ liệu. Chỉ một vị trí siêu dữ liệu trong mỗi thiết bị khối được sử dụng. Ví dụ: Siêu dữ liệu 0 ở system_a và Siêu dữ liệu 1 tại system_b tương ứng với các phân vùng tại khe A và B. Tại thời gian chạy, không quan trọng là khe nào đang được cập nhật.

Trong trang này, các vùng siêu dữ liệu được gọi là Metadata S (Siêu dữ liệu) (nguồn) và siêu dữ liệu T (mục tiêu). Tương tự, phân vùng được tham chiếu thành system_s, vendor_t, v.v.

Để biết thêm thông tin về cấu hình hệ thống xây dựng, hãy xem phần Nâng cấp thiết bị.

Để biết thêm thông tin về cách các phân vùng thuộc về nhóm cập nhật, hãy xem Thay đổi về cấu hình bảng cho thiết bị mới.

Ví dụ về siêu dữ liệu trên một thiết bị:

• Thiết bị khối vật lý system_a
  • Siêu dữ liệu 0
    • Nhóm foo_a
      • Phân vùng logic (động) system_a
      • Phân vùng logic (động) product_services_a
      • Các phân vùng khác do Foo cập nhật
    • Nhóm bar_a
      • Phân vùng logic (động) vendor_a
      • Phân vùng logic (động) product_a
      • Các phân vùng khác do Bar cập nhật
  • Siêu dữ liệu 1 (không được sử dụng)
• Thiết bị khối vật lý system_b
  • Siêu dữ liệu 0 (không được sử dụng)
  • Siêu dữ liệu 1
    • Nhóm foo_b
      • Phân vùng logic (động) system_b
      • Phân vùng logic (động) product_services_b
      • Các phân vùng khác do Foo cập nhật
    • Nhóm bar_b
      • Phân vùng logic (động) vendor_b
      • Phân vùng logic (động) product_b
      • Các phân vùng khác được Bar cập nhật

Bạn có thể sử dụng công cụ lpdump trong system/extras/partition_tools để kết xuất siêu dữ liệu thiết bị của bạn. Ví dụ:

lpdump --slot 0 /dev/block/by-name/system_a
lpdump --slot 1 /dev/block/by-name/system_b

Cập nhật lại

Trên các thiết bị chạy Android 9 trở xuống, ứng dụng OTA trên thiết bị không hỗ trợ liên kết phân vùng động trước khi cập nhật. Một nhóm bản vá bổ sung được tạo để có thể áp dụng trực tiếp việc ánh xạ vào các phân vùng vật lý hiện có.

Trình tạo OTA sẽ tạo tệp super.img cuối cùng chứa nội dung của tất cả các phân vùng động, sau đó chia hình ảnh thành nhiều hình ảnh khớp với kích thước của thiết bị khối thực tương ứng với hệ thống, nhà cung cấp, v.v. Những hình ảnh này được đặt tên super_system.img, super_vendor.img, v.v. Ứng dụng OTA áp dụng những hình ảnh này vào các phân vùng thực tế, thay vì so với việc áp dụng hình ảnh cho phân vùng logic (động).

Vì ứng dụng OTA không biết cách ánh xạ các phân vùng động, nên tất cả các bước sau khi cài đặt sẽ tự động bị tắt đối với các phân vùng này khi gói cập nhật được tạo. Xem Định cấu hình sau khi cài đặt để biết thêm chi tiết.

Quy trình cập nhật giống như trong Android 9.

Trước khi cập nhật:

ro.boot.dynamic_partitions=
ro.boot.dynamic_partitions_retrofit=

Sau khi cập nhật:

ro.boot.dynamic_partitions=true
ro.boot.dynamic_partitions_retrofit=true

Các bản cập nhật trong tương lai sau khi cải tiến

Sau khi được cập nhật, ứng dụng OTA sẽ được cập nhật để tương thích với phân vùng động. Phạm vi của các phân vùng nguồn không bao giờ mở rộng trên các phân vùng thực tế mục tiêu.

Quy trình cập nhật bằng gói cập nhật thông thường

1. Khởi động siêu dữ liệu phân vùng super.
   1. Tạo siêu dữ liệu mới M từ Siêu dữ liệu S (siêu dữ liệu nguồn). Ví dụ: nếu Metadata S sử dụng [system_s, vendor_s, product_s] ở dạng khối thì siêu dữ liệu M mới sử dụng [system_t, vendor_t, product_t] ở dạng khối thiết bị. Tất cả các nhóm và phân vùng đều bị loại bỏ trong M.
   2. Thêm các nhóm mục tiêu và phân vùng theo trường dynamic_partition_metadata trong tệp kê khai bản cập nhật. Bạn có thể tìm thấy kích thước của mỗi phân vùng trong new_partition_info.
   3. Ghi M vào Metadata T.
   4. Ánh xạ các phân vùng đã thêm trên trình liên kết thiết bị dưới dạng có thể ghi.
2. Áp dụng bản cập nhật trên các thiết bị bị chặn.
   1. Nếu cần, hãy liên kết các phân vùng nguồn trên trình liên kết thiết bị ở dạng chỉ đọc. Điều này là cần thiết để tải không qua cửa hàng ứng dụng vì các phân vùng nguồn không được liên kết trước khi cập nhật.
   2. Áp dụng bản cập nhật đầy đủ hoặc delta cho tất cả thiết bị khối tại khe mục tiêu.
   3. Gắn kết các phân vùng để chạy tập lệnh sau cài đặt, sau đó ngắt kết nối các phân vùng.
3. Huỷ liên kết các phân vùng mục tiêu.

Quy trình cập nhật bằng gói cập nhật Retrofit

Nếu gói cập nhật Retrofit được áp dụng trên một thiết bị đã bật phân vùng động, ứng dụng OTA sẽ áp dụng phần phân tách super.img tệp trực tiếp trên các thiết bị chặn. Quy trình cập nhật tương tự như quy trình cập nhật cải tiến. Hãy xem phần Cập nhật lại bản cập nhật để biết thông tin chi tiết.

Ví dụ: giả sử như sau:

• Vị trí A là vị trí đang hoạt động.
• system_a chứa siêu dữ liệu đang hoạt động ở vị trí 0.
• system_a, vendor_a và product_a được dùng làm thiết bị khối.

Khi ứng dụng OTA nhận được một gói cập nhật Retrofit, gói này sẽ được áp dụng super_system.img trên system_b thực, super_vendor.img trên vendor_b thực tế và super_product.img vào product_b thực. Thiết bị khối thực system_b chứa siêu dữ liệu chính xác để liên kết system_b, vendor_b và product_b logic tại thời điểm khởi động.

Lưu ý: Trước và sau khi cập nhật, các giá trị này không thay đổi:

PRODUCT_USE_DYNAMIC_PARTITIONS := true
PRODUCT_RETROFIT_DYNAMIC_PARTITIONS := true

Tạo gói cập nhật

OTA gia tăng

Khi tạo OTA gia tăng cho thiết bị trang bị thêm, các bản cập nhật phụ thuộc vào việc bản dựng cơ sở có xác định PRODUCT_USE_DYNAMIC_PARTITIONS và PRODUCT_RETROFIT_DYNAMIC_PARTITIONS.

• Nếu bản dựng cơ sở không xác định các biến, thì đây là bản cập nhật cải tiến. Gói cập nhật chứa phần phân tách super.img và vô hiệu hoá bước sau khi cài đặt.
• Nếu bản dựng cơ sở có xác định các biến, thì trường hợp này giống như một bản cập nhật thông thường với các phân vùng động. Gói cập nhật chứa hình ảnh cho các phân vùng logic (động). Bạn có thể bật bước sau khi cài đặt.

OTA đầy đủ

Hai gói OTA đầy đủ được tạo cho các thiết bị Retrofit.

• $(PRODUCT)-ota-retrofit-$(TAG).zip luôn chứa super.img phân tách và vô hiệu hoá bước sau khi cài đặt để cập nhật cải tiến.
  • Hàm này được tạo với một đối số bổ sung --retrofit_dynamic_partitions vào Tập lệnh ota_from_target_files.
  • Bạn có thể áp dụng cho tất cả các bản dựng.
• $(PRODUCT)-ota-$(TAG).zip chứa hình ảnh logic cho các bản cập nhật trong tương lai.
  • Chỉ áp dụng điều này cho các bản dựng đã bật phân vùng động. Hãy xem thông tin chi tiết bên dưới về việc thực thi chính sách này.

Từ chối bản cập nhật không phải Retrofit trên bản dựng cũ

Chỉ áp dụng gói OTA đầy đủ thông thường cho các bản dựng có đã bật phân vùng động. Nếu máy chủ OTA được định cấu hình không chính xác và đẩy các gói này sang thiết bị chạy Android 9 hoặc thấp hơn, thiết bị không khởi động được. Ứng dụng OTA trên Android 9 và không thể phân biệt giữa gói OTA trang bị thêm và gói gói OTA đầy đủ thông thường, để ứng dụng khách sẽ không từ chối toàn bộ gói.

Để ngăn thiết bị chấp nhận gói OTA đầy đủ, bạn có thể yêu cầu một bước sau khi cài đặt để kiểm tra cấu hình thiết bị hiện có. Ví dụ:

device/device_name/dynamic_partitions/check_dynamic_partitions

#!/system/bin/sh
DP_PROPERTY_NAME="ro.boot.dynamic_partitions"
DP_RETROFIT_PROPERTY_NAME="ro.boot.dynamic_partitions_retrofit"

DP_PROPERTY=$(getprop ${DP_PROPERTY_NAME})
DP_RETROFIT_PROPERTY=$(getprop ${DP_RETROFIT_PROPERTY_NAME})

if [ "${DP_PROPERTY}" != "true" ] || [ "${DP_RETROFIT_PROPERTY}" != "true" ] ; then
    echo "Error: applied non-retrofit update on build without dynamic" \
         "partitions."
    echo "${DP_PROPERTY_NAME}=${DP_PROPERTY}"
    echo "${DP_RETROFIT_PROPERTY_NAME}=${DP_RETROFIT_PROPERTY}"
    exit 1
fi

device/device_name/dynamic_partitions/Android.mk

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE:= check_dynamic_partitions
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := EXECUTABLES
LOCAL_SRC_FILES := check_dynamic_partitions
LOCAL_PRODUCT_MODULE := true
include $(BUILD_PREBUILT)

device/device_name/device.mk

PRODUCT_PACKAGES += check_dynamic_partitions

# OPTIONAL=false so that the error in check_dynamic_partitions will be
# propagated to OTA client.
AB_OTA_POSTINSTALL_CONFIG += \
    RUN_POSTINSTALL_product=true \
    POSTINSTALL_PATH_product=bin/check_dynamic_partitions \
    FILESYSTEM_TYPE_product=ext4 \
    POSTINSTALL_OPTIONAL_product=false \

Khi gói OTA thông thường được áp dụng trên một thiết bị không có linh động đã bật phân vùng, ứng dụng OTA sẽ chạy check_dynamic_partitions làm bước sau khi cài đặt và từ chối cập nhật.