Tata letak partisi

Di Android 10, sistem file root tidak lagi disertakan dalam ramdisk.img dan malah digabungkan ke system.img (yaitu, system.img selalu dibuat seolah-olah BOARD_BUILD_SYSTEM_ROOT_IMAGE telah disetel). Perangkat yang diluncurkan dengan Android 10:

• Gunakan tata letak partisi sistem-sebagai-root (diterapkan secara otomatis oleh build tanpa opsi untuk mengubah perilaku).
• Harus menggunakan ramdisk, yang diperlukan untuk dm-linear.
• Harus menetapkan BOARD_BUILD_SYSTEM_ROOT_IMAGE ke false. Setelan ini hanya digunakan untuk membedakan antara perangkat yang menggunakan ramdisk dan perangkat yang tidak menggunakan ramdisk (dan sebagai gantinya, memasang system.img secara langsung).

Arti konfigurasi system-as-root berbeda antara Android 9 dan Android 10. Dalam konfigurasi system-as-root Android 9, BOARD_BUILD_SYSTEM_ROOT_IMAGE disetel ke true, yang memaksa build untuk menggabungkan sistem file root ke system.img, lalu memasang system.img sebagai sistem file root (rootfs). Konfigurasi ini wajib untuk perangkat yang diluncurkan dengan Android 9, tetapi opsional untuk perangkat yang diupgrade ke Android 9 dan untuk perangkat yang menjalankan Android versi yang lebih rendah. Dalam konfigurasi system-as-root Android 10, build selalu menggabungkan $TARGET_SYSTEM_OUT dan $TARGET_ROOT_OUT ke dalam system.img; konfigurasi ini adalah perilaku default untuk semua perangkat yang menjalankan Android 10.

Android 10 melakukan perubahan lebih lanjut untuk mendukung partisi dinamis, sistem partisi ruang pengguna yang memungkinkan update over-the-air (OTA) untuk membuat, mengubah ukuran, atau menghapus partisi. Sebagai bagian dari perubahan ini, kernel Linux tidak dapat lagi memasang partisi sistem logis di perangkat yang menjalankan Android 10, sehingga operasi ini ditangani oleh init tahap pertama.

Bagian berikut menjelaskan persyaratan system-as-root untuk OTA khusus sistem, memberikan panduan tentang cara mengupdate perangkat untuk menggunakan system-as-root (termasuk perubahan tata letak partisi dan persyaratan kernel dm-verity). Untuk detail perubahan pada ramdisk, lihat Partisi Ramdisk.

Tentang OTA khusus sistem

OTA khusus sistem, yang memungkinkan rilis Android mengupdate system.img dan product.img tanpa mengubah partisi lain, memerlukan tata letak partisi sistem-sebagai-root. Semua perangkat yang menjalankan Android 10 harus menggunakan tata letak partisi system-as-root untuk mengaktifkan OTA khusus sistem.

• Perangkat A/B, yang memasang partisi system sebagai rootfs, sudah menggunakan system-as-root dan tidak memerlukan perubahan untuk mendukung OTA sistem.
• Perangkat non-A/B, yang memasang partisi system di /system, harus diupdate untuk menggunakan tata letak partisi system-as-root guna mendukung OTA sistem.

Untuk mengetahui detail tentang perangkat A/B dan non-A/B, lihat Update Sistem A/B (Seamless).

Menggunakan overlay vendor (<=AOSP 14)

Overlay vendor memungkinkan Anda meng-overlay perubahan pada partisi vendor saat perangkat di-boot. Overlay vendor adalah sekumpulan modul vendor di partisi product yang di-overlay pada partisi vendor saat perangkat melakukan booting, menggantikan dan menambahkan modul yang ada.

Saat perangkat melakukan booting, proses init akan menyelesaikan pemasangan tahap pertama dan membaca properti default. Kemudian, direktori tersebut akan menelusuri /product/vendor_overlay/<target_vendor_version> dan me-mount setiap subdirektori di direktori partisi vendor yang sesuai, jika kondisi berikut terpenuhi:

• /vendor/<overlay_dir> ada.
• /product/vendor_overlay/<target_vendor_version>/<overlay_dir> memiliki konteks file yang sama dengan /vendor/<overlay_dir>.
• init diizinkan untuk di-mount pada konteks file /vendor/<overlay_dir>.

Menerapkan overlay vendor

Instal file overlay vendor di /product/vendor_overlay/<target_vendor_version>. File tersebut akan menggantikan partisi vendor saat perangkat melakukan booting, menggantikan file dengan nama yang sama dan menambahkan file baru. Overlay vendor tidak dapat menghapus file dari partisi vendor.

File overlay vendor harus memiliki konteks file yang sama dengan file target yang digantikannya di partisi vendor. Secara default, file di direktori /product/vendor_overlay/<target_vendor_version> memiliki konteks vendor_file. Jika ada ketidakcocokan konteks file antara file overlay vendor dan file yang digantikannya, tentukan hal tersebut di sepolicy khusus perangkat. Konteks file ditetapkan di tingkat direktori. Jika konteks file direktori overlay vendor tidak cocok dengan direktori target, dan konteks file yang benar tidak ditentukan dalam sepolicy khusus perangkat, direktori overlay vendor tersebut tidak akan di-overlay ke direktori target.

Untuk menggunakan overlay vendor, kernel harus mengaktifkan OverlayFS dengan menyetel CONFIG_OVERLAY_FS=y. Selain itu, kernel harus digabungkan dari kernel umum 4.4 atau yang lebih baru, atau di-patch dengan "overlayfs: override_creds=off option bypass creator_cred".

Contoh penerapan overlay vendor

Prosedur ini menunjukkan penerapan overlay vendor yang melapisi direktori /vendor/lib/*, /vendor/etc/*, dan /vendor/app/*.

1. Tambahkan file vendor bawaan di device/<vendor>/<target>/vendor_overlay/<target_vendor_version>/:

   device/google/device/vendor_overlay/28/lib/libfoo.so
   device/google/device/vendor_overlay/28/lib/libbar.so
   device/google/device/vendor_overlay/28/etc/baz.xml
   device/google/device/vendor_overlay/28/app/qux.apk

2. Instal file vendor yang telah dibuat sebelumnya ke product/vendor_overlay di device/google/device/device.mk:

   PRODUCT_COPY_FILES += \
       $(call find-copy-subdir-files,*,device/google/device/vendor_overlay,$(TARGET_COPY_OUT_PRODUCT)/vendor_overlay)

3. Tentukan konteks file jika file partisi vendor target memiliki konteks selain vendor_file. Karena /vendor/lib/* menggunakan konteks vendor_file, contoh ini tidak menyertakan direktori tersebut.

   Tambahkan kode berikut ke device/google/device-sepolicy/private/file_contexts:

   /(product|system/product)/vendor_overlay/[0-9]+/etc(/.*)?   u:object_r:vendor_configs_file:s0
   /(product|system/product)/vendor_overlay/[0-9]+/app(/.*)?   u:object_r:vendor_app_file:s0

4. Izinkan proses init untuk memasang overlay vendor pada konteks file selain vendor_file. Karena proses init sudah memiliki izin untuk melakukan pemasangan pada konteks vendor_file, contoh ini tidak menentukan kebijakan untuk vendor_file.

   Tambahkan kode berikut ke device/google/device-sepolicy/public/init.te:

   allow init vendor_configs_file:dir mounton;
   allow init vendor_app_file:dir mounton;

Validasi overlay vendor

Untuk memvalidasi konfigurasi overlay vendor, tambahkan file di /product/vendor_overlay/<target_vendor_version>/<overlay_dir> dan periksa apakah file tersebut di-overlay pada file di /vendor/<overlay_dir>.

Untuk build userdebug, ada modul pengujian untuk Atest:

$ atest -v fs_mgr_vendor_overlay_test

Update ke system-as-root

Untuk mengupdate perangkat non-A/B agar menggunakan system-as-root, Anda harus mengupdate skema partisi untuk boot.img dan system.img, menyiapkan dm-verity, dan menghapus dependensi booting pada folder root khusus perangkat.

Memperbarui partisi

Tidak seperti perangkat A/B yang menggunakan kembali /boot sebagai partisi pemulihan, perangkat non-A/B harus memisahkan partisi /recovery karena tidak memiliki partisi slot penggantian (misalnya, dari boot_a ke boot_b). Jika /recovery dihapus di perangkat non-A/B dan dibuat serupa dengan skema A/B, mode pemulihan dapat rusak selama update yang gagal ke partisi /boot. Oleh karena itu, partisi /recovery harus menjadi partisi terpisah dari /boot untuk perangkat non-A/B, yang berarti image pemulihan terus diupdate secara tertunda (yaitu, sama seperti pada perangkat yang menjalankan Android 8.1.0 atau yang lebih lama).

Tabel berikut mencantumkan perbedaan partisi image untuk perangkat non-A/B sebelum dan setelah Android 9.

ramdisk.img
  -/
    - init.rc
    - init
    - etc -> /system/etc
    - system/ (mount point)
    - vendor/ (mount point)
    - odm/ (mount point)
    ...

system.img
  -/
    - bin/
    - etc
    - vendor -> /vendor
    - ...

system.img
  -/
    - init.rc
    - init
    - etc -> /system/etc
    - system/
      - bin/
      - etc/
      - vendor -> /vendor
      - ...
    - vendor/ (mount point)
    - odm/ (mount point)
    ...

Partisi itu sendiri tidak berubah; ramdisk dan system-as-root menggunakan skema partisi berikut:

• /boot
• /system
• /system
• /recovery
• /vendor, dll.

Menyiapkan dm-verity

Dalam system-as-root, kernel harus memasang system.img di bawah / (direktori pemasangan) dengan dm-verity. AOSP mendukung penerapan dm-verity berikut untuk system.img.

vboot 1.0

Untuk vboot 1.0, kernel harus mem-parse metadata khusus Android di /system, lalu mengonversi ke parameter dm-verity untuk menyiapkan dm-verity (memerlukan patch kernel ini). Contoh berikut menunjukkan setelan terkait dm-verity untuk system-as-root di command line kernel:

ro root=/dev/dm-0 rootwait skip_initramfs init=/init
dm="system none ro,0 1 android-verity /dev/sda34"
veritykeyid=id:7e4333f9bba00adfe0ede979e28ed1920492b40f

vboot 2.0

Untuk vboot 2.0 (AVB), bootloader harus mengintegrasikan external/avb/libavb, yang kemudian mengurai deskriptor hashtree untuk /system, mengonversinya menjadi parameter dm-verity, dan akhirnya meneruskan parameter ke kernel melalui command line kernel. (Deskriptor hashtree /system mungkin ada di /vbmeta atau di /system itu sendiri.)

vboot 2.0 memerlukan patch kernel berikut:

• https://android-review.googlesource.com/#/c/kernel/common/+/158491/
• patch kernel 4.4, patch kernel 4.9, dll.

Contoh berikut menunjukkan setelan terkait dm-verity untuk system-as-root di command line kernel:

ro root=/dev/dm-0 rootwait  skip_initramfs init=/init

dm="1 vroot none ro 1,0 5159992 verity 1
PARTUUID=00000016-0000-0000-0000-000000000000
PARTUUID=00000016-0000-0000-0000-000000000000 4096 4096 644999 644999
sha1 d80b4a8be3b58a8ab86fad1b498640892d4843a2
8d08feed2f55c418fb63447fec0d32b1b107e42c 10 restart_on_corruption
ignore_zero_blocks use_fec_from_device
PARTUUID=00000016-0000-0000-0000-000000000000 fec_roots 2 fec_blocks
650080 fec_start 650080"

Menggunakan folder root khusus perangkat

Dengan system-as-root, setelah generic system image (GSI) di-flash di perangkat (dan sebelum menjalankan pengujian Vendor Test Suite), semua folder root khusus perangkat yang ditambahkan dengan BOARD_ROOT_EXTRA_FOLDERS akan hilang karena seluruh konten direktori root telah digantikan oleh GSI system-as-root. Penghapusan folder ini dapat menyebabkan perangkat tidak dapat di-boot jika ada dependensi pada folder root khusus perangkat (misalnya, digunakan sebagai titik pemasangan).

Untuk menghindari masalah ini, jangan gunakan BOARD_ROOT_EXTRA_FOLDERS untuk menambahkan folder root khusus perangkat. Jika Anda perlu menentukan titik pemasangan khusus perangkat, gunakan /mnt/vendor/<mount point> (ditambahkan dalam daftar perubahan ini). Titik pemasangan khusus vendor ini dapat ditentukan secara langsung di pohon perangkat fstab (untuk pemasangan tahap pertama) dan file /vendor/etc/fstab.{ro.hardware} tanpa penyiapan tambahan (karena fs_mgr membuatnya di bawah /mnt/vendor/* secara otomatis).