Generic System Image (GSI) merupakan implementasi Android murni dengan kode Proyek Open Source Android (AOSP) yang tidak dimodifikasi, yang dapat dijalankan di berbagai perangkat Android.

Gambar 1. Dukungan GSI di seluruh perangkat.
Dimulai dengan Android 9 (API level 28), Generic System Image (GSI) tersedia bagi developer aplikasi di sepanjang siklus rilis Android lengkap. Sebagai developer aplikasi, Anda dapat menginstal dan menjalankan GSI Android terbaru di berbagai perangkat Android yang ada, serta di berbagai tahapan rilis OS Android termasuk fase Pratinjau dan Beta, untuk melakukan pengujian aplikasi. Dengan cara ini, aplikasi Anda akan mendapatkan cakupan pengujian lebih luas, yang dimulai jauh lebih awal dari sebelumnya:
- Lebih banyak cakupan pengujian di perangkat yang sesungguhnya
- Lebih banyak waktu untuk memperbaiki masalah kompatibilitas aplikasi
- Lebih banyak peluang untuk memperbaiki masalah yang tidak kompatibel di OS Android yang dilaporkan oleh developer aplikasi
Catatan: Anda harus menginstal versi GSI yang lebih baru dari versi Android yang saat ini terinstal di perangkat.
Project GSI membantu meningkatkan ekosistem Android dengan menyediakan berbagai cara untuk meningkatkan kualitas OS dan aplikasi sebelum rilis berikutnya. Project ini juga merupakan project open source.
GSI mencakup fungsi sistem inti di semua perangkat yang menjalankan Android 9 dan versi yang lebih tinggi. Dengan kata lain, GSI tidak mencakup kustomisasi produsen perangkat. Anda mungkin menemukan perbedaan perilaku dalam situasi berikut:
- Interaksi yang melibatkan UI.
- Alur kerja yang meminta fitur hardware yang lebih baru.
Memeriksa kesesuaian perangkat
GSI hanya berfungsi pada perangkat dengan karakteristik berikut:
- Bootloader tidak terkunci.
- Mematuhi persyaratan Treble sepenuhnya.
- Diluncurkan dengan Android 9 (API level 28) atau versi lebih tinggi. Perangkat yang diupgrade ke Android 9 dari versi sebelumnya mungkin mendukung GSI, mungkin juga tidak.
Untuk mengetahui apakah perangkat Anda dapat menggunakan GSI, dan untuk menentukan versi OS GSI yang harus diinstal, lakukan langkah berikut:
-
Periksa dukungan Treble dengan menjalankan perintah berikut:
adb shell getprop ro.treble.enabled
Jika responsnya
false
, artinya perangkat tidak kompatibel dengan GSI dan Anda tidak perlu melanjutkan. Jika responsnyatrue
, lanjutkan ke langkah berikutnya. -
Periksa dukungan lintas versi dengan menjalankan perintah berikut:
adb shell cat /system/etc/ld.config.version_identifier.txt \ | grep -A 20 "\[vendor\]"
Pada output, cari
namespace.default.isolated
di bagian[vendor]
.Jika nilai untuk atribut tersebut
true
, artinya perangkat sepenuhnya mendukung Vendor Native Development Kit (VNDK) dan dapat menggunakan semua versi sistem operasi (OS) GSI yang lebih baru dari versi OS yang ada di perangkat. Pilih versi OS GSI terbaru yang tersedia.Jika nilai untuk atribut tersebut
false
, artinya perangkat tidak sepenuhnya memenuhi persyaratan VNDK dan perangkat hanya dapat menggunakan GSI untuk versi OS di perangkat yang sama. Misalnya, perangkat Android 9 (API versi 28) yang tidak memenuhi persyaratan VNDK hanya dapat memuat image GSI Android 9. -
Jenis arsitektur CPU GSI harus sesuai dengan arsitektur CPU perangkat. Untuk menemukan arsitektur CPU yang tepat untuk image GSI, jalankan perintah berikut:
adb shell getprop ro.product.cpu.abi
Gunakan output perintah di atas guna menentukan image GSI yang akan digunakan untuk mem-flash perangkat. Misalnya, pada Pixel 3, output-nya akan menunjukkan bahwa arsitektur CPU adalah
arm64-v8a
, sehingga Anda harus menggunakan GSI jenisarm64
.
Mendownload image GSI
Versi GSI yang ada di sini tidak boleh digunakan oleh OEM untuk menjalankan dan mengajukan uji kepatuhan. OEM harus terus merujuk pada saluran komunikasi yang ada seperti Technical Account Manager-nya untuk aktivitas terkait uji kepatuhan.
Ada beberapa cara untuk mendapatkan GSI, bergantung pada kebutuhan pengembangan Anda:
- Untuk GSI Pratinjau Android dan GSI Android dengan GMS, download dari halaman rilis GSI.
- Untuk image GSI siap pakai tanpa aplikasi GMS, download dari situs CI AOSP.
- Untuk membuat GSI Android tanpa GMS, download kode sumber dari AOSP, lalu buat GSI Anda.
Menginstal image GSI
Catatan: Jika perangkat Anda telah menerapkan Booting Terverifikasi Android (AVB), download dan flash image berikut untuk menonaktifkan AVB sebelum mem-flash GSI: vbmeta.img
Penginstalan GSI bergantung pada perangkat. Anda dapat merujuk pada produsen perangkat untuk prosedur dan fitur yang pasti. Untuk Pixel 3 dan perangkat lebih baru, ada beberapa cara penginstalan:
Kirimkan masukan Anda
Image GSI membantu memvalidasi aplikasi di Android. Kami mengharapkan masukan Anda terkait image, fitur, dan proses pengaktifan GSI di perangkat Anda.
Untuk melaporkan bug atau menyampaikan permintaan fitur, gunakan komponen Issue Tracker khusus.