OTA untuk perangkat A/B dengan partisi dinamis

Android 10 mendukung partisi dinamis, sistem partisi ruang pengguna yang dapat membuat, mengubah ukuran, dan menghancurkan partisi selama update over-the-air (OTA).

Halaman ini menjelaskan cara mengubah ukuran partisi dinamis selama update untuk perangkat A/B yang diluncurkan dengan dukungan partisi dinamis, untuk perangkat yang menjalankan Android 9 dan yang lebih rendah.

Latar belakang

Ada satu partisi super di perangkat. Partisi ini tidak memiliki akhiran slot. Perangkat blok harus ada bersama dengan entri blk_device untuk /misc di fstab. Misalnya, jika file fstab mencantumkan:

/dev/block/bootdevice/by-name/misc    /misc    # Other fields

Maka perangkat blok untuk super harus ada di /dev/block/bootdevice/by-name/super, tetapi partisi super tidak perlu dicantumkan dalam file fstab.

Di partisi super, ada dua slot metadata, yang diberi nomor 0 dan 1, yang sesuai dengan slot A/B untuk partisi. Di halaman ini, slot metadata disebut Metadata S (sumber) dan Metadata T (target). Demikian pula, partisi disebut sebagai system_s, vendor_t, dan sebagainya.

Sebelum upgrade, Metadata S berisi informasi untuk partisi dinamis yang digunakan (biasanya, system_s, vendor_s, product_s, dan sebagainya). Sistem membaca rentang untuk partisi ini selama update, sehingga tidak dapat dihapus.

Partisi milik grup update. Lihat Menerapkan Partisi Dinamis untuk mengetahui detailnya.

Contoh metadata di perangkat adalah sebagai berikut.

• Metadata 0
  • Grup foo_a
    • Partisi system_a
    • Partisi product_services_a
    • Partisi lain yang diupdate oleh Foo
  • Grup bar_a
    • Partisi vendor_a
    • Partisi product_a
    • Partisi lain yang diupdate oleh Bar
  • Grup foo_b (sisa dari upgrade sebelumnya)
  • Grup bar_b (sisa dari upgrade sebelumnya)
• Metadata 1
  • Grup foo_a (sisa dari upgrade sebelumnya)
  • Grup bar_a (sisa dari upgrade sebelumnya)
  • Grup foo_b
    • Partisi system_b
    • Partisi product_services_b
    • Partisi lain yang diupdate oleh Foo
  • Grup bar_b
    • Partisi vendor_b
    • Partisi product_b
    • Partisi lain yang diupdate oleh Bar

Anda dapat menggunakan alat lpdump (kode sumber di bagian system/extras/partition_tools) untuk membuang metadata di perangkat Anda. Contoh:

lpdump --slot 0 /dev/block/bootdevice/by-name/super
lpdump --slot 1 /dev/block/bootdevice/by-name/super

Alur update

1. Menginisialisasi metadata partisi super
   1. Muat rentang untuk partisi dinamis sumber dari Metadata S. Misalkan M adalah metadata yang dimuat.
   2. Hapus grup dan partisi target (misalnya, foo_t, bar_t) dari M sehingga M berisi hanya partisi dan grup dengan akhiran _s.
   3. Tambahkan grup dan partisi target sesuai dengan dynamic_partition_metadata kolom dalam manifes update.
      Ukuran setiap partisi dapat ditemukan di new_partition_info.
   4. Tulis M ke Metadata T.
   5. Petakan partisi yang ditambahkan pada pemeta perangkat sebagai dapat ditulis.
2. Terapkan update pada perangkat blok.
   1. Jika perlu, petakan partisi sumber pada pemeta perangkat sebagai hanya baca. Hal ini diperlukan untuk sideloading karena partisi sumber tidak dipetakan sebelum update.
   2. Terapkan update penuh atau delta ke semua perangkat blok di slot target.
   3. Pasang partisi untuk menjalankan skrip pasca-penginstalan, lalu unmount partisi.
3. Batalkan pemetaan partisi target.

Sebelum dan sesudah update, properti sistem berikut harus memiliki nilai masing-masing:

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

Menambahkan grup dan partisi ke manifes update

Saat melakukan update OTA pada perangkat A/B dengan partisi dinamis, atau perangkat A/B yang menambahkan dukungan untuk partisi dinamis, Anda harus menambahkan grup dan partisi ke manifes update. Cuplikan di bawah menunjukkan informasi tambahan tentang manifes update untuk mendukung partisi dinamis. Lihat update_metadata.proto untuk dokumentasi mendetail tentang setiap kolom.

message DeltaArchiveManifest {
    optional DynamicPartitionMetadata dynamic_partition_metadata;
}

message DynamicPartitionMetadata {
    repeated DynamicPartitionGroup groups;
}

message DynamicPartitionGroup {
    required string name;
    optional uint64 size; // maximum size of group
    repeated string partition_names;
}