Generische Systemimages (GSIs)

Ein generisches System-Image (GSI) ist eine reine Android-Implementierung mit unverändertem Code für das Android Open Source Project (AOSP), der 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 auch GSIs aus verschiedenen Release-Phasen des Android-Betriebssystems verwenden, einschließlich Entwicklervorschau- und Beta-Builds. Die Einbindung von GIs in Ihre Verifizierungs- und Testprozesse kann Ihnen einige zusätzliche Vorteile bieten:

  • Größere Testabdeckung für eine größere Anzahl von echten Geräten
  • Mehr Zeit, um Kompatibilitätsprobleme mit Apps zu beheben
  • 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, indem es vor jeder Veröffentlichung von Android mehr Möglichkeiten zur Verbesserung der App- und Betriebssystemqualität bietet.

Geräteübergreifender GSI-Support
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 bieten dieselben Kernsystemfunktionen für alle Geräte, auf denen sie installiert sind. Mit anderen Worten, eine GSI enthält nicht die Anpassungen des Geräteherstellers. Aus diesem Grund können in den folgenden Situationen Verhaltensunterschiede auftreten:

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

Gerätecompliance prüfen

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

  • Bootloader ist entsperrt.
  • Vollständig Höhen-kompatibel.
  • Bei Markteinführung 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 eine GSI verwenden kann und welche GSI-Betriebssystemversion Sie installieren sollten:

  1. Überprüfen Sie, ob Höhen unterstützt werden, indem Sie den folgenden Befehl ausführen:

    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 die versionsübergreifende Unterstützung mit dem folgenden Befehl:

    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-konform und das Gerät kann nur ein GSI für dieselbe Betriebssystemversion auf dem Gerät verwenden. So kann beispielsweise ein nicht VNDK-konformes Android 10-Gerät (API-Version 29) nur ein GSI-Image mit 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. In diesem Fall würden Sie den GSI-Typ arm64 verwenden.

GSIs herunterladen

Es gibt je nach Ihren Entwicklungsanforderungen mehrere Möglichkeiten, GSIs zu erhalten:

GSI installieren

.

Die Installation einer GSI-Installation ist geräteabhängig. Die genauen Werkzeuge und Verfahren erfahren Sie beim Gerätehersteller. Bei Google Pixel-Geräten wie Pixel 3 und neueren Modellen gibt es mehrere Installationsmöglichkeiten:

Feedback geben

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

Wenn Sie uns über Programmfehler oder Funktionsanfragen informieren möchten, verwenden Sie die spezielle Issue Tracker-Komponente für GSIs.

Weitere Informationen