Generic System Image (GSI)

Generic System Image (GSI) adalah image sistem dengan konfigurasi yang disesuaikan untuk perangkat Android. GSI dianggap sebagai implementasi Android murni dengan kode Proyek Open Source Android (AOSP) yang tidak dimodifikasi dan dapat dijalankan dengan sukses oleh perangkat Android apa pun yang menjalankan Android 9 atau yang lebih tinggi.

GSI digunakan untuk menjalankan pengujian VTS dan CTS-on-GSI. Image sistem perangkat Android diganti dengan GSI, lalu diuji dengan Vendor Test Suite (VTS) dan Compatibility Test Suite (CTS) untuk memastikan perangkat menerapkan antarmuka vendor dengan benar menggunakan Android versi terbaru.

Untuk mulai menggunakan GSI, tinjau bagian berikut untuk mengetahui detail tentang konfigurasi GSI (dan varian yang diizinkan ) serta jenisnya. Jika Anda siap menggunakan GSI, download dan build GSI untuk target perangkat Anda, lalu flash GSI ke perangkat Android.

Konfigurasi dan varian GSI

GSI Android saat ini memiliki konfigurasi berikut:

• Treble. GSI menyertakan dukungan penuh untuk perubahan arsitektur berbasis AIDL/HIDL (juga dikenal sebagai Treble), termasuk dukungan untuk antarmuka AIDL dan antarmuka HIDL. Anda dapat menggunakan GSI di perangkat Android apa pun yang menggunakan antarmuka vendor AIDL/HIDL. (Untuk mengetahui detail selengkapnya, lihat Referensi arsitektur.)
• Sistem file. GSI menggunakan sistem file ext4.

GSI Android saat ini mencakup varian utama berikut:

• Arsitektur CPU. Dukungan untuk berbagai instruksi CPU (ARM, x86, dll.) dan bit CPU (32 bit atau 64 bit).

Target GSI untuk pengujian kepatuhan Treble

GSI yang digunakan untuk pengujian kepatuhan ditentukan oleh versi Android yang digunakan perangkat saat diluncurkan.

Semua GSI dibangun dari codebase Android 12, dan setiap arsitektur CPU memiliki biner GSI yang sesuai (lihat daftar target build di Mem-build GSI).

Perubahan GSI Android 12

Perangkat yang diluncurkan dengan atau diupdate ke Android 12 harus menggunakan GSI Android 12 untuk pengujian kepatuhan. Hal ini mencakup perubahan utama berikut dari GSI sebelumnya:

• Nama target. Nama target GSI untuk pengujian kepatuhan diubah menjadi gsi_$arch. GSI dengan nama target aosp_$arch disimpan untuk developer aplikasi Android. Paket pengujian CTS-on-GSI juga dikurangi untuk menguji antarmuka vendor.
• GSI lama tidak digunakan lagi. GSI 12 menghapus solusi yang mengakomodasi perangkat Android 8.0 atau 8.1 yang tidak sepenuhnya Treblized.
• SEPolicy Userdebug. GSI gsi_$arch berisi userdebug_plat_sepolicy.cil. Saat melakukan flash khusus OEM vendor_boot-debug.img atau boot-debug.img, /system/bin/init akan memuat userdebug_plat_sepolicy.cil dari GSI system.img. Lihat Pengujian VTS dengan Ramdisk Debug untuk mengetahui detailnya.

Perubahan GSI Android 11

Perangkat yang diluncurkan dengan atau diupdate ke Android 11 harus menggunakan GSI Android 11 untuk pengujian kepatuhan. Hal ini mencakup perubahan utama berikut dari GSI sebelumnya:

• Konten system_ext. Android 11 menentukan partisi baru system_ext. GSI menempatkan konten ekstensi sistem di folder system/system_ext.
• APEX. GSI berisi APEX yang diratakan dan dikompresi. APEX yang akan digunakan ditentukan oleh properti sistem ro.apex.updatable di partisi vendor saat runtime. Lihat Mengonfigurasi sistem untuk mendukung update APEX guna mengetahui detailnya.

Perubahan GSI Android 10

Perangkat yang diluncurkan dengan atau diupdate ke Android 10 harus menggunakan GSI Android 10 untuk pengujian kepatuhan. Hal ini mencakup perubahan utama berikut dari GSI sebelumnya:

• Build pengguna. GSI memiliki build pengguna dari Android 10. Di Android 10, GSI build pengguna dapat digunakan dalam pengujian kepatuhan CTS-on-GSI/VTS. Lihat Pengujian VTS dengan Ramdisk Debug untuk mengetahui detailnya.
• Format tidak jarang. GSI dengan target aosp_$arch dibangun dengan format tidak jarang. Anda dapat menggunakan img2simg untuk mengonversi GSI tidak jarang ke format jarang jika diperlukan.
• Sistem-sebagai-root. Target build GSI lama yang bernama aosp_$arch_a telah dihentikan. Untuk perangkat yang diupgrade dari Android 8 atau 8.1 ke Android 10 dengan ramdisk dan non-system-as-root, gunakan GSI lama aosp_$arch_ab. init yang diupgrade di ramdisk mendukung OEM system.img dengan tata letak system-as-root.
• Verifikasi booting. Dengan menggunakan GSI, Anda hanya perlu membuka kunci perangkat. Anda tidak perlu menonaktifkan verifikasi booting.

Perubahan GSI Android 9

Perangkat yang diluncurkan dengan atau diupdate ke Android 9 harus menggunakan GSI Android 9 untuk pengujian kepatuhan. Hal ini mencakup perubahan utama berikut dari GSI sebelumnya:

• Menggabungkan GSI dan emulator. GSI dibangun dari image sistem produk emulator, misalnya, aosp_arm64 dan aosp_x86.
• Sistem-sebagai-root. Pada versi Android sebelumnya, perangkat yang tidak mendukung update A/B dapat memasang image sistem di direktori /system. Di Android 9, the root image sistem dipasang sebagai root perangkat.
• Antarmuka binder 64-bit. Di Android 8.x, GSI 32-bit menggunakan antarmuka binder 32-bit. Android 9 tidak mendukung antarmuka binder 32-bit, sehingga GSI 32-bit dan GSI 64-bit menggunakan antarmuka binder 64-bit.
• Penerapan VNDK. Di Android 8.1, VNDK bersifat opsional. Mulai Android 9, VNDK bersifat wajib, sehingga BOARD_VNDK_VERSION harus ditetapkan.
• Properti sistem yang kompatibel. Android 9 mengaktifkan pemeriksaan akses untuk properti sistem yang kompatibel (PRODUCT_COMPATIBLE_PROPERTY_OVERRIDE := true).

Perubahan Keymaster Android 9

Pada versi Android sebelumnya, perangkat yang menerapkan Keymaster 3 atau yang lebih rendah diwajibkan untuk memverifikasi bahwa info versi (ro.build.version.release dan ro.build.version.security_patch) yang dilaporkan oleh sistem yang berjalan cocok dengan info versi yang dilaporkan oleh bootloader. Informasi tersebut biasanya diperoleh dari header image booting.

Di Android 9 dan yang lebih tinggi, persyaratan ini telah diubah untuk memungkinkan vendor melakukan booting GSI. Secara khusus, Keymaster tidak boleh melakukan verifikasi karena info versi yang dilaporkan oleh GSI mungkin tidak cocok dengan info versi yang dilaporkan oleh bootloader vendor. Untuk perangkat yang menerapkan Keymaster 3 atau yang lebih rendah, vendor harus mengubah implementasi Keymaster untuk melewati verifikasi (atau mengupgrade ke Keymaster 4). Untuk mengetahui detail tentang Keymaster, lihat Keystore yang Didukung Hardware.

Mendownload GSI

Anda dapat mendownload GSI siap pakai dari situs integrasi berkelanjutan (CI) AOSP di ci.android.com. Jika jenis GSI untuk platform hardware Anda tidak tersedia untuk didownload, lihat bagian berikut untuk mengetahui detail tentang mem-build GSI untuk target tertentu.

Mem-build GSI

Mulai Android 9, setiap versi Android memiliki cabang GSI yang bernama DESSERT-gsi di AOSP (misalnya, android12-gsi adalah cabang GSI di Android 12). Cabang GSI mencakup konten Android dengan semua patch keamanan dan patch GSI yang diterapkan.

Untuk mem-build GSI, siapkan pohon sumber Android dengan mendownload dari cabang GSI dan memilih target build GSI. Gunakan tabel target build di bawah untuk menentukan versi GSI yang benar untuk perangkat Anda. Setelah build selesai, GSI adalah image sistem (yaitu, system.img) dan muncul di folder output out/target/product/generic_arm64.

Misalnya, untuk mem-build target build GSI gsi_arm64-userdebug di cabang GSI android12-gsi, jalankan perintah berikut.

$ repo init -u https://android.googlesource.com/platform/manifest -b android12-gsi
$ repo sync -cq
$ source build/envsetup.sh
$ lunch gsi_arm64-userdebug
$ make -j4

Target build GSI Android

Target build GSI berikut ditujukan untuk perangkat yang diluncurkan di Android 9 atau yang lebih tinggi.

Persyaratan untuk melakukan flash GSI

Perangkat Android dapat memiliki desain yang berbeda, sehingga tidak ada perintah atau kumpulan petunjuk umum untuk melakukan flash GSI yang berlaku untuk semua perangkat. Hubungi produsen perangkat Android untuk mendapatkan petunjuk flash yang eksplisit. Gunakan langkah-langkah berikut sebagai panduan umum:

1. Pastikan perangkat memiliki hal berikut:
   • Treblized
   • Metode untuk membuka kunci perangkat (sehingga dapat di-flash menggunakan fastboot)
   • Status tidak terkunci agar dapat di-flash melalui fastboot (Untuk memastikan Anda memiliki fastboot, build dari pohon sumber Android.)
2. Hapus partisi sistem saat ini, lalu flash GSI ke partisi sistem partition.
3. Hapus data pengguna dan hapus data dari partisi lain yang diperlukan (misalnya, data pengguna dan partisi sistem).
4. Mulai ulang perangkat.

Misalnya, untuk melakukan flash GSI ke perangkat Pixel:

1. Boot ke fastboot mode dan buka kunci bootloader.
2. Perangkat yang mendukung fastbootd juga perlu melakukan booting ke fastbootd dengan:

   $ fastboot reboot fastboot

3. Hapus dan flash GSI ke partisi sistem:

   $ fastboot erase system
   $ fastboot flash system system.img

4. Jika perangkat Anda mendukung Android Virtual Framework, flash Firmware Virtual Machine yang Dilindungi:

   $ fastboot flash pvmfw pvmfw.img
   

5. Hapus data pengguna dan hapus data dari partisi lain yang diperlukan (misalnya data pengguna dan partisi sistem):

   $ fastboot -w

6. Reboot kembali ke bootloader:

   $ fastboot reboot-bootloader

7. Nonaktifkan verifikasi Booting Terverifikasi saat melakukan flash vbmeta yang disediakan:

   $ fastboot --disable-verification flash vbmeta vbmeta.img

8. Reboot:

   $ fastboot reboot

    Resizing 'system_a'    FAILED (remote: 'Not enough space to resize partition')
    fastboot: error: Command failed

$ fastboot delete-logical-partition product_a

Berkontribusi pada GSI

Android menyambut kontribusi Anda untuk pengembangan GSI. Anda dapat berpartisipasi dan membantu meningkatkan kualitas GSI dengan:

• Membuat patch GSI. DESSERT-gsi bukan cabang pengembangan dan hanya menerima cherrypick dari cabang rilis terbaru AOSP (android17-release), sehingga untuk mengirimkan patch GSI Anda harus:
  1. Mengirimkan patch ke AOSP android17-release cabang.
  2. Melakukan cherrypick patch ke DESSERT-gsi.
  3. Mengajukan bug untuk meninjau cherrypick.
• Melaporkan bug GSI atau memberikan saran lainnya. Tinjau petunjuk di Melaporkan bug, lalu telusuri atau ajukan bug GSI.

Tips

Mengubah mode menu navigasi menggunakan adb

Saat melakukan booting dengan GSI, mode menu navigasi dikonfigurasi dengan mengganti vendor. Anda dapat mengubah mode menu navigasi dengan menjalankan perintah adb berikut saat runtime.

adb exec-out cmd overlay enable-exclusive com.android.internal.systemui.navbar.mode

Dengan mode dapat berupa threebutton, twobutton, gestural, dan sebagainya.