Uma imagem genérica do sistema (GSI) é uma implementação de Android puro com código do Android Open Source Project (AOSP) não modificado e pode ser executada em vários dispositivos Android.

Figura 1. Compatibilidade com GSI em vários dispositivos.
A partir do Android 9 (API de nível 28), imagens genéricas do sistema (GSIs) estão disponíveis para desenvolvedores de apps em todo o ciclo de versões do Android. Você, como desenvolvedor de apps, pode instalar e executar as GSIs Android mais recentes em vários dispositivos Android e em vários estágios de versão do SO Android, incluindo as fases de pré-visualização e Beta, para testar apps. Dessa forma, seu app recebe uma cobertura de teste mais ampla, começando muito mais cedo do que antes:
- Mais cobertura de teste em dispositivos reais
- Mais tempo para corrigir problemas de compatibilidade de apps
- Mais oportunidades para corrigir problemas de incompatibilidade no sistema operacional Android relatados pelos desenvolvedores de apps
Observação: instale uma versão da GSI mais recente que a versão do Android instalada atualmente em um dispositivo.
O projeto GSI ajuda a aprimorar o ecossistema Android oferecendo mais formas de melhorar a qualidade do app e do SO antes da próxima versão do SO. O projeto também é de código aberto.
A GSI inclui as principais funcionalidades do sistema em todos os dispositivos que executam o Android 9 e versões mais recentes. Em outras palavras, a GSI não inclui personalizações do fabricante do dispositivo. Você pode encontrar diferenças comportamentais nos seguintes casos:
- Interações que envolvem a IU.
- Fluxos de trabalho que solicitam novos recursos de hardware.
Verificar conformidade do dispositivo
A GSI funciona apenas em dispositivos que:
- têm carregador de inicialização desbloqueado;
- estão em total conformidade com o Treble;
- foram lançados com o Android 9 (API de nível 28) ou versões posteriores (dispositivos atualizados de uma versão anterior para o Android 9 podem ou não ser compatíveis com a GSI).
Para determinar se o dispositivo pode usar a GSI e qual versão de SO da GSI você instalará, faça o seguinte:
-
Verifique a compatibilidade com o Treble executando o comando abaixo:
adb shell getprop ro.treble.enabled
Se a resposta for
false
, isso significa que o dispositivo não é compatível com GSI e não é possível continuar. Se a resposta fortrue
, siga para a próxima etapa. -
Verifique a compatibilidade entre versões executando o seguinte comando:
adb shell cat /system/etc/ld.config.version_identifier.txt \ | grep -A 20 "\[vendor\]"
No resultado, procure
namespace.default.isolated
na seção[vendor]
.Se o valor do atributo for
true
, isso significa que o dispositivo é totalmente compatível com o Kit de desenvolvimento nativo do fornecedor (VNDK) e pode usar qualquer versão do sistema operacional (SO) da GSI mais nova que a versão do SO no dispositivo. Escolha a versão mais recente disponível de SO da GSI.Se o valor do atributo for
false
, isso significa que o dispositivo não está em total conformidade com o VNDK e pode usar apenas a GSI da mesma versão de SO no dispositivo. Por exemplo, um dispositivo com Android 9 (API de nível 28) incompatível com o VNDK só pode carregar uma imagem GSI do Android 9. -
O tipo de arquitetura de CPU da GSI precisa corresponder à arquitetura de CPU do dispositivo. Para encontrar a arquitetura de CPU correta para a imagem GSI, execute o seguinte comando:
adb shell getprop ro.product.cpu.abi
Use o resultado para determinar qual GSI usar ao atualizar o dispositivo. Por exemplo, em um Pixel 3, o resultado indicaria que a arquitetura de CPU é
arm64-v8a
. Então, você usaria o tipoarm64
da GSI.
Download de GSIs
Essas versões de GSIs não podem ser usadas por OEMs para executar e enviar testes de compatibilidade. Os OEMs precisam continuar consultando os próprios canais de comunicação já existentes, por exemplo, os Gerenciadores técnicos de contas para testes de compatibilidade e atividades relacionadas.
Há algumas maneiras de adquirir as GSIs, dependendo das suas necessidades de desenvolvimento:
- Para GSIs da versão de pré-lançamento do Android 11 e GSIs do Android 10 com GMS, faça o download na página de versão da GSI.
- Para GSIs pré-criadas sem aplicativos do GMS, faça o download no site de CI do AOSP.
- Para criar sua GSI do Android 10 e do Android 9 sem GMS, faça o download do código-fonte no AOSP.
Instalar GSIs
Observação: caso seu dispositivo tenha adotado a Inicialização verificada do Android (AVB, na sigla em inglês), faça o download da seguinte imagem e atualize-a para desativar a AVB antes de atualizar uma GSI: vbmeta.img
A instalação da GSI depende do dispositivo. Consulte o fabricante do seu dispositivo para saber as ferramentas e procedimentos exatos. Para o Pixel 3 e dispositivos mais recentes, existem várias maneiras de instalar:
Envie seu feedback
As imagens GSI ajudam a validar apps no Android. Envie-nos seu feedback sobre as imagens, as ferramentas e o processo de ativação de GSI nos seus dispositivos.
Para nos informar sobre bugs ou solicitações de recursos, use o componente dedicado do Issue Tracker.