Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Image Sistem Generik

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.

Dukungan GSI di seluruh perangkat

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. Anda, sebagai developer aplikasi, 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 mendapatkan cakupan pengujian lebih luas, yang 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:

  1. 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 responsnya true, lanjutkan ke langkah berikutnya.

  2. 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.

  3. 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 jenis arm64.

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 11 dan GSI Android 10 dengan GMS, download dari halaman rilis GSI.
  • Untuk image GSI siap pakai tanpa aplikasi GMS, download dari situs CI AOSP.
  • Untuk memb-build GSI Android 10 dan GSI Android 9 tanpa GSM, 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 yang lebih baru, ada beberapa cara penginstalan:

  • Melakukan flash image GSI secara manual — lihat Melakukan Flash GSI
  • Menggunakan Dynamic System Update (DSU) untuk perangkat yang sudah menjalankan Android 10 — lihat situs Dynamic System Update
  • Kirimkan masukan Anda

    Image GSI membantu memvalidasi aplikasi di Android. Kami mengharapkan masukan terkait image, fitur, dan proses pengaktifan GSI di perangkat Anda.

    Untuk melaporkan bug atau menyampaikan permintaan fitur, gunakan komponen pelacak masalah khusus.

    Resource lainnya