Immagini di sistema generiche

Un'immagine di sistema generica (GSI) è un'implementazione di Android puro con codice Android Open Source Project (AOSP) non modificato, eseguibile su una serie di dispositivi Android.

Gli sviluppatori di app possono installare ed eseguire le ultime GSI di Android per eseguire il testing delle app su una serie di dispositivi Android esistenti e utilizzare le GSI di diversi stadi di rilascio del sistema operativo Android, tra cui le build Developer Preview e Beta. L'aggiunta dei GSI alle procedure di verifica e test può offrirti alcuni vantaggi aggiuntivi:

• Copertura dei test più ampia su un maggior numero di dispositivi reali
• Più tempo per risolvere i problemi di compatibilità delle app
• Più opportunità per risolvere i problemi di compatibilità in Android segnalati dagli sviluppatori di app

Il progetto GSI è open source e contribuisce a migliorare l'ecosistema Android offrendo più modi per migliorare la qualità delle app e del sistema operativo prima di ogni release di Android.

Figura 1: le GSI possono essere installate su una vasta gamma di dispositivi e, a volte, anche per versioni di Android per le quali un produttore di dispositivi non fornisce la propria immagine di sistema.

Le GSI includono le stesse funzionalità di sistema di base per tutti i dispositivi su cui sono installate. In altre parole, un GSI non include le personalizzazioni del produttore del dispositivo. Per questo motivo, potresti riscontrare differenze di comportamento nelle seguenti situazioni:

• Interazioni che coinvolgono l'interfaccia utente
• Workflow che richiedono funzionalità hardware più recenti

Verifica la conformità del dispositivo

Le GSI possono funzionare solo su dispositivi con le seguenti caratteristiche:

• Il bootloader è sbloccato.
• Completamente conforme a Treble.
• Android 9 (livello API 28) o versioni successive. I dispositivi aggiornati ad Android 9 da una versione precedente potrebbero o non supportare i GSI.

Avviso: il tentativo di eseguire il flashing di un GSI su un dispositivo non conforme potrebbe comportare la mancata attivazione del dispositivo. Verifica sempre che il dispositivo sia conforme prima del flashing e segui i passaggi di installazione forniti dal produttore del dispositivo. Le immagini generiche del sistema (GSI) non supportano il rollback, quindi avrai bisogno di un metodo di recupero e della ROM di sistema originale per ripristinare il sistema originale.

Per determinare se il tuo dispositivo può utilizzare un GSI e quale versione del sistema operativo GSI devi installare, procedi nel seguente modo:

1. Controlla se è supportato Treble eseguendo il seguente comando:

   adb shell getprop ro.treble.enabled

   Se la risposta è false, il dispositivo non è compatibile con GSI e non devi continuare. Se la risposta è true, vai al passaggio successivo.

2. Per verificare il supporto tra versioni, esegui questo comando:

   adb shell cat /system/etc/ld.config.version_identifier.txt \
   | grep -A 20 "\[vendor\]"

   Nota: a seconda della piattaforma, il file di configurazione nel comando precedente può o meno contenere un identificatore di versione.

   Nell'output, cerca namespace.default.isolated nella sezione [vendor].

   Se il valore dell'attributo è true, il dispositivo supporta completamente il Vendor Native Development Kit (VNDK) e può utilizzare qualsiasi versione del sistema operativo (OS) GSI più recente della versione del sistema operativo sul dispositivo. Se possibile, utilizza la versione più recente del sistema operativo GSI disponibile.

   Se il valore dell'attributo è false, il dispositivo non è completamente conforme a VNDK e può utilizzare solo un GSI per la stessa versione del sistema operativo on-device. Ad esempio, un dispositivo Android 10 (API versione 29) non conforme a VNDK può caricare solo un'immagine GSI di Android 10.

3. Il tipo di architettura della CPU GSI deve corrispondere a quello della CPU del dispositivo. Per trovare la giusta architettura della CPU per l'immagine GSI, esegui questo comando:

   adb shell getprop ro.product.cpu.abi

   Utilizza l'output per determinare quale immagine GSI utilizzare per il flashing del dispositivo. Ad esempio, su Pixel 5, l'output indica che l'architettura della CPU è arm64-v8a, quindi devi utilizzare il tipo arm64 di GSI.

Scaricare i GSI

Esistono diversi modi per ottenere gli indicatori GSI, a seconda delle tue esigenze di sviluppo:

• Per le immagini GSI di Android Preview e Android con GMS, scaricale dalla pagina di rilascio GSI.

• Per le immagini GSI precompilate senza applicazioni GMS, scaricale dal sito AOSP CI:

  • Android 10 (livello API 29)
  • Android 11 (livello API 30)
  • Android 12 (livello API 31)
  • Android 13 (livello API 33)

• Per compilare GSI di Android senza GMS, scarica il codice sorgente da AOSP e compila i tuoi GSI.

Importante: i produttori di dispositivi non devono utilizzare queste versioni dei GSI per eseguire e inviare i test di conformità. I produttori di dispositivi devono invece continuare a fare riferimento ai propri canali di comunicazione esistenti, ad esempio ai Technical Account Manager, per le attività relative ai test di conformità.

Installare un GSI

Nota: se il tuo dispositivo ha adottato l'Avvio verificato di Android (AVB), scarica e aggiorna la seguente immagine per disattivare AVB prima di eseguire il flashing di una GSI: vbmeta.img

L'installazione di un GSI dipende dal dispositivo. Consulta il produttore del dispositivo per conoscere gli strumenti e le procedure esatti. Sui dispositivi Google Pixel come Pixel 3 e modelli successivi, ci sono diversi modi per installarli:

• Eseguire il flashing manuale delle immagini GSI: vedi Requisiti per il flashing delle immagini GSI
• Utilizzo dell'aggiornamento di sistema dinamico (DSU) per i dispositivi su cui è già installato Android 10 o versioni successive: consulta la pagina Aggiornamenti di sistema dinamici

Invia feedback

Le GSI hanno lo scopo di aiutarti a convalidare le tue app su Android. Apprezziamo il tuo feedback sulle immagini, sugli strumenti e sulla procedura di utilizzo delle GSI sui tuoi dispositivi.

Per informarci di bug o richieste di funzionalità, utilizza il componente Issue Tracker dedicato per i GSI.

Risorse aggiuntive

• Informazioni sull'impatto delle immagini di sistema generiche (GSI) (Android Dev Summit '18)