Menerapkan update A/B

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

Menerapkan HAL kontrol booting

Bootloader yang kompatibel dengan A/B harus menerapkan HAL boot_control di hardware/libhardware/include/hardware/boot_control.h. Anda dapat menguji penerapan menggunakan utilitas system/extras/bootctl dan system/extras/tests/bootloader/.

Anda juga harus menerapkan mesin status yang ditunjukkan di bawah:

Gambar 1. Mesin status bootloader

Menyiapkan kernel

Untuk menerapkan update sistem A/B:

  1. Pilih seri 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. Bangun zImage untuk menyertakan sertifikat sebagai bagian dari keyring sistem. Untuk memverifikasi,periksa entri procfs (memerlukan KEYS_CONFIG_DEBUG_PROC_KEYS 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 ganti <public-key-id>.

Menetapkan variabel build

Bootloader yang kompatibel dengan 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 diperbarui melalui update_engine (radio, bootloader, dll.)
  • PRODUCT_PACKAGES += \
      update_engine \
      update_verifier
Untuk contoh, lihat /device/google/marlin/+/android-7.1.0_r1/device-common.mk. Anda dapat melakukan langkah dex2oat pasca-penginstalan (tetapi pra-mulai ulang) yang dijelaskan di 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 ada 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: seberapa besar ukurannya bergantung pada update yang ingin Anda terapkan. Kasus terburuk adalah partisi cache yang ukurannya sama dengan image sistem. Dengan update A/B, tidak perlu menyimpan blok (karena Anda selalu menulis ke partisi yang saat ini tidak digunakan) dan dengan A/B streaming, 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 yang digunakan untuk menerapkan reset data ke setelan pabrik dan memuat paket update secara manual (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 di-mount pada titik pemasangan /vendor.

Argumen slot kernel

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

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

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

Jika bootloader mengimplementasikan fastboot, bootloader harus mendukung perintah set_active <slot> yang menetapkan slot aktif saat ini ke slot yang diberikan (perintah ini juga harus menghapus tanda 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 tertentu mendukung slot, “no” jika tidak.
  • current-slot. Menampilkan akhiran slot yang akan di-boot 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 tertentu telah ditandai sebagai berhasil melakukan booting, "no" jika tidak.
  • slot-unbootable:<slot-suffix>. Menampilkan “yes” jika slot yang diberikan ditandai sebagai tidak dapat di-boot, "no" jika sebaliknya.
  • slot-retry-count:<slot-suffix>. Jumlah percobaan ulang yang tersisa untuk mencoba melakukan booting pada slot yang ditentukan.

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 otomatis mengidentifikasi dan membuat paket dalam format untuk pengupdate A/B.

Contoh:

  • Untuk membuat OTA penuh: 
    ./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 memperbarui pasangan partisi A/B yang ditentukan dalam disk yang sama. Pasangan partisi memiliki awalan yang sama (seperti system atau boot) dan akhiran per slot (seperti _a). Daftar partisi yang pembuat payloadnya menentukan pembaruan dikonfigurasi oleh variabel make AB_OTA_PARTITIONS.

Misalnya, jika sepasang partisi bootloader_a dan booloader_b disertakan (_a dan _b adalah akhiran slot), Anda dapat memperbarui 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 pembaruan inkremental atau delta, data biner dari slot saat ini digunakan untuk menghasilkan data di slot baru. Setiap modifikasi dapat menyebabkan data slot baru gagal diverifikasi selama proses update, dan oleh karena itu update akan gagal.

Mengonfigurasi setelah penginstalan

Anda dapat mengonfigurasi langkah postinstall secara berbeda untuk setiap partisi yang diupdate menggunakan serangkaian pasangan nilai kunci. Untuk menjalankan program yang berada 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 panggilan sistem mount(2). Tambahkan kode berikut ke file .mk produk atau perangkat (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 perangkat dimulai ulang dengan image sistem baru. Untuk mengompilasi aplikasi di latar belakang, tambahkan kode berikut ke konfigurasi perangkat produk (di product.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-penginstalan. 
      # 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 telah dioptimalkan di partisi sistem kedua yang tidak digunakan, lihat Penginstalan booting pertama file DEX_PREOPT.