Generische System-Images (GSIs)

Ein generisches Systemimage (GSI) ist eine reine Android-Implementierung mit unverändertem Code des Open-Source-Projekts für Android (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 von vorhandenen Android-Geräten durchzuführen und GSIs aus verschiedenen Android-Betriebssystem-Releases zu verwenden, einschließlich Entwicklervorschau- und Beta-Builds. Wenn Sie GSIs in Ihre Bestätigungs- und Testprozesse einbeziehen, ergeben sich einige zusätzliche Vorteile:

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

Das GSI-Projekt ist Open Source und trägt zur Verbesserung des Android-Ökosystems 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 System-Image 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äte-Compliance prüfen

GSIs können nur auf Geräten mit den folgenden Eigenschaften verwendet werden:

  • Der Bootloader ist entsperrt.
  • Vollständig Treble-kompatibel.
  • Das Gerät wurde 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 GSIs möglicherweise nicht.

So ermitteln 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, fahre mit dem nächsten Schritt fort.

  2. Prüfen Sie mit dem folgenden Befehl, ob die Versionen unterstützt werden:

    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 GSI-Image für Android 10 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 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, GSI zu erhalten:

GSI installieren

Die Installation einer 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 Möglichkeiten zur Installation:

Feedback geben

GSIs sollen Ihnen helfen, Ihre Apps unter 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.

Wenn Sie uns Fehler melden oder Feature Requests senden möchten, verwenden Sie die spezielle Komponente zur Problemverfolgung für GSIs.

Zusätzliche Ressourcen