Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
Os desenvolvedores podem instalar e executar as GSIs mais recentes do Android para realizar testes
em vários dispositivos Android já existentes e usar GSIs de diferentes
níveis de versão do SO Android, incluindo a prévia para desenvolvedores e os builds Beta. Adicionar
GSIs aos processos de verificação e teste pode oferecer alguns
outros benefícios:
Cobertura de teste mais ampla em um conjunto maior de dispositivos reais.
Mais tempo para corrigir problemas de compatibilidade de apps.
Mais oportunidades para corrigir problemas de compatibilidade no Android
informados por desenvolvedores de apps.
O projeto GSI tem código
aberto
e ajuda a melhorar o ecossistema Android oferecendo mais formas de melhorar a qualidade
do app e do SO antes de cada lançamento do Android.
Figura 1: GSIs podem ser instaladas em uma ampla variedade de
dispositivos e, às vezes, até mesmo para versões de Android para a qual um fabricante
não forneça a própria imagem do sistema.
As GSIs incluem as mesmas funcionalidades principais do sistema para todos os dispositivos
em que estão instaladas. Em outras palavras, uma GSI não inclui personalizações do fabricante
do dispositivo. Por isso, você pode encontrar diferenças comportamentais
nestas situações:
Interações que envolvem a interface.
Fluxos de trabalho que solicitam novos recursos de hardware.
Verificar a compliance do dispositivo
As GSIs só funcionam em dispositivos que:
Têm o carregador de inicialização desbloqueado.
estão em total conformidade com o Treble;
Foram lançados com o Android 9 (nível 28 da API) ou versões mais recentes. Os dispositivos que fizeram upgrade para
o Android 9 de uma versão anterior podem ou não oferecer suporte a GSIs.
Para determinar se o dispositivo pode usar a GSI e qual versão de SO da GSI você
vai instalar, faça o seguinte:
Verifique o suporte ao 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 o suporte entre versões executando o comando abaixo:
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 oferece total suporte ao
Kit de desenvolvimento nativo do fornecedor
(VNDK) e pode usar
qualquer versão do sistema operacional (SO) da GSI mais recente que a versão do SO
no dispositivo. Sempre que possível, use 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
compliance com o VNDK e pode usar apenas a GSI da mesma versão de SO no
dispositivo. Por exemplo, um dispositivo com Android 10 (nível 29 da API)
sem compliance com o VNDK só pode carregar uma imagem GSI do Android 10.
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 da GSI, execute o comando
abaixo:
adb shell getprop ro.product.cpu.abi
Use o resultado para determinar qual GSI usar ao atualizar o
dispositivo. Por exemplo, em um Pixel 5, o resultado indicaria que a arquitetura
de CPU é arm64-v8a. Então, você usaria o tipo arm64 da GSI.
Fazer o download das GSIs
Há algumas maneiras de fazer o download das 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 das imagens na
página de lançamento da GSI.
Para GSIs pré-criadas sem aplicativos do GMS, faça o download das imagens
do 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 uma GSI
A instalação de uma GSI depende do dispositivo. Consulte o fabricante do seu dispositivo para
saber as ferramentas e procedimentos exatos. Para dispositivos Google Pixel, como o Pixel 3 e
mais recentes, há várias maneiras de instalar:
Usando a atualização dinâmica do sistema (DSU, na sigla em inglês) para dispositivos que já executam o Android 10 ou
mais recente: consulte a página Atualizações dinâmicas do sistema.
Enviar feedback
As GSIs têm o objetivo de ajudar você a validar seus apps no Android. Agradecemos o
feedback sobre as imagens, as ferramentas e o processo para usar GSIs nos seus
dispositivos.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-25 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# Generic System Images (GSIs)\n\nA Generic System Image ([GSI](https://source.android.com/setup/build/gsi)) is a\n*pure Android* implementation with unmodified Android Open Source Project (AOSP)\ncode, runnable on a variety of Android devices.\n\nApp developers can install and run the latest Android GSIs to perform app\ntesting on a variety of existing Android devices and using GSIs from different\nAndroid OS release stages, including Developer Preview and Beta builds. Adding\nGSIs to your verification and testing processes can provide you with some extra\nbenefits:\n\n- Broader test coverage on a greater set of real devices\n- More time to fix app compatibility issues\n- More opportunities to fix compatibility issues in Android that are reported by app developers\n\nThe GSI project is [open\nsource](https://android.googlesource.com/platform/manifest/+/refs/heads/pie-gsi#)\nand helps improve the Android ecosystem by providing more ways to improve app\nand OS quality before each release of Android.\n**Figure 1**: GSIs can be installed across a broad range of devices, and sometimes even for versions of Android that a device manufacturer doesn't provide their own system image for.\n\nGSIs include the same core system functionalities for all devices that they're\ninstalled on. In other words, a GSI does not include device manufacturer's\ncustomizations. Because of this, you might encounter behavioral differences in\nthe following situations:\n\n- Interactions that involve the UI\n- Workflows that request newer hardware features\n\nCheck device compliance\n-----------------------\n\nGSIs can only function on devices with the following characteristics:\n\n- Bootloader is unlocked.\n- Fully Treble-compliant.\n- Launched with Android 9 (API level 28) or higher. Devices upgraded to Android 9 from an earlier version might or might not support GSIs.\n\n| **Warning:** Attempting to flash a GSI to a non-compliant device could result in your device becoming non-bootable. Always confirm that your device is compliant before flashing, and follow the installation steps provided by your device's manufacturer. GSIs don't support rollback, so you will need a recovery method and original system ROM to revert to the original system.\n\nTo determine whether your device can use a GSI and which GSI OS version you\nshould install, do the following:\n\n1. Check for Treble support by running the following command:\n\n ```\n adb shell getprop ro.treble.enabled\n ```\n\n If the response is `false`, the device isn't compatible with GSIs and you\n shouldn't continue. If the response is `true`, continue to the next step.\n2. Check for cross-version support by running the following command:\n\n ```\n adb shell cat /system/etc/ld.config.version_identifier.txt \\\n | grep -A 20 \"\\[vendor\\]\"\n ```\n | **Note:** Depending on your platform, the configuration file in the preceding command may or may not have a version identifier in it.\n\n In the output, look in the `[vendor]` section for\n `namespace.default.isolated`.\n\n If the value for that attribute is `true`, then the device fully supports\n [Vendor Native Development Kit\n (VNDK)](https://source.android.com/devices/architecture/vndk) and can use\n any GSI operating system (OS) version that is newer than the on-device OS\n version. Whenever possible, use the latest GSI OS version that is available.\n\n If the value for the attribute is `false`, then the device isn't fully\n VNDK-compliant, and the device can use only a GSI for the same on-device OS\n version. For example, an Android 10 (API version 29) device that isn't\n VNDK-compliant can load only an Android 10 GSI image.\n3. The GSI CPU architecture type must match the device's CPU architecture. To\n find the right CPU architecture for the GSI image, run the following\n command:\n\n ```\n adb shell getprop ro.product.cpu.abi\n ```\n\n Use the output to determine which GSI image to use when flashing your\n device. For example, on a Pixel 5, the output would indicate that the CPU\n architecture is `arm64-v8a`, so you would use the `arm64` type of GSI.\n\nDownload GSIs\n-------------\n\nThere are a few ways to get GSIs, depending on your development needs:\n\n- For Android Preview GSIs and Android GSIs with GMS, download the images from the [GSI release page](/topic/generic-system-image/releases).\n- For pre-built GSI images without GMS applications, download the images from\n the AOSP CI site:\n\n - [Android 10 (API level\n 29)](https://ci.android.com/builds/branches/aosp-android10-gsi/grid?)\n - [Android 11 (API level\n 30)](https://ci.android.com/builds/branches/aosp-android11-gsi/grid?)\n - [Android 12 (API level\n 31)](https://ci.android.com/builds/branches/aosp-android12-gsi/grid?)\n - [Android 13 (API level\n 33)](https://ci.android.com/builds/branches/aosp-android13-gsi/grid?)\n- To build Android GSIs without GMS, download source code from\n [AOSP](https://source.android.com/setup/build/gsi#building-gsis) and build\n your GSIs.\n\n| **Important:** Device manufacturers shouldn't use these versions of GSIs to run and submit compliance tests. Instead, device manufacturers should continue to refer to their existing communication channels, such as their Technical Account Managers for compliance-test-related activities.\n\nInstall a GSI\n-------------\n\n| **Note:** If your device has adopted [Android Verified\n| Boot](https://source.android.com/security/verifiedboot/avb) (AVB), download and flash the following image to disable AVB before flashing a GSI: [vbmeta.img](https://dl.google.com/developers/android/qt/images/gsi/vbmeta.img)\n\nInstalling a GSI is device-dependent. Refer to your device's manufacturer for\nthe exact tools and procedures. For Google Pixel devices such as the Pixel 3 and\nnewer, there are several ways to install:\n\n- Manually flashing GSI images: see [Requirements for flashing GSIs](https://source.android.com/setup/build/gsi#flashing-gsis)\n- Using Dynamic System Update (DSU) for devices that already run Android 10 or higher: see the [Dynamic System Updates](/topic/dsu) page\n\nGive feedback\n-------------\n\nGSIs are intended to help you validate your apps on Android. We appreciate your\nfeedback on the images, the tools, and the process for using GSIs on your\ndevices.\n\nTo notify us of bugs or feature requests, use the [dedicated issue tracker\ncomponent](https://issuetracker.google.com/issues/new?component=470386&template=1147338)\nfor GSIs.\n\nAdditional resources\n--------------------\n\n- [Understand the impact of Generic System Images (GSI) (Android Dev Summit\n '18)](https://www.youtube.com/watch?v=Y-HmCIHD63w)"]]
