Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Una imagen genérica del sistema (GSI) es una implementación de Android en estado puro que incluye código sin modificar del Proyecto de código abierto de Android (AOSP) y que se puede ejecutar en diversos dispositivos Android.
Los desarrolladores de apps pueden instalar y ejecutar las últimas GSIs de Android para realizar pruebas en una variedad de dispositivos Android existentes y usar las GSIs de diferentes etapas de lanzamiento del SO Android, incluidas las compilaciones de la Versión preliminar para desarrolladores y la versión beta. Agregar GSIs a tus procesos de verificación y prueba puede proporcionarte algunos beneficios adicionales:
Amplia cobertura de prueba en un conjunto más grande de dispositivos reales
Más tiempo para solucionar problemas de compatibilidad de apps
Más oportunidades para solucionar problemas de compatibilidad en Android que informan los desarrolladores de apps
El proyecto de GSI es de código abierto y ayuda a mejorar el ecosistema de Android, ya que proporciona más formas de optimizar la calidad de las apps y del SO antes de cada lanzamiento de Android.
Figura 1: Las GSIs se pueden instalar en una amplia variedad de dispositivos y, a veces, incluso para versiones de Android para las que un fabricante de dispositivos no proporciona su propia imagen del sistema.
Las GSIs incluyen las mismas funciones principales del sistema para todos los dispositivos en los que están instaladas. En otras palabras, una GSI no incluye las personalizaciones del fabricante del dispositivo. Debido a esto, puedes encontrar diferencias de comportamiento en las siguientes situaciones:
Interacciones que involucran a la IU
Flujos de trabajo que requieren nuevas funciones de hardware
Cómo verificar el cumplimiento del dispositivo
Las GSIs solo pueden funcionar en dispositivos con las siguientes características:
Tienen el bootloader desbloqueado.
Son totalmente compatibles con Treble.
Se lanzaron con Android 9 (nivel de API 28) o versiones posteriores. Es posible que los dispositivos actualizados a Android 9 desde una versión anterior no sean compatibles con las GSIs.
Para verificar si tu dispositivo puede usar una GSI y para saber qué versión de SO de GSI debes instalar, sigue estos pasos:
Ejecuta el siguiente comando para corroborar si es compatible con Treble:
adb shell getprop ro.treble.enabled
Si la respuesta es false, el dispositivo no es compatible con GSIs, y no debes continuar con la instalación. Si es true, ve al próximo paso.
Ejecuta el siguiente comando para verificar si es compatible con varias versiones:
adb shell cat /system/etc/ld.config.version_identifier.txt \
| grep -A 20 "\[vendor\]"
En el resultado, busca namespace.default.isolated en la sección [vendor].
Si el valor de ese atributo es true, significa que el dispositivo es totalmente compatible con el kit de desarrollo nativo del proveedor (VNDK) y que se puede usar cualquier versión del sistema operativo (SO) de GSI posterior a la versión del SO del dispositivo. Siempre que sea posible, usa la versión más reciente del SO de GSI.
Si el valor del atributo es false, significa que el dispositivo no cumple con todos los requisitos necesarios del VNDK y que solo se puede usar una versión de GSI que coincida con la del SO del dispositivo. Por ejemplo, un dispositivo con Android 10 (versión de la API 29) que no cumple con los requisitos del VNDK solo puede cargar una imagen de GSI de Android 10.
El tipo de arquitectura de CPU de GSI debe coincidir con la del dispositivo. Ejecuta el siguiente comando para obtener la arquitectura de CPU correcta para la imagen de GSI:
adb shell getprop ro.product.cpu.abi
Utiliza el resultado para ver qué imagen de GSI debes instalar en el dispositivo. Por ejemplo, en un Pixel 5, el resultado indicaría que la arquitectura de CPU es arm64-v8a. Por lo tanto, deberías usar el tipo arm64 de GSI.
Cómo descargar GSIs
Hay algunas maneras de obtener GSIs según las necesidades de desarrollo:
Para GSIs de versión preliminar de Android y GSIs de Android con GMS, descarga las imágenes desde la página de versiones de GSI.
En el caso de las imágenes de GSI precompiladas sin aplicaciones de GMS, descarga las imágenes del sitio de CI de AOSP:
Para compilar GSIs de Android sin GMS, descarga el código fuente de AOSP y compila tus GSIs.
Cómo instalar una GSI
La instalación de una GSI depende del dispositivo. Consulta al fabricante del dispositivo para conocer las herramientas y los procedimientos exactos. En los dispositivos Google Pixel, como Pixel 3 y modelos más nuevos, hay varias formas de instalación:
Usar la Actualización dinámica del sistema (DSU) para dispositivos que ya ejecutan Android 10 o versiones posteriores: consulta la página Actualizaciones dinámicas del sistema
Cómo enviar comentarios
Las GSIs están pensadas para ayudarte a validar tus apps en Android. Los comentarios sobre imágenes, herramientas y el proceso de uso de las GSIs en tus dispositivos son bienvenidos.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-08-25 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
