Generische Systemimages (GSIs)

Ein generisches System-Image (GSI) ist ein reine Android-Implementierung mit unverändertem Android Open Source Project (AOSP) Code, der auf einer Vielzahl von Android-Geräten ausgeführt werden kann.

App-Entwickler können die neuesten GSIs für Android installieren und ausführen, um Apps auszuführen auf verschiedenen bestehenden Android-Geräten testen und GSIs von verschiedenen Android OS-Releasephasen, einschließlich Entwicklervorschau und Beta-Builds. Wird hinzugefügt GSIs, die Ihren Überprüfungs- und Testverfahren hinzugefügt werden, können Ihnen zusätzliche Vorteile:

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

Das GSI-Projekt ist offen Quelle und trägt zur Verbesserung der Android-Plattform bei, indem mehr Möglichkeiten zur Verbesserung von Apps geboten werden. und die Qualität des Betriebssystems.

<ph type="x-smartling-placeholder">

</ph>

Abbildung 1: GSIs können für eine Vielzahl von und manchmal sogar für Android-Versionen, die vom Gerätehersteller kein eigenes System-Image bereitstellt.

GSIs enthalten für alle Geräte dieselben grundlegenden Systemfunktionen. installiert ist. Mit anderen Worten: Eine GSI umfasst nicht die Anpassungen. Aus diesem Grund können Verhaltensunterschiede in den folgenden Situationen:

• 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 mit Upgrade auf Android 9 aus einer früheren Version unterstützt möglicherweise GSIs.

Warnung: Der Versuch, eine GSI-Datei auf ein nicht kompatibles Gerät zu flashen, kann dazu führen, dass kann Ihr Gerät nicht mehr gestartet werden. Überprüfen Sie immer, ob Ihr Gerät konform ist. und folgen Sie der Anleitung auf der Hersteller. GSIs unterstützen kein Rollback, daher benötigen Sie eine Wiederherstellungsmethode und das ursprüngliche System-ROM, um das ursprüngliche System wiederherzustellen.

So ermitteln Sie, ob Ihr Gerät GSI verwenden kann und welche Version des GSI-Betriebssystems Sie verwenden: installiert werden soll, gehen Sie so vor:

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 nicht fortfahren sollte. 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\]"

   Hinweis: Je nach Plattform wird die Konfigurationsdatei in den vorherigen kann eine Versions-ID enthalten.

   Suchen Sie in der Ausgabe im Abschnitt [vendor] nach namespace.default.isolated.

   Wenn der Wert für dieses Attribut true lautet, unterstützt das Gerät Anbieter Native Development Kit (VNDK) und kann mit jede Version des GSI-Betriebssystems, die neuer als das Betriebssystem auf dem Gerät ist Version. 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 dasselbe On-Device-Betriebssystem verwenden Version. Beispiel: Ein Android 10-Gerät (API-Version 29), das nicht VNDK-konform können nur GSI-Images mit Android 10 geladen werden.

3. Der GSI-CPU-Architekturtyp muss der CPU-Architektur des Geräts entsprechen. Bis um die richtige CPU-Architektur für das GSI-Image zu finden, führen Sie den folgenden Befehl aus: Befehl:

   adb shell getprop ro.product.cpu.abi

   Bestimmen Sie anhand der Ausgabe, welches GSI-Image beim Flashen Ihres . Auf einem Pixel 5 würde die Ausgabe z. B. anzeigen, dass die CPU Architektur ist arm64-v8a, Sie würden also den GSI-Typ arm64 verwenden.

GSIs herunterladen

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

• Für Android Preview-GSIs und Android-GSIs mit GMS die Bilder von auf der Releaseseite für GSI.

• Für vorgefertigte GSI-Bilder ohne GMS-Apps laden Sie die Bilder von Website von AOSP CI:

  • Android 10 (API-Level) 29)
  • Android 11 (API-Level) 30)
  • Android 12 (API-Level 31).
  • Android 13 (API-Level) 33).

• Wenn Sie Android-GSIs ohne GMS erstellen möchten, laden Sie den Quellcode herunter von AOSP und erstellen Ihre GSIs.

Wichtig :Gerätehersteller sollten diese Versionen von GSIs nicht für die Ausführung und Compliance-Tests einreichen. Stattdessen sollten Gerätehersteller weiterhin Kommunikationskanäle wie z. B. das technische Konto Manager für Aktivitäten im Zusammenhang mit Compliance-Tests.

GSI installieren

Hinweis: Wenn Ihr Gerät Android Verified unterstützt Starten (AVB), Herunterladen und Flashe das folgende Bild, um AVB vor dem Flashen einer GSI-Datei zu deaktivieren: vbmeta.img

Die Installation eines GSI ist geräteabhängig. Wenden Sie sich an den Hersteller Ihres Geräts, die genauen Tools und Verfahren. Für Google Pixel-Geräte wie das Pixel 3 und neueren Versionen 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 mit Android 10 oder Höhere Werte: siehe Seite Dynamische Systemupdates

Feedback geben

GSIs sollen Ihnen dabei helfen, Ihre Apps auf Android zu prüfen. Vielen Dank, dass Sie Feedback zu den Bildern, den Tools und dem Verfahren zur Verwendung von GSIs auf Ihrem Geräte.

Nutzen Sie den entsprechenden Issue Tracker, um uns über Programmfehler oder Funktionsanfragen zu informieren. Komponente für GSIs.

Weitere Informationen

• Auswirkungen von generischen Systembildern (GSI) verstehen (Android Dev Summit) 2018)