Menerapkan update A/B

OEM dan vendor SoC yang ingin menerapkan update sistem A/B harus memastikan bootloader mereka mengimplementasikan boot_control HAL dan meneruskan parameter yang benar ke kernel.

Mengimplementasikan boot control HAL

Bootloader yang mendukung A/B harus mengimplementasikan boot_control HAL di hardware/libhardware/include/hardware/boot_control.h. Anda dapat menguji implementasi menggunakan utilitas system/extras/bootctl dan system/extras/tests/bootloader/.

Anda juga harus mengimplementasikan mesin status yang ditampilkan di bawah:

Gambar 1. Mesin status bootloader

Menyiapkan kernel

Untuk mengimplementasikan update sistem A/B:

  1. Cherrypick rangkaian patch kernel berikut (jika diperlukan):
  2. Pastikan argumen command line kernel berisi argumen tambahan berikut: 
    skip_initramfs rootwait ro init=/init root="/dev/dm-0 dm=system none ro,0 1 android-verity <public-key-id> <path-to-system-partition>"
     ... dengan nilai <public-key-id> adalah ID kunci publik yang digunakan untuk memverifikasi tanda tangan tabel verity (untuk mengetahui detailnya, lihat dm-verity).
  3. Tambahkan sertifikat .X509 yang berisi kunci publik ke keyring sistem:
    1. Salin sertifikat .X509 yang diformat dalam format .der ke root direktori kernel. Jika sertifikat .X509 diformat sebagai file .pem, gunakan perintah openssl berikut untuk mengonversi dari .pem ke format .der: 
      openssl x509 -in <x509-pem-certificate> -outform der -out <x509-der-certificate>
    2. Buat zImage untuk menyertakan sertifikat sebagai bagian dari keyring sistem. Untuk memverifikasi,periksa entri procfs (memerlukan KEYS_CONFIG_DEBUG_PROC_KEYS untuk diaktifkan): 
      angler:/# cat /proc/keys

1c8a217e I------     1 perm 1f010000     0     0 asymmetri
Android: 7e4333f9bba00adfe0ede979e28ed1920492b40f: X509.RSA 0492b40f []
2d454e3e I------     1 perm 1f030000     0     0 keyring
.system_keyring: 1/4
       Penyertaan sertifikat .X509 yang berhasil menunjukkan keberadaan kunci publik di keyring sistem (sorotan menunjukkan ID kunci publik).
    3. Ganti spasi dengan # dan teruskan sebagai <public-key-id> di command line kernel. Misalnya, teruskan Android:#7e4333f9bba00adfe0ede979e28ed1920492b40f sebagai pengganti <public-key-id>.

Menetapkan variabel build

Bootloader yang mendukung A/B harus memenuhi kriteria variabel build berikut:

Harus ditentukan untuk target A/B
  • AB_OTA_UPDATER := true
  • AB_OTA_PARTITIONS := \
      boot \
      system \
      vendor
    dan partisi lainnya yang diupdate melalui update_engine (radio, bootloader, dll.)
  • PRODUCT_PACKAGES += \
      update_engine \
      update_verifier
Untuk contohnya, lihat /device/google/marlin/+/android-7.1.0_r1/device-common.mk. Anda dapat secara opsional melakukan langkah dex2oat pasca-instalasi (tetapi pra-reboot) yang dijelaskan dalam Mengompilasi.
Sangat direkomendasikan untuk target A/B
  • Tentukan TARGET_NO_RECOVERY := true
  • Tentukan BOARD_USES_RECOVERY_AS_BOOT := true
  • Jangan tentukan BOARD_RECOVERYIMAGE_PARTITION_SIZE
Tidak dapat ditentukan untuk target A/B
  • BOARD_CACHEIMAGE_PARTITION_SIZE
  • BOARD_CACHEIMAGE_FILE_SYSTEM_TYPE
Opsional untuk build debug PRODUCT_PACKAGES_DEBUG += update_engine_client

Menetapkan partisi (slot)

Perangkat A/B tidak memerlukan partisi pemulihan atau partisi cache karena Android tidak lagi menggunakan partisi ini. Partisi data kini digunakan untuk paket OTA yang didownload, dan kode image pemulihan berada di partisi booting. Semua partisi yang di-A/B harus diberi nama sebagai berikut (slot selalu diberi nama a, b, dll.): boot_a, boot_b, system_a, system_b, vendor_a, vendor_b.

Cache

Untuk update non-A/B, partisi cache digunakan untuk menyimpan paket OTA yang didownload dan untuk menyimpan blok sementara saat menerapkan update. Tidak pernah ada cara yang baik untuk menentukan ukuran partisi cache: ukuran yang diperlukan bergantung pada update yang ingin Anda terapkan. Kasus terburuknya adalah partisi cache yang berukuran sebesar image sistem. Dengan update A/B, Anda tidak perlu menyimpan blok (karena Anda selalu menulis ke partisi yang saat ini tidak digunakan) dan dengan streaming A/B, Anda tidak perlu mendownload seluruh paket OTA sebelum menerapkannya.

Pemulihan

Disk RAM pemulihan kini terdapat dalam file boot.img. Saat masuk ke pemulihan, bootloader tidak dapat menempatkan opsi skip_initramfs di command line kernel.

Untuk update non-A/B, partisi pemulihan berisi kode yang digunakan untuk menerapkan update. Update A/B diterapkan oleh update_engine yang berjalan di image sistem yang di-boot secara reguler. Masih ada Mode pemulihan (Recovery mode) yang digunakan untuk menerapkan reset ke setelan pabrik dan sideload paket update (yang menjadi asal nama "pemulihan"). Kode dan data untuk mode pemulihan disimpan di partisi booting reguler dalam ramdisk; untuk melakukan booting ke image sistem, bootloader memberi tahu kernel untuk melewati ramdisk (jika tidak, perangkat akan melakukan booting ke mode pemulihan. Mode pemulihan berukuran kecil (dan sebagian besar sudah ada di partisi booting), sehingga ukuran partisi booting tidak bertambah.

Fstab

Argumen slotselect harus berada di baris untuk partisi yang di-A/B. Contoh: 

<path-to-block-device>/vendor  /vendor  ext4  ro
wait,verify=<path-to-block-device>/metadata,slotselect

Tidak ada partisi yang boleh diberi nama vendor. Sebagai gantinya, partisi vendor_a atau vendor_b akan dipilih dan dipasang di direktori pemasangan /vendor.

Argumen slot kernel

Sufiks slot saat ini harus diteruskan melalui node tree perangkat (DT) tertentu (/firmware/android/slot_suffix) atau melalui androidboot.slot_suffix command line kernel atau argumen bootconfig.

Secara default, fastboot mem-flash slot saat ini di perangkat A/B. Jika paket update juga berisi image untuk slot lain yang bukan saat ini, fastboot juga akan mem-flash image tersebut. Opsi yang tersedia mencakup:

  • --slot SLOT. Mengganti perilaku default dan meminta fastboot untuk mem-flash slot yang diteruskan sebagai argumen.
  • --set-active [SLOT]. Menetapkan slot sebagai aktif. Jika tidak ada argumen opsional ditentukan, slot saat ini akan ditetapkan sebagai aktif.
  • fastboot --help. Mendapatkan detail tentang perintah.

Jika bootloader mengimplementasikan fastboot, bootloader harus mendukung perintah set_active <slot> yang menetapkan slot aktif saat ini ke slot yang diberikan (tindakan ini juga harus menghapus flag yang tidak dapat di-boot untuk slot tersebut dan mereset jumlah percobaan ulang ke nilai default). Bootloader juga harus mendukung variabel berikut:

  • has-slot:<partition-base-name-without-suffix>. Menampilkan “yes” jika partisi yang diberikan mendukung slot, “no” jika tidak.
  • current-slot. Menampilkan sufiks slot yang akan di-boot dari berikutnya.
  • slot-count. Menampilkan bilangan bulat yang mewakili jumlah slot yang tersedia. Saat ini, dua slot didukung sehingga nilai ini adalah 2.
  • slot-successful:<slot-suffix>. Menampilkan "yes" jika slot yang diberikan telah ditandai sebagai berhasil di-boot, "no" jika tidak.
  • slot-unbootable:<slot-suffix>. Menampilkan “yes” jika slot yang diberikan ditandai sebagai tidak dapat di-boot, "no" jika tidak.
  • slot-retry-count:<slot-suffix>. Jumlah percobaan ulang yang tersisa untuk mencoba melakukan booting slot yang diberikan.

Untuk melihat semua variabel, jalankan fastboot getvar all.

Membuat paket OTA

Alat paket OTA mengikuti perintah yang sama dengan perintah untuk perangkat non-A/B. File target_files.zip harus dibuat dengan menentukan variabel build untuk target A/B. Alat paket OTA secara otomatis mengidentifikasi dan membuat paket dalam format untuk updater A/B.

Contoh:

  • Untuk membuat OTA lengkap: 
    ./build/make/tools/releasetools/ota_from_target_files \
    dist_output/tardis-target_files.zip \
    ota_update.zip
  • Untuk membuat OTA inkremental: 
    ./build/make/tools/releasetools/ota_from_target_files \
    -i PREVIOUS-tardis-target_files.zip \
    dist_output/tardis-target_files.zip \
    incremental_ota_update.zip

Mengonfigurasi partisi

update_engine dapat mengupdate pasangan partisi A/B yang ditentukan di disk yang sama. Pasangan partisi memiliki awalan yang sama (seperti system atau boot) dan sufiks per slot (seperti _a). Daftar partisi yang update-nya ditentukan oleh generator payload dikonfigurasi oleh variabel make AB_OTA_PARTITIONS.

Misalnya, jika pasangan partisi bootloader_a dan booloader_b disertakan (_a dan _b adalah sufiks slot ), Anda dapat mengupdate partisi ini dengan menentukan hal berikut pada konfigurasi produk atau papan: 

AB_OTA_PARTITIONS := \
  boot \
  system \
  bootloader

Semua partisi yang diupdate oleh update_engine tidak boleh diubah oleh sistem lainnya. Selama update inkremental atau delta data biner dari slot saat ini digunakan untuk membuat data di slot baru. Setiap modifikasi dapat menyebabkan data slot baru gagal diverifikasi selama proses update, dan oleh karena itu, update akan gagal.

Mengonfigurasi pasca-instalasi

Anda dapat mengonfigurasi langkah pasca-instalasi secara berbeda untuk setiap partisi yang diupdate menggunakan kumpulan pasangan nilai kunci. Untuk menjalankan program yang terletak di /system/usr/bin/postinst dalam image baru, tentukan jalur relatif ke root sistem file di partisi sistem.

Misalnya, usr/bin/postinst adalah system/usr/bin/postinst (jika tidak menggunakan disk RAM). Selain itu, tentukan jenis sistem file yang akan diteruskan ke mount(2) panggilan sistem. Tambahkan hal berikut ke file produk atau perangkat .mk (jika berlaku): 

AB_OTA_POSTINSTALL_CONFIG += \
  RUN_POSTINSTALL_system=true \
  POSTINSTALL_PATH_system=usr/bin/postinst \
  FILESYSTEM_TYPE_system=ext4

Mengompilasi aplikasi

Aplikasi dapat dikompilasi di latar belakang sebelum reboot dengan image sistem baru. Untuk mengompilasi aplikasi di latar belakang, tambahkan hal berikut ke konfigurasi perangkat produk (di device.mk produk):

  1. Sertakan komponen native dalam build untuk memastikan skrip kompilasi dan biner dikompilasi dan disertakan dalam image sistem. 
      # A/B OTA dexopt package
  PRODUCT_PACKAGES += otapreopt_script
  2. Hubungkan skrip kompilasi ke update_engine sehingga berjalan sebagai langkah pasca-instalasi. 
      # A/B OTA dexopt update_engine hookup
  AB_OTA_POSTINSTALL_CONFIG += \
    RUN_POSTINSTALL_system=true \
    POSTINSTALL_PATH_system=system/bin/otapreopt_script \
    FILESYSTEM_TYPE_system=ext4 \
    POSTINSTALL_OPTIONAL_system=true

Untuk mendapatkan bantuan dalam menginstal file yang dioptimalkan sebelumnya di partisi sistem kedua yang tidak digunakan, lihat Instalasi booting pertama file DEX_PREOPT.