Imagem genérica do sistema

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 for true, 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\]"
```
Observação: dependendo da plataforma, o arquivo de configuração no comando anterior pode ou não conter um identificador de versão.

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 tipo arm64 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:

Atualização manual das GSIs: consulte Atualização de GSIs com flash.

Uso de Atualizações dinâmicas do sistema (DSU, na sigla em inglês) para dispositivos que já executam o Android 10: consulte o site de Atualizações dinâmicas do sistema

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.

Outros recursos

Entenda o impacto das imagens genéricas do sistema (GSI) - Conferência de Desenvolvedores Android 2018