Generische Systemimages (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 verschiedenen vorhandenen Android-Geräten durchzuführen und GSIs aus verschiedenen Android-Releasephasen zu 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 realer Geräte
  • Mehr Zeit zum Beheben von Kompatibilitätsproblemen von Apps
  • Mehr Möglichkeiten zur Behebung von Kompatibilitätsproblemen unter Android, die von App-Entwicklern gemeldet werden

Das GSI-Projekt ist Open Source und trägt zur Verbesserung der Android-Umgebung bei. Es bietet mehr Möglichkeiten zur Verbesserung der App- und Betriebssystemqualität vor jeder Android-Veröffentlichung.

GSI-Unterstützung auf allen Geräten
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 für alle Geräte, auf denen sie installiert sind, dieselben Kernsystemfunktionen. Mit anderen Worten: Eine GSI enthält keine Anpassungen des Geräteherstellers. Daher können in den folgenden Situationen Verhaltensunterschiede auftreten:

  • Interaktionen, die die Benutzeroberfläche betreffen
  • Workflows, die neuere Hardwarefunktionen anfordern

Gerätecompliance prüfen

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

  • Bootloader ist entsperrt.
  • Vollständige Treble-Konformität.
  • Die App wurde mit Android 9 (API-Level 28) oder höher auf den Markt gebracht. Geräte, die von einer früheren Version auf Android 9 aktualisiert wurden, unterstützen möglicherweise GSIs.

So ermitteln Sie, ob Ihr Gerät GSI verwenden kann und welche Version des GSI-Betriebssystems 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 lautet, ist das Gerät nicht mit GSIs kompatibel und Sie sollten nicht fortfahren. Wenn die Antwort true lautet, fahren Sie mit dem nächsten Schritt fort.

  2. Führen Sie den folgenden Befehl aus, um die versionsübergreifende Unterstützung zu prüfen:

    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 vollständig das Vendor Native Development Kit (VNDK) und kann jede Version des GSI-Betriebssystems (OS) 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 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. Beispielsweise kann ein nicht VNDK-kompatibles Gerät mit Android 10 (API-Version 29) nur ein GSI-Image von Android 10 laden.

  3. Der GSI-CPU-Architekturtyp muss der CPU-Architektur des Geräts entsprechen. 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

    Bestimmen Sie anhand der Ausgabe, welches GSI-Image beim Flashen Ihres Geräts verwendet werden soll. Auf einem Pixel 5 würde die Ausgabe beispielsweise anzeigen, dass die CPU-Architektur arm64-v8a ist, also 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 eines GSI ist geräteabhängig. Die genauen Tools und Verfahren finden Sie beim Hersteller Ihres Geräts. Für Google Pixel-Geräte wie das Pixel 3 und neuere gibt es mehrere Möglichkeiten zur Installation:

Feedback geben

GSIs sollen Ihnen dabei helfen, Ihre Apps auf Android zu prüfen. Wir freuen uns über Ihr Feedback zu den Bildern, den Tools und dem Prozess zur Verwendung von GSIs auf Ihren Geräten.

Verwenden Sie die spezielle Issue Tracker-Komponente für GSIs, um uns über Programmfehler oder Funktionsanfragen zu informieren.

Zusätzliche Ressourcen