Partisi booting umum

Di Android 12, image boot generik, yang disebut sebagai Generic Kernel Image (GKI), berisi ramdisk generik dan kernel GKI.

Untuk perangkat yang diluncurkan dengan Android 13, ramdisk generik akan dihapus dari image boot dan ditempatkan dalam image init_boot terpisah. Perubahan ini membiarkan image boot hanya dengan kernel GKI.

Untuk mengupgrade perangkat yang terus menggunakan Android 12 atau versi kernel yang lebih lama, ramdisk generik tetap berada di tempatnya tanpa persyaratan untuk image init_boot baru.

Untuk mem-build ramdisk generik, pindahkan resource khusus vendor dari ramdisk sehingga ramdisk generik hanya berisi init tahap pertama dan file properti yang berisi informasi stempel waktu.

Di perangkat yang:

  • Jangan gunakan partisi recovery khusus, semua bit pemulihan akan dipindahkan dari ramdisk generik ke ramdisk vendor_boot.

  • Gunakan partisi recovery khusus, tidak ada perubahan pada ramdisk recovery yang diperlukan karena ramdisk recovery bersifat mandiri.

Arsitektur

Diagram berikut mengilustrasikan arsitektur untuk perangkat yang menjalankan Android 12 dan yang lebih baru. Perangkat yang diluncurkan dengan Android 13 memiliki image init_boot baru yang berisi ramdisk generik. Perangkat yang diupgrade dari Android 12 ke Android 13 menggunakan arsitektur yang sama seperti pada Android 12.

Luncurkan dengan Android 13, tanpa pemulihan khusus

Meluncurkan/mengupgrade perangkat, GKI, tidak ada pemulihan khusus

Gambar 1. Perangkat yang diluncurkan atau diupgrade ke Android 13, dengan GKI, tanpa pemulihan khusus.

Diluncurkan dengan Android 13, pemulihan khusus dan A/B (ramdisk khusus)

Meluncurkan/mengupgrade perangkat, GKI, pemulihan khusus, dan A/B

Gambar 2. Perangkat yang diluncurkan atau diupgrade ke Android 13, dengan GKI, pemulihan khusus, dan A/B.

Lihat gambar ini jika perangkat memiliki partisi recovery_a dan recovery_b.

Meluncurkan dengan Android 13, pemulihan khusus dan non-A/B (ramdisk khusus)

Meluncurkan/mengupgrade perangkat, GKI, pemulihan khusus, dan non-A/B

Gambar 3. Perangkat yang diluncurkan atau diupgrade ke Android 13, dengan GKI, pemulihan khusus dan non-A/B.

Lihat gambar ini jika perangkat memiliki partisi bernama recovery tanpa akhiran slot.

Luncurkan atau upgrade ke Android 12, tanpa pemulihan khusus

Luncurkan/upgrade perangkat, GKI, tanpa pemulihan khusus

Gambar 4. Perangkat yang diluncurkan atau diupgrade ke Android 12, dengan GKI, tanpa pemulihan khusus.

Meluncurkan atau mengupgrade ke Android 12, pemulihan khusus dan A/B (ramdisk khusus)

Luncurkan/upgrade perangkat, GKI, pemulihan A/B khusus dan A/B

Gambar 5. Perangkat yang diluncurkan atau diupgrade ke Android 12, dengan GKI, khusus, dan pemulihan A/B.

Lihat gambar ini jika perangkat memiliki partisi recovery_a dan recovery_b.

Meluncurkan atau mengupgrade ke Android 12, pemulihan khusus dan non-A/B (ramdisk khusus)

Meluncurkan/mengupgrade perangkat, GKI, pemulihan khusus, dan non-A/B

Gambar 6. Perangkat yang diluncurkan atau diupgrade ke Android 12, dengan GKI, pemulihan khusus, dan non-A/B.

Lihat gambar ini jika perangkat memiliki partisi bernama recovery tanpa akhiran slot.

Mengupgrade ke Android 12, recovery-as-boot (recovery-as-ramdisk)

Luncurkan/upgrade perangkat, tanpa GKI, recovery-as-boot

Gambar 7. Perangkat yang diupgrade ke Android 12, tanpa GKI, recovery-as-boot.

Upgrade ke Android 12, pemulihan khusus (ramdisk khusus)

Meluncurkan/mengupgrade perangkat, tanpa GKI, pemulihan khusus

Gambar 8. Perangkat yang diupgrade ke Android 12, tanpa GKI, pemulihan khusus.

Konten image booting

Image booting Android berisi hal berikut.

  • init_boot gambar ditambahkan untuk perangkat yang diluncurkan dengan Android 13

    • Versi header V4
    • Image ramdisk generik

  • Gambar boot generik

    • Header versi V3 atau V4
      • boot_signature untuk sertifikasi boot.img GKI (khusus v4). boot.img GKI yang tersertifikasi tidak ditandatangani untuk booting terverifikasi. OEM tetap harus menandatangani boot.img bawaan dengan kunci AVB khusus perangkat.
      • cmdline Generik (GENERIC_KERNEL_CMDLINE)
      • Kernel GKI
    • Gambar ramdisk generik
      • Hanya disertakan dalam gambar boot dari Android 12 dan yang lebih lama

  • Image vendor_boot (untuk mengetahui detailnya, lihat Partisi Boot Vendor)

    • Header vendor_boot
      • cmdline khusus perangkat (BOARD_KERNEL_CMDLINE)
    • Gambar ramdisk vendor_boot
      • lib/modules
      • Resource pemulihan (jika tidak ada pemulihan khusus)
    • Gambar dtb

  • Gambar recovery

    • Header versi V2
      • cmdline khusus perangkat untuk pemulihan, jika diperlukan
      • Untuk partisi pemulihan non-A/B, konten header harus mandiri; lihat Gambar Pemulihan. Contoh:
      • cmdline tidak digabungkan ke boot dan vendor_boot cmdline.
      • Header menentukan DTBO pemulihan, jika perlu.
      • Untuk partisi pemulihan A/B, konten dapat digabungkan atau disimpulkan dari boot dan vendor_boot. Contoh:
      • cmdline digabungkan ke boot dan vendor_boot cmdline.
      • DTBO dapat disimpulkan dari header vendor_boot.
    • Gambar ramdisk recovery
      • Referensi pemulihan
      • Untuk partisi pemulihan non-A/B, konten ramdisk harus mandiri; lihat Gambar Pemulihan. Contoh:
      • lib/modules harus berisi semua modul kernel yang diperlukan untuk mem-boot mode pemulihan
      • Ramdisk pemulihan harus berisi init.
      • Untuk partisi pemulihan A/B, ramdisk pemulihan ditambahkan ke ramdisk generik dan vendor_boot, sehingga tidak perlu mandiri. Contoh:
      • lib/modules mungkin hanya berisi modul kernel tambahan yang diperlukan untuk mem-booting mode pemulihan selain modul kernel di ramdisk vendor_boot.
      • Symlink di /init mungkin ada, tetapi dibayangi oleh biner /init tahap pertama dalam image booting.

Konten image ramdisk generik

Ramdisk generik berisi komponen berikut.

  • init
  • system/etc/ramdisk/build.prop
  • ro.PRODUCT.bootimg.* build properti
  • Direktori kosong untuk titik pemasangan: debug_ramdisk/, mnt/, dev/, sys/, proc/, metadata/
  • first_stage_ramdisk/
    • Direktori kosong duplikat untuk titik pemasangan: debug_ramdisk/, mnt/, dev/, sys/, proc/, metadata/

Integrasi image booting

Flag build mengontrol cara pembuatan image init_boot, boot, recovery, dan vendor_boot. Nilai variabel papan boolean harus berupa string true atau kosong (yang merupakan default).

  • TARGET_NO_KERNEL. Variabel ini menunjukkan apakah build menggunakan image booting bawaan. Jika variabel ini ditetapkan ke true, tetapkan BOARD_PREBUILT_BOOTIMAGE ke lokasi boot image bawaan (BOARD_PREBUILT_BOOTIMAGE:= device/${company}/${board}/boot.img)

  • BOARD_USES_RECOVERY_AS_BOOT. Variabel ini menunjukkan apakah perangkat menggunakan gambar recovery sebagai gambar boot. Saat menggunakan GKI, variabel ini kosong dan resource pemulihan harus dipindahkan ke vendor_boot.

  • BOARD_USES_GENERIC_KERNEL_IMAGE. Variabel ini menunjukkan bahwa board menggunakan GKI. Variabel ini tidak memengaruhi sysprops atau PRODUCT_PACKAGES.

    Ini adalah tombol GKI tingkat board; semua variabel berikut dibatasi oleh variabel ini.

  • BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT. Variabel ini mengontrol apakah resource pemulihan ramdisk di-build ke vendor_boot.

    • Jika ditetapkan ke true, resource pemulihan hanya di-build untuk vendor-ramdisk/ dan tidak di-build untuk recovery/root/.

    • Jika kosong, resource pemulihan hanya di-build ke recovery/root/ dan tidak di-build ke vendor-ramdisk/.

  • BOARD_MOVE_GSI_AVB_KEYS_TO_VENDOR_BOOT. Variabel ini mengontrol apakah kunci AVB GSI di-build ke vendor_boot.

    • Jika ditetapkan ke true, jika BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT:

      • Jika ditetapkan, kunci AVB GSI akan dibuat ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/first_stage_ramdisk/avb.

      • Tidak ditetapkan, kunci AVB GSI di-build ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/avb.

    • Saat kosong, jika BOARD_RECOVERY_AS_ROOT:

      • Jika ditetapkan, kunci AVB GSI akan dibuat ke $ANDROID_PRODUCT_OUT/recovery/root/first_stage_ramdisk/avb.

      • Tidak ditetapkan, kunci AVB GSI di-build ke $ANDROID_PRODUCT_OUT/ramdisk/avb.

  • BOARD_EXCLUDE_KERNEL_FROM_RECOVERY_IMAGE. Variabel ini mengontrol apakah gambar recovery berisi kernel atau tidak. Perangkat yang diluncurkan dengan Android 12 dan menggunakan partisi recovery A/B harus menetapkan variabel ini ke true. Perangkat yang diluncurkan dengan Android 12 dan menggunakan non-A/B harus menetapkan variabel ini ke false agar image pemulihan tetap mandiri.

  • BOARD_COPY_BOOT_IMAGE_TO_TARGET_FILES. Variabel ini mengontrol apakah $OUT/boot*.img disalin ke IMAGES/ di bagian file target.

    • aosp_arm64 harus menetapkan variabel ini ke true.

    • Perangkat lain harus mengosongkan variabel ini.

  • BOARD_INIT_BOOT_IMAGE_PARTITION_SIZE. Variabel ini mengontrol apakah init_boot.img dibuat dan menetapkan ukurannya. Jika ditetapkan, ramdisk generik akan ditambahkan ke init_boot.img, bukan boot.img, dan memerlukan variabel BOARD_AVB_INIT_BOOT* untuk ditetapkan untuk vbmeta berantai.

Kombinasi yang diizinkan

Komponen atau variabel Mengupgrade perangkat tanpa partisi pemulihan Mengupgrade perangkat dengan partisi pemulihan Meluncurkan perangkat tanpa partisi pemulihan Meluncurkan perangkat dengan partisi pemulihan A/B Meluncurkan perangkat dengan partisi pemulihan non-A/B aosp_arm64
Berisi boot ya ya ya ya ya ya
Berisi init_boot (Android 13) no tidak ya ya ya ya
Berisi vendor_boot opsional opsional ya ya ya no
Berisi recovery no ya no ya ya no
BOARD_USES_RECOVERY_AS_BOOT true kosong kosong kosong kosong kosong
BOARD_USES_GENERIC_KERNEL_IMAGE kosong kosong true true true true
PRODUCT_BUILD_RECOVERY_IMAGE kosong true atau kosong kosong true atau kosong true atau kosong kosong
BOARD_RECOVERYIMAGE_PARTITION_SIZE kosong > 0 kosong > 0 > 0 kosong
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT kosong kosong true kosong kosong kosong
BOARD_MOVE_GSI_AVB_KEYS_TO_VENDOR_BOOT kosong kosong true true true kosong
BOARD_EXCLUDE_KERNEL_FROM_RECOVERY_IMAGE kosong kosong kosong true kosong kosong
BOARD_COPY_BOOT_IMAGE_TO_TARGET_FILES kosong kosong kosong kosong kosong true

Perangkat dengan partisi recovery khusus dapat menetapkan PRODUCT_BUILD_RECOVERY_IMAGE ke true atau kosong. Untuk perangkat ini, jika BOARD_RECOVERYIMAGE_PARTITION_SIZE ditetapkan, image recovery akan di-build.

Mengaktifkan vbmeta berantai untuk booting

vbmeta berantai harus diaktifkan untuk image boot dan init_boot. Tentukan hal berikut:

BOARD_AVB_BOOT_KEY_PATH := external/avb/test/data/testkey_rsa4096.pem
BOARD_AVB_BOOT_ALGORITHM := SHA256_RSA4096
BOARD_AVB_BOOT_ROLLBACK_INDEX := $(PLATFORM_SECURITY_PATCH_TIMESTAMP)
BOARD_AVB_BOOT_ROLLBACK_INDEX_LOCATION := 2

BOARD_AVB_INIT_BOOT_KEY_PATH := external/avb/test/data/testkey_rsa2048.pem
BOARD_AVB_INIT_BOOT_ALGORITHM := SHA256_RSA2048
BOARD_AVB_INIT_BOOT_ROLLBACK_INDEX := $(PLATFORM_SECURITY_PATCH_TIMESTAMP)
BOARD_AVB_INIT_BOOT_ROLLBACK_INDEX_LOCATION := 3

Sebagai contoh, lihat perubahan ini.

Sistem-sebagai-root

Sistem sebagai root tidak didukung untuk perangkat yang menggunakan GKI. Pada perangkat tersebut, BOARD_BUILD_SYSTEM_ROOT_IMAGE harus kosong. Sistem sebagai root juga tidak didukung untuk perangkat yang menggunakan partisi dinamis.

Konfigurasi produk

Perangkat yang menggunakan ramdisk generik harus menginstal daftar file yang diizinkan untuk diinstal ke ramdisk. Untuk melakukannya, tentukan hal berikut di device.mk:

$(call inherit-product, $(SRC_TARGET_DIR)/product/generic_ramdisk.mk)

File generic_ramdisk.mk juga mencegah makefile lain menginstal file lain secara tidak sengaja ke ramdisk (pindahkan file tersebut ke vendor_ramdisk sebagai gantinya).

Menyiapkan perangkat

Petunjuk penyiapan berbeda-beda untuk setiap perangkat yang diluncurkan dengan Android 13, mengupgrade ke Android 12, dan meluncurkan dengan Android 12. Android 13, penyiapannya mirip dengan Android 12

  • Perangkat yang Mengupgrade ke Android 12:

    • Dapat mempertahankan nilai BOARD_USES_RECOVERY_AS_BOOT. Jika mereka melakukannya, mereka menggunakan konfigurasi lama dan variabel build baru harus kosong. Jika perangkat tersebut:

      • Tetapkan BOARD_USES_RECOVERY_AS_BOOT ke true, arsitekturnya seperti yang ditunjukkan pada Gambar 3.

      • Tetapkan BOARD_USES_RECOVERY_AS_BOOT ke kosong, arsitekturnya seperti yang ditunjukkan Gambar 4.

    • Dapat menetapkan BOARD_USES_RECOVERY_AS_BOOT ke kosong. Jika melakukannya, mereka menggunakan konfigurasi baru. Jika perangkat tersebut:

      • Jangan gunakan partisi recovery khusus, arsitekturnya seperti yang ditunjukkan dalam Gambar 1 dan opsi penyiapan perangkat adalah Opsi 1.

      • Gunakan partisi recovery khusus, arsitekturnya seperti yang ditunjukkan dalam Gambar 2a atau Gambar 2b dan opsi penyiapan perangkat adalah Opsi 2a atau Opsi 2b.

  • Perangkat yang diluncurkan dengan Android 12 harus menyetel BOARD_USES_RECOVERY_AS_BOOT ke kosong dan menggunakan konfigurasi baru. Jika perangkat tersebut:

    • Jangan gunakan partisi recovery khusus, arsitekturnya seperti yang ditunjukkan pada Gambar 1 dan opsi penyiapan perangkat adalah Opsi 1.

    • Gunakan partisi recovery khusus, arsitekturnya seperti yang ditunjukkan dalam Gambar 2a atau Gambar 2b dan opsi penyiapan perangkat adalah Opsi 2a atau Opsi 2b.

Karena aosp_arm64 hanya mem-build GKI (dan bukan vendor_boot atau pemulihan), aosp_arm64 bukanlah target yang lengkap. Untuk konfigurasi build aosp_arm64, lihat generic_arm64.

Opsi 1: Tidak ada partisi pemulihan khusus

Perangkat tanpa partisi recovery berisi image boot generik di partisi boot. Ramdisk vendor_boot berisi semua resource pemulihan, termasuk lib/modules (dengan modul kernel vendor). Pada perangkat tersebut, konfigurasi produk mewarisi dari generic_ramdisk.mk.

Menetapkan nilai BOARD

Tetapkan nilai berikut:

BOARD_USES_RECOVERY_AS_BOOT :=
BOARD_USES_GENERIC_KERNEL_IMAGE := true
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true
BOARD_EXCLUDE_KERNEL_FROM_RECOVERY_IMAGE :=
BOARD_MOVE_GSI_AVB_KEYS_TO_VENDOR_BOOT := true

Ramdisk vendor_boot dapat berisi symlink /init ke /system/bin/init, dan init_second_stage.recovery di /system/bin/init. Namun, karena ramdisk generik digabungkan setelah ramdisk vendor_boot, symlink /init akan ditimpa. Saat perangkat melakukan booting ke pemulihan, biner /system/bin/init diperlukan untuk mendukung init tahap kedua. Konten vendor_boot + ramdisk generik adalah sebagai berikut:

  • /init (dari ramdisk generik, di-build dari init_first_stage)
  • /system/bin/init (dari vendor_ramdisk, di-build dari init_second_stage.recovery)

Memindahkan file fstab

Pindahkan semua file fstab yang diinstal ke ramdisk generik ke vendor_ramdisk. Sebagai contoh, lihat perubahan ini.

Menginstal modul

Anda dapat menginstal modul khusus perangkat ke vendor_ramdisk (lewati langkah ini jika Anda tidak memiliki modul khusus perangkat untuk diinstal).

  • Gunakan varian modul vendor_ramdisk saat modul diinstal ke /first_stage_ramdisk. Modul ini akan tersedia setelah init mengubah root menjadi /first_stage_ramdisk, tetapi sebelum init mengubah root menjadi /system. Misalnya, lihat Checksum metadata dan Kompresi A/B virtual.

  • Gunakan varian modul recovery saat modul diinstal ke /. Modul ini akan tersedia sebelum init mengalihkan root ke /first_stage_ramdisk. Untuk mengetahui detail tentang cara menginstal modul ke /, lihat Konsol tahap pertama.

Konsol tahap pertama

Karena konsol tahap pertama dimulai sebelum init mengalihkan root ke /first_stage_ramdisk, Anda perlu menginstal varian modul recovery. Secara default, kedua varian modul diinstal ke build/make/target/product/base_vendor.mk, jadi jika makefile perangkat mewarisi dari file tersebut, Anda tidak perlu menginstal varian recovery secara eksplisit.

Untuk menginstal modul pemulihan secara eksplisit, gunakan hal berikut.

PRODUCT_PACKAGES += \
    linker.recovery \
    shell_and_utilities_recovery \

Tindakan ini memastikan bahwa linker, sh, dan toybox diinstal ke $ANDROID_PRODUCT_OUT/recovery/root/system/bin, yang kemudian diinstal ke /system/bin di bagian vendor_ramdisk.

Guna menambahkan modul yang diperlukan untuk konsol tahap pertama (misalnya, adbd), gunakan cara berikut.

PRODUCT_PACKAGES += adbd.recovery

Cara ini memastikan bahwa modul yang ditentukan diinstal ke $ANDROID_PRODUCT_OUT/recovery/root/system/bin, yang kemudian diinstal ke /system/bin di vendor_ramdisk.

Checksum metadata

Untuk mendukung checksum metadata selama pemasangan tahap pertama, perangkat yang tidak mendukung GKI akan menginstal varian ramdisk dari modul berikut. Untuk menambahkan dukungan bagi GKI, pindahkan modul ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/first_stage_ramdisk/system/bin:

PRODUCT_PACKAGES += \
    linker.vendor_ramdisk \
    resize2fs.vendor_ramdisk \
    tune2fs.vendor_ramdisk \

Misalnya, lihat daftar perubahan ini.

Kompresi A/B virtual

Untuk mendukung kompresi A/B virtual, snapuserd harus diinstal ke vendor_ramdisk. Perangkat harus mewarisi dari virtual_ab_ota/compression.mk, yang menginstal varian vendor_ramdisk dari snapuserd.

Perubahan pada proses booting

Proses booting ke mode pemulihan atau ke Android tidak berubah, dengan pengecualian berikut:

  • Ramdisk build.prop berpindah ke /second_stage_resources sehingga tahap kedua init dapat membaca stempel waktu build booting.

Karena resource berpindah dari ramdisk generik ke ramdisk vendor_boot, hasil penggabungan ramdisk generik ke ramdisk vendor_boot tidak berubah.

Menjadikan e2fsck tersedia

File make perangkat dapat diwarisi dari:

  • virtual_ab_ota/launch_with_vendor_ramdisk.mk jika perangkat mendukung A/B virtual tetapi tidak mendukung kompresi.

  • virtual_ab_ota/compression.mk jika perangkat mendukung kompresi A/B virtual.

Makefile produk menginstal $ANDROID_PRODUCT_OUT/vendor-ramdisk/first_stage_ramdisk/system/bin/e2fsck. Pada runtime, init tahap pertama mengalihkan root ke /first_stage_ramdisk, lalu mengeksekusi /system/bin/e2fsck.

Opsi 2a: Partisi khusus dan pemulihan A/B

Gunakan opsi ini untuk perangkat dengan partisi recovery A/B; yaitu, perangkat memiliki recovery_a dan recovery_b partition. Perangkat tersebut mencakup perangkat A/B dan Virtual A/B yang partisi pemulihannya dapat diupdate, dengan konfigurasi berikut:

AB_OTA_PARTITIONS += recovery

Ramdisk vendor_boot berisi bit vendor ramdisk dan modul kernel vendor, termasuk hal berikut:

  • File fstab khusus perangkat

  • lib/modules (termasuk modul kernel vendor)

Ramdisk recovery berisi semua resource pemulihan. Pada perangkat tersebut, konfigurasi produk mewarisi dari generic_ramdisk.mk.

Menetapkan nilai BOARD

Tetapkan nilai berikut untuk perangkat dengan partisi recovery A/B:

BOARD_USES_RECOVERY_AS_BOOT :=
BOARD_USES_GENERIC_KERNEL_IMAGE := true
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT :=
BOARD_EXCLUDE_KERNEL_FROM_RECOVERY_IMAGE := true
BOARD_MOVE_GSI_AVB_KEYS_TO_VENDOR_BOOT := true

Ramdisk recovery dapat berisi symlink /init -> /system/bin/init, dan init_second_stage.recovery di /system/bin/init. Namun, karena ramdisk booting digabungkan setelah ramdisk recovery, symlink /init akan ditimpa. Saat perangkat melakukan booting ke mode pemulihan, biner /system/bin/init diperlukan untuk mendukung inisialisasi tahap kedua.

Saat perangkat melakukan booting ke recovery, konten recovery + vendor_boot + ramdisk generik adalah sebagai berikut:

  • /init (dari ramdisk, di-build dari init_first_stage)
  • /system/bin/init (dari ramdisk recovery, di-build dari init_second_stage.recovery, dan dieksekusi dari /init)

Saat perangkat melakukan booting ke Android, konten vendor_boot + ramdisk generik adalah sebagai berikut:

  • /init (dari ramdisk umum, dibuat dari init_first_stage)

Memindahkan file fstab

Pindahkan file fstab yang diinstal ke ramdisk generik ke vendor_ramdisk. Sebagai contoh, lihat perubahan ini.

Menginstal modul

Secara opsional, Anda dapat menginstal modul khusus perangkat ke vendor_ramdisk (lewati langkah ini jika Anda tidak memiliki modul khusus perangkat untuk diinstal). Init tidak mengalihkan root. Varian modul vendor_ramdisk diinstal ke root vendor_ramdisk. Untuk contoh cara menginstal modul ke vendor_ramdisk, lihat Konsol tahap pertama, Checksum metadata, dan Kompresi A/B virtual.

Konsol tahap pertama

Untuk menginstal varian vendor_ramdisk modul, gunakan hal berikut:

PRODUCT_PACKAGES += \
    linker.vendor_ramdisk \
    shell_and_utilities_vendor_ramdisk \

Hal ini memastikan bahwa linker, sh, dan toybox diinstal ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin, yang kemudian diinstal ke /system/bin di vendor_ramdisk.

Untuk menambahkan modul yang diperlukan untuk konsol tahap pertama (misalnya, adbd), aktifkan varian vendor_ramdisk modul ini dengan mengupload patch yang relevan ke AOSP, lalu gunakan hal berikut,

PRODUCT_PACKAGES += adbd.vendor_ramdisk

Tindakan ini memastikan bahwa modul yang ditentukan diinstal ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin. Jika ramdisk vendor_boot dimuat dalam mode pemulihan, modul juga tersedia di recovery. Jika ramdisk vendor_boot tidak dimuat dalam mode pemulihan, perangkat juga dapat menginstal adbd.recovery secara opsional.

Checksum metadata

Untuk mendukung checksum metadata selama pemasangan tahap pertama, perangkat yang tidak mendukung GKI akan menginstal varian ramdisk dari modul berikut. Guna menambahkan dukungan untuk GKI, pindahkan modul ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin:

PRODUCT_PACKAGES += \
    linker.vendor_ramdisk \
    resize2fs.vendor_ramdisk \
    tune2fs.vendor_ramdisk \

Sebagai contoh, lihat daftar perubahan ini.

Kompresi A/B virtual

Untuk mendukung kompresi Virtual A/B, snapuserd harus diinstal ke vendor_ramdisk. Perangkat harus mewarisi dari virtual_ab_ota/compression.mk, yang menginstal varian vendor_ramdisk dari snapuserd.

Perubahan pada proses booting

Saat melakukan booting ke Android, proses booting tidak berubah. vendor_boot + ramdisk generik mirip dengan proses booting yang ada, kecuali fstab dimuat dari vendor_boot. Karena system/bin/recovery tidak ada, first_stage_init menanganinya sebagai booting normal.

Saat booting ke mode pemulihan, proses booting akan berubah. Ramdisk pemulihan + vendor_boot + ramdisk generik mirip dengan proses pemulihan yang ada, tetapi kernel dimuat dari image boot, bukan dari image recovery. Proses booting untuk mode pemulihan adalah sebagai berikut.

  1. Bootloader dimulai, lalu melakukan hal berikut:

    1. Mendorong pemulihan + vendor_boot + ramdisk generik ke /. (Jika OEM menduplikasi modul kernel di ramdisk pemulihan dengan menambahkannya ke BOARD_RECOVERY_KERNEL_MODULES), vendor_boot bersifat opsional.)
    2. Menjalankan kernel dari partisi boot.

  2. Kernel memasang ramdisk ke /, lalu mengeksekusi /init dari ramdisk generik.

  3. Inisialisasi tahap pertama dimulai, lalu melakukan hal berikut:

    1. Menetapkan IsRecoveryMode() == true dan ForceNormalBoot() == false.
    2. Memuat modul kernel vendor dari /lib/modules.
    3. Memanggil DoFirstStageMount(), tetapi melewati pemasangan karena IsRecoveryMode() == true. (Perangkat tidak mengosongkan ramdisk (karena / masih sama) tetapi memanggil SetInitAvbVersionInRecovery().)
    4. Memulai inisialisasi tahap kedua dari /system/bin/init dari ramdisk recovery.

Menjadikan e2fsck tersedia

File make perangkat dapat diwarisi dari:

  • virtual_ab_ota/launch_with_vendor_ramdisk.mk jika perangkat mendukung A/B virtual tetapi tidak mendukung kompresi.

  • virtual_ab_ota/compression.mk jika perangkat mendukung kompresi A/B virtual.

Makefile produk menginstal $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin/e2fsck. Pada runtime, tahap pertama init mengeksekusi /system/bin/e2fsck.

Opsi 2b: Partisi pemulihan khusus dan non-A/B

Gunakan opsi ini untuk perangkat dengan partisi recovery non-A/B; yaitu, perangkat memiliki partisi bernama recovery tanpa akhiran slot. Perangkat tersebut meliputi:

  • perangkat non-A/B;
  • Perangkat A/B dan Virtual A/B, yang partisi pemulihannya tidak dapat diupdate. (Ini tidak biasa.)

Ramdisk vendor_boot berisi bit vendor dari modul kernel vendor dan ramdisk, termasuk hal berikut:

  • File fstab khusus perangkat
  • lib/modules (termasuk modul kernel vendor)

Image recovery harus mandiri. File ini harus berisi semua resource yang diperlukan untuk mem-booting mode pemulihan, termasuk:

  • Image kernel
  • Gambar DTBO
  • Modul kernel di lib/modules
  • Inisialisasi tahap pertama sebagai symlink /init -> /system/bin/init
  • Biner init tahap kedua /system/bin/init
  • File fstab khusus perangkat
  • Semua resource pemulihan lainnya, termasuk biner recovery

Di perangkat tersebut, konfigurasi produk diwarisi dari generic_ramdisk.mk.

Menetapkan nilai BOARD

Tetapkan nilai berikut untuk perangkat non-A/B:

BOARD_USES_RECOVERY_AS_BOOT :=
BOARD_USES_GENERIC_KERNEL_IMAGE := true
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT :=
BOARD_EXCLUDE_KERNEL_FROM_RECOVERY_IMAGE :=
BOARD_MOVE_GSI_AVB_KEYS_TO_VENDOR_BOOT := true

Ramdisk recovery harus berisi symlink /init -> /system/bin/init, dan init_second_stage.recovery di /system/bin/init. Saat perangkat melakukan booting ke mode pemulihan, biner /system/bin/init diperlukan untuk mendukung init tahap pertama dan tahap kedua.

Saat perangkat melakukan booting ke recovery, isi ramdisk recovery adalah sebagai berikut:

  • /init -> /system/bin/init (dari recovery ramdisk)
  • /system/bin/init (dari ramdisk recovery, di-build dari init_second_stage.recovery, dan dieksekusi dari /init)

Saat perangkat melakukan booting ke Android, konten vendor_boot + ramdisk generik adalah sebagai berikut:

  • /init (dari ramdisk, dibuat dari init_first_stage)

Memindahkan file fstab

Pindahkan file fstab yang diinstal ke ramdisk generik ke ramdisk vendor_ramdisk dan recovery. Sebagai contoh, lihat perubahan ini.

Menginstal modul

Anda dapat menginstal modul khusus perangkat ke ramdisk vendor_ramdisk dan recovery (lewati langkah ini jika Anda tidak memiliki modul khusus perangkat untuk diinstal). init tidak mengalihkan root. Varian vendor_ramdisk modul diinstal ke root vendor_ramdisk. Varian modul recovery diinstal ke root ramdisk recovery. Untuk mengetahui contoh cara menginstal modul ke ramdisk vendor_ramdisk dan recovery, lihat Konsol tahap pertama dan Checksum metadata.

Konsol tahap pertama

Untuk menginstal varian vendor_ramdisk modul, gunakan hal berikut:

PRODUCT_PACKAGES += \
    linker.vendor_ramdisk \
    shell_and_utilities_vendor_ramdisk \

Hal ini memastikan bahwa linker, sh, dan toybox diinstal ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin, yang kemudian diinstal ke /system/bin di vendor_ramdisk.

Untuk menambahkan modul yang diperlukan untuk konsol tahap pertama (misalnya, adbd), aktifkan varian vendor_ramdisk modul ini dengan mengupload patch yang relevan ke AOSP, lalu gunakan hal berikut,

PRODUCT_PACKAGES += adbd.vendor_ramdisk

Cara ini memastikan bahwa modul yang ditentukan diinstal ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin.

Untuk menginstal varian recovery modul, ganti vendor_ramdisk dengan recovery:

PRODUCT_PACKAGES += \
    linker.recovery \
    shell_and_utilities_recovery \
    adbd.recovery \

Checksum metadata

Untuk mendukung checksum metadata selama pemasangan tahap pertama, perangkat yang tidak mendukung GKI akan menginstal varian ramdisk dari modul berikut. Guna menambahkan dukungan untuk GKI, pindahkan modul ke $ANDROID_PRODUCT_OUT/vendor-ramdisk/system/bin:

PRODUCT_PACKAGES += \
    linker.vendor_ramdisk \
    resize2fs.vendor_ramdisk \
    tune2fs.vendor_ramdisk \

Untuk mendukung checksum metadata selama pemasangan tahap pertama dalam pemulihan, aktifkan varian pemulihan modul ini dan instal juga.

Perubahan pada proses booting

Saat melakukan booting ke Android, proses booting tidak berubah. vendor_boot + ramdisk generik mirip dengan proses booting yang ada, kecuali fstab dimuat dari vendor_boot. Karena system/bin/recovery tidak ada, first_stage_init menanganinya sebagai booting normal.

Saat melakukan booting ke mode pemulihan, proses booting tidak berubah. Ramdisk pemulihan dimuat dengan cara yang sama seperti proses pemulihan yang ada. Kernel dimuat dari image recovery. Proses booting untuk mode pemulihan adalah sebagai berikut.

  1. Bootloader dimulai, lalu melakukan hal berikut:

    1. Mendorong ramdisk pemulihan ke /.
    2. Menjalankan kernel dari partisi recovery.

  2. Kernel memasang ramdisk ke /, lalu mengeksekusi /init, yang merupakan symlink ke /system/bin/init dari ramdisk recovery.

  3. Inisialisasi tahap pertama dimulai, lalu melakukan hal berikut:

    1. Menetapkan IsRecoveryMode() == true dan ForceNormalBoot() == false.
    2. Memuat modul kernel vendor dari /lib/modules.
    3. Memanggil DoFirstStageMount(), tetapi melewati pemasangan karena IsRecoveryMode() == true. (Perangkat tidak mengosongkan ramdisk (karena / masih sama) tetapi memanggil SetInitAvbVersionInRecovery().)
    4. Memulai inisialisasi tahap kedua dari /system/bin/init dari ramdisk recovery.

Stempel waktu image booting

Kode berikut adalah contoh file stempel waktu gambar boot:

####################################
# from generate-common-build-props
# These properties identify this partition image.
####################################
ro.product.bootimage.brand=Android
ro.product.bootimage.device=generic_arm64
ro.product.bootimage.manufacturer=unknown
ro.product.bootimage.model=AOSP on ARM64
ro.product.bootimage.name=aosp_arm64
ro.bootimage.build.date=Mon Nov 16 22:46:27 UTC 2020
ro.bootimage.build.date.utc=1605566787
ro.bootimage.build.fingerprint=Android/aosp_arm64/generic_arm64:S/MASTER/6976199:userdebug/test-keys
ro.bootimage.build.id=MASTER
ro.bootimage.build.tags=test-keys
ro.bootimage.build.type=userdebug
ro.bootimage.build.version.incremental=6976199
ro.bootimage.build.version.release=11
ro.bootimage.build.version.release_or_codename=S
ro.bootimage.build.version.sdk=30
# Auto-added by post_process_props.py
persist.sys.usb.config=none
# end of file

  • Pada waktu build, file system/etc/ramdisk/build.prop ditambahkan ke ramdisk generik. File ini berisi informasi stempel waktu build.

  • Saat runtime, init tahap pertama menyalin file dari ramdisk ke tmpfs sebelum mengosongkan ramdisk sehingga init tahap kedua dapat membaca file ini untuk menetapkan properti stempel waktu gambar boot.