Generische System-Images (GSIs)

Ein Generic System Image (GSI) ist eine reine Android-Implementierung mit unverändertem AOSP-Code (Android Open Source Project), 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 App-Tests auf einer Vielzahl vorhandener Android-Geräte durchzuführen. Dabei können sie GSIs aus verschiedenen Release-Phasen des Android-Betriebssystems verwenden, einschließlich Entwicklervorschau und Beta-Builds. Wenn Sie GIs in Ihre Überprüfungs- und Testprozesse aufnehmen, können Sie einige zusätzliche Vorteile nutzen:

  • Breitere Testabdeckung auf einer größeren Anzahl echter Geräte
  • Mehr Zeit zum Beheben von Kompatibilitätsproblemen von Apps
  • Mehr Möglichkeiten, von App-Entwicklern gemeldete Kompatibilitätsprobleme unter Android zu beheben

Das GSI-Projekt ist Open Source und trägt zur Verbesserung des Android-Ökosystems bei, da es vor jedem Android-Release mehr Möglichkeiten zur Verbesserung der App- und Betriebssystemqualität bietet.

Geräteübergreifende GSI-Unterstützung
Abbildung 1: GSIs können auf einer Vielzahl von Geräten installiert werden, manchmal auch bei Android-Versionen, für die ein Gerätehersteller kein eigenes System-Image bereitstellt.

GSIs enthalten dieselben grundlegenden Systemfunktionen für alle Geräte, auf denen sie installiert sind. Mit anderen Worten: Eine GSI enthält keine Anpassungen des Geräteherstellers. Daher kann es in den folgenden Situationen zu Verhaltensunterschieden kommen:

  • Interaktionen, die die Benutzeroberfläche betreffen
  • Workflows, für die neuere Hardwarefunktionen erforderlich sind

Geräteanforderungen prüfen

GSIs funktionieren nur auf Geräten mit den folgenden Eigenschaften:

  • Der Bootloader ist entsperrt.
  • Vollständig Treble-kompatibel.
  • Wurde mit Android 9 (API-Level 28) oder höher eingeführt. Bei Geräten, die von einer früheren Version auf Android 9 umgestellt wurden, werden GSIs möglicherweise unterstützt.

So ermitteln Sie, ob Ihr Gerät eine GSI verwenden kann und welche GSI-Betriebssystemversion Sie installieren sollten:

  1. Prüfen Sie mit dem folgenden Befehl, ob Treble unterstützt wird:

    adb shell getprop ro.treble.enabled

    Wenn die Antwort false ist, ist das Gerät nicht mit GSIs kompatibel und Sie sollten nicht fortfahren. Wenn die Antwort true ist, fahren Sie mit dem nächsten Schritt fort.

  2. Führen Sie den folgenden Befehl aus, um zu prüfen, ob die Version unterstützt wird:

    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 auf dem Gerät installierte Betriebssystemversion ist. Verwenden Sie nach Möglichkeit die neueste verfügbare GSI-Betriebssystemversion.

    Wenn der Wert für das Attribut false lautet, ist das Gerät nicht vollständig VNDK-konform und das Gerät kann nur ein GSI für dieselbe Betriebssystemversion auf dem Gerät verwenden. Ein Gerät mit Android 10 (API-Version 29), das nicht VNDK-kompatibel ist, kann beispielsweise nur ein GSI-Image von Android 10 laden.

  3. Der GSI-CPU-Architekturtyp 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. In diesem Fall würden Sie den GSI-Typ arm64 verwenden.

GSIs herunterladen

Je nach Ihren Entwicklungsanforderungen gibt es mehrere Möglichkeiten, GSIs zu erhalten:

GSI installieren

Die Installation einer GSI ist vom Gerät abhängig. Genaue Informationen zu den erforderlichen Tools und Verfahren erhalten Sie vom Hersteller Ihres Geräts. Für Google Pixel-Geräte wie Google Pixel 3 und höher gibt es mehrere Installationsmöglichkeiten:

Feedback geben

GSIs sollen Ihnen dabei helfen, Ihre Apps auf Android-Geräten zu validieren. Wir freuen uns über Ihr Feedback zu den Images, den Tools und der Verwendung von GSIs auf Ihren Geräten.

Wenn Sie uns Fehler melden oder Funktionsanfragen stellen möchten, verwenden Sie die eigene Problemverfolgungskomponente für GSIs.

Weitere Informationen