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.

Compatibilidade com GSI em vários dispositivos

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:

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

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

  3. 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 e GSIs do Android com GMS, faça o download na página de lançamento da GSI.
  • Para GSIs pré-criadas sem aplicativos do GMS, faça o download no site de CI do AOSP.
  • Para criar GSIs Android sem GMS, faça o download do código-fonte no AOSP e crie suas GSIs.

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