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.
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:
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 Antworttrue
lautet, fahren Sie mit dem nächsten Schritt fort.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]
nachnamespace.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.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-Typarm64
verwenden.
GSIs herunterladen
Je nach Ihren Entwicklungsanforderungen gibt es mehrere Möglichkeiten, GSIs zu erhalten:
- Lade die Bilder für Android Preview-GSIs und Android-GSIs mit GMS von der GSI-Releaseseite herunter.
Laden Sie für vordefinierte GSI-Images ohne GMS-Anwendungen die Images von der AOSP CI-Website herunter:
Wenn du Android-GSIs ohne GMS erstellen möchtest, lade den Quellcode von AOSP herunter und erstelle deine GSIs.
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:
- Manuelles Flashen von GSI-Bildern: siehe Anforderungen für das Flashen von GSIs
- Verwenden von Dynamic System Update (DSU) für Geräte, auf denen bereits Android 10 oder höher ausgeführt wird: siehe die Seite Dynamische Systemupdates
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.