Generische System-Images (GSIs)

Ein generisches Systemimage (GSI) ist eine reine Android-Implementierung mit unverändertem Open-Source-Projekt für Android-Code (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 App-Tests auf einer Vielzahl vorhandener Android-Geräte und mit GSIs aus verschiedenen Android-Betriebssystemversionen durchzuführen, einschließlich Entwicklervorschau- und Beta-Builds. Wenn Sie GSIs zu Ihren Überprüfungs- und Testprozessen hinzufügen, können Sie einige zusätzliche Vorteile nutzen:

  • Breitere 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 mehr Möglichkeiten bietet, die Qualität von Apps und Betriebssystemen vor jeder Android-Version zu verbessern.

GSI-Unterstützung auf allen Geräten
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 für alle Geräte, auf denen sie installiert sind, dieselben Kernsystemfunktionen. Mit anderen Worten: Ein GSI enthält keine Anpassungen des Geräteherstellers. Aus diesem Grund kann es in den folgenden Situationen zu Verhaltensunterschieden kommen:

  • Interaktionen mit der Benutzeroberfläche
  • Workflows, die neuere Hardwarefunktionen erfordern

Gerätekonformität prüfen

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

  • Der Bootloader ist entsperrt.
  • Vollständig Treble-konform.
  • Mit Android 9 (API-Level 28) oder höher eingeführt. Geräte, die von einer früheren Version auf Android 9 aktualisiert wurden, unterstützen möglicherweise GSIs.

So prüfen Sie, ob Ihr Gerät ein 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 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. Prüfen Sie mit dem folgenden Befehl, ob versionsübergreifende Unterstützung vorhanden ist:

    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 Betriebssystem version 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-konform und kann nur ein GSI für dieselbe auf dem Gerät installierte Betriebssystemversion verwenden. Auf einem Android 10-Gerät (API-Version 29), das nicht VNDK-konform ist, kann beispielsweise nur ein Android 10-GSI-Image geladen werden.

  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 finden:

    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 darauf hinweisen, dass die CPU Architektur arm64-v8a ist. Sie würden also den arm64 Typ von GSI verwenden.

GSIs herunterladen

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

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:

Feedback geben

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

Wenn Sie uns Fehler melden oder Feature Requests senden möchten, verwenden Sie die entsprechende Problemverfolgungskomponente für GSIs.

Zusätzliche Ressourcen