Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ein generisches Systemimage (GSI) ist eine reine Android-Implementierung mit unverändertem Code des Open-Source-Projekts für Android (Android Open Source Project, AOSP), die auf einer Vielzahl von Android-Geräten ausgeführt werden kann.
App-Entwickler können die neuesten Android-GSIs installieren und ausführen, um Apps auf einer Vielzahl vorhandener Android-Geräte zu testen. Dabei können sie GSIs aus verschiedenen Android-Betriebssystem-Releases verwenden, darunter Developer Preview- und Beta-Builds. Das Hinzufügen von GSIs zu Ihren Bestätigungs- und Testprozessen kann Ihnen einige zusätzliche Vorteile bieten:
Größere Testabdeckung auf einer größeren Anzahl echter Geräte
Mehr Zeit zum Beheben von Problemen mit der App-Kompatibilität
Mehr Möglichkeiten, von App-Entwicklern gemeldete Kompatibilitätsprobleme in Android zu beheben
Das GSI-Projekt ist Open Source und trägt zur Verbesserung der Android-Plattform bei, indem es vor jeder Android-Version mehr Möglichkeiten bietet, die Qualität von Apps und Betriebssystemen zu verbessern.
Abbildung 1: GSIs können auf einer Vielzahl von Geräten installiert werden, manchmal sogar für Android-Versionen, für die ein Gerätehersteller kein eigenes Systemimage bereitstellt.
GSIs enthalten dieselben Kernsystemfunktionen für alle Geräte, auf denen sie installiert sind. Eine GSI enthält also keine Anpassungen des Geräteherstellers. Daher kann es in den folgenden Situationen zu Verhaltensunterschieden kommen:
Interaktionen, bei denen die Benutzeroberfläche verwendet wird
Workflows, die neuere Hardwarefunktionen erfordern
Gerätekonformität prüfen
GSIs können nur auf Geräten mit den folgenden Eigenschaften ausgeführt werden:
Der Bootloader ist entsperrt.
Vollständig Treble-kompatibel.
Bei Markteinführung mit Android 9 (API‑Level 28) oder höher. Geräte, die von einer früheren Version auf Android 9 aktualisiert wurden, unterstützen GSIs möglicherweise nicht.
So ermitteln Sie, ob Ihr Gerät ein GSI verwenden kann und welche GSI-Betriebssystemversion Sie installieren sollten:
Prüfen Sie mit dem folgenden Befehl, ob Treble unterstützt wird:
adb shell getprop ro.treble.enabled
Wenn die Antwort false lautet, ist das Gerät nicht mit GSIs kompatibel und Sie sollten nicht fortfahren. Wenn die Antwort true lautet, fahre mit dem nächsten Schritt fort.
Prüfen Sie mit dem folgenden Befehl, ob die Versionen kompatibel sind:
adb shell cat /system/etc/ld.config.version_identifier.txt \
| grep -A 20 "\[vendor\]"
Suchen Sie in der Ausgabe im Abschnitt [vendor] nach namespace.default.isolated.
Wenn der Wert für dieses Attribut true ist, unterstützt das Gerät das Vendor Native Development Kit (VNDK) vollständig und kann jede GSI-Betriebssystemversion verwenden, die neuer als die Betriebssystemversion auf dem Gerät ist. Verwenden Sie nach Möglichkeit die neueste verfügbare GSI-Betriebssystemversion.
Wenn der Wert für das Attribut false ist, ist das Gerät nicht vollständig VNDK-kompatibel und kann nur ein GSI für dieselbe On-Device-Betriebssystemversion verwenden. Auf einem Gerät mit Android 10 (API-Version 29), das nicht VNDK-kompatibel ist, kann beispielsweise nur ein Android 10-GSI-Image geladen werden.
Der CPU-Architekturtyp des GSI muss mit der CPU-Architektur des Geräts übereinstimmen. Führen Sie den folgenden Befehl aus, um die richtige CPU-Architektur für das GSI-Image zu ermitteln:
adb shell getprop ro.product.cpu.abi
Anhand der Ausgabe können Sie ermitteln, welches GSI-Image Sie beim Flashen Ihres Geräts verwenden müssen. Auf einem Pixel 5 würde die Ausgabe beispielsweise angeben, dass die CPU-Architektur arm64-v8a ist. Sie würden also den GSI-Typ arm64 verwenden.
GSIs herunterladen
Je nach Ihren Entwicklungsanforderungen gibt es verschiedene Möglichkeiten, GSIs zu erhalten:
Für Android-Preview-GSIs und Android-GSIs mit GMS laden Sie die Images von der GSI-Releaseseite herunter.
Wenn Sie vorgefertigte GSI-Images ohne GMS-Anwendungen verwenden möchten, laden Sie die Images von der AOSP CI-Website herunter:
Wenn Sie Android-GSIs ohne GMS erstellen möchten, laden Sie den Quellcode von AOSP herunter und erstellen Sie Ihre GSIs.
GSI installieren
Die Installation eines GSI ist geräteabhängig. Informationen zu den genauen Tools und Verfahren erhalten Sie vom Hersteller Ihres Geräts. Für Google Pixel-Geräte wie das Pixel 3 und neuere Modelle gibt es mehrere Installationsmöglichkeiten:
Verwenden von Dynamic System Update (DSU) für Geräte, auf denen bereits Android 10 oder höher ausgeführt wird: siehe die Seite Dynamic System Updates
Feedback geben
GSIs sollen Ihnen helfen, Ihre Apps auf Android zu validieren. Wir freuen uns über Ihr Feedback zu den Bildern, den Tools und dem Verfahren zur Verwendung von GSIs auf Ihren Geräten.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-08-25 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)"]]
