Immagini di sistema generiche (GSI)

Un'immagine di sistema generica (GSI) è un Implementazione Android pura con Android Open Source Project (AOSP) non modificato eseguibile su vari dispositivi Android.

Gli sviluppatori di app possono installare ed eseguire i GSI di Android più recenti per eseguire app su una varietà di dispositivi Android esistenti e utilizzando GSI di diversi Fasi di rilascio del sistema operativo Android, incluse Anteprima per sviluppatori e build beta. Aggiunta in corso... I GSI alle procedure di verifica e test possono offrirti ulteriori vantaggi:

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

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

Supporto GSI su tutti i dispositivi
Figura 1: i GSI possono essere installati in un'ampia gamma di e a volte anche per le versioni di Android che il produttore del dispositivo non fornisce la propria immagine di sistema.

I GSI includono le stesse funzionalità di sistema di base per tutti i dispositivi su cui è installato. In altre parole, un GSI non include i dati di fabbrica personalizzazioni. Per questo motivo, potresti riscontrare differenze di comportamento nelle le seguenti situazioni:

  • Interazioni che coinvolgono l'interfaccia utente
  • Flussi di lavoro che richiedono funzionalità hardware più recenti

Verifica la conformità del dispositivo

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

  • Il bootloader è sbloccato.
  • Completamente compatibile con Treble.
  • Android 9 (livello API 28) o versioni successive. Upgrade dei dispositivi a Android 9 con una versione precedente potrebbe supportare o meno i GSI.
di Gemini Advanced.

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

  1. Verifica il supporto di Treble eseguendo questo comando:

    adb shell getprop ro.treble.enabled

    Se la risposta è false, il dispositivo non è compatibile con i GSI e non deve 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\]"

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

    Se il valore di questo attributo è true, il dispositivo supporta pienamente Kit di sviluppo nativo del fornitore (VNDK) e può utilizzare qualsiasi versione del sistema operativo GSI più recente del sistema operativo sul dispositivo completamente gestita. Se possibile, utilizza la versione più recente del sistema operativo GSI disponibile.

    Se il valore dell'attributo è false, significa che il dispositivo non è completamente È conforme a VNDK e il dispositivo può utilizzare solo un GSI per lo stesso sistema operativo sul dispositivo. completamente gestita. Ad esempio, un dispositivo Android 10 (versione API 29) che non La conformità VNDK può caricare solo un'immagine GSI di Android 10.

  3. Il tipo di architettura della CPU GSI deve corrispondere all'architettura della CPU del dispositivo. A per trovare l'architettura CPU corretta per l'immagine GSI, esegui questo comando :

    adb shell getprop ro.product.cpu.abi

    Utilizza l'output per determinare quale immagine GSI utilizzare quando esegui il flashing del tuo dispositivo. Ad esempio, su Pixel 5, l'output indicherà che la CPU è arm64-v8a, quindi useresti il tipo di GSI arm64.

Scarica GSI

Esistono diversi modi per ottenere i GSI, a seconda delle esigenze di sviluppo:

di Gemini Advanced.

Installa un GSI

L'installazione di un GSI dipende dal dispositivo. Rivolgiti al produttore del tuo dispositivo per gli strumenti e le procedure esatti. Per i dispositivi Google Pixel come Pixel 3 e più recente, puoi installarlo in vari modi:

Fornisci feedback

I GSI hanno lo scopo di aiutarti a convalidare le tue app su Android. Apprezziamo la tua feedback sulle immagini, sugli strumenti e sul processo per l'utilizzo dei GSI sui dispositivi mobili.

Per segnalarci bug o richiedere funzionalità, utilizza l'Issue Tracker dedicato per i GSI.

Risorse aggiuntive