Kurzanleitung für Android GPU Inspector

In diesem Thema wird beschrieben, wie Sie Systemprofilerstellung und Frame-Profiling in Ihrer Android-App mithilfe von Android GPU Inspector (AGI) testen.

Dieser Schnellstart richtet sich an Entwickler, die mit Grafiken vertraut sind. auf Android-Geräten entwickelt.

Computeranforderungen

Der Computer, auf dem AGI ausgeführt wird, muss folgende Anforderungen erfüllen:

Eines der folgenden Betriebssysteme ist erforderlich:
- Windows: Windows 7 oder höher.
- macOS: El Capitan (10.11) oder höher
- Linux: Java 64-Bit JDK oder JRE 8 (oder höher) ist erforderlich. Ubuntu Trusty Tahr (14.04 oder höher) wird empfohlen.
Das ADB-Befehlszeilentool

AGI herunterladen und installieren

Laden Sie AGI für Ihr Betriebssystem herunter und installieren Sie es.

Anforderungen an Android-Apps

In diesem Abschnitt werden die Anforderungen an die Android-App beschrieben, die Profil erstellt:

Ihre Android-App muss debug-fähig sein. die Debug-fähiges Attribut im Android-Manifest der App muss auf true festgelegt sein. Dieses Attribut ermöglicht die korrekte Instrumentierung aus dem Grafiktreiber. Für Vulkan kann AGI mit diesem Attribut seine eigene Vulkan-Schicht hinzufügen, Anwendung gestartet.
```
<application [...] android:debuggable="true">
```

Wenn Ihre App Vulkan nativ verwendet, erfordert AGI außerdem Folgendes:

Ihre Anwendung muss Vulkan-Validierungsebenen haben. aktiviert. Sind sie nicht aktiviert, können Sie die folgenden Befehle ausführen, um Ihre App mit den Validierungsebenen aus der AGI-APK-Datei ausführen (com.google.android.gapid.<abi>):

app_package=<YOUR APP PACKAGE NAME HERE>
abi=arm64v8a # Possible values: arm64v8a, armeabi-v7a, x86

adb shell settings put global enable_gpu_debug_layers 1
adb shell settings put global gpu_debug_app ${app_package}
adb shell settings put global gpu_debug_layer_app com.google.android.gapid.${abi}
adb shell settings put global gpu_debug_layers VK_LAYER_KHRONOS_validation

Wenn Sie mit der Profilerstellung fertig sind, können Sie diese Validierungsebenen mit der Funktion folgenden Befehle:

adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layers
adb shell settings delete global gpu_debug_layer_app

Ihre App darf keine Warnungen oder Fehler melden, wenn sie mit dem Vulkan-Validierungsebenen aktiviert. Beheben Sie alle Vulkan-Validierungsfehler, bevor Sie ein Profil erstellen.
Wenn Sie Beta-GPU-Treiber verwenden, fügen Sie die folgenden Metadaten in die <application>-Tag des Android-Manifests:
```
<meta-data
          android:name="com.android.graphics.developerdriver.enable"
          android:value="true" />
```

Anforderungen an Android-Geräte

Für AGI gelten die folgenden Android-Geräteanforderungen:

Ein unterstütztes Android-Gerät mit Android 11 oder höher
Ein USB-Kabel
ADB-Fehlerbehebung muss aktiviert sein und das Gerät muss über ADB zugänglich sein. Aktivieren Sie die Option Über USB installieren, wenn sie angezeigt wird.

Gerätevalidierung

Für AGI ist ein kompatibler GPU-Treiber erforderlich. Um eine gültige Profilerstellung zu gewährleisten führt AGI eine Validierungsprüfung durch, sobald Sie ein neues Gerät zum ersten Mal anschließen. dauert etwa zehn Sekunden. Nach bestandener Prüfung kannst du mit dem Gerät Profil für Android-Apps erstellen.

Bitte das Gerät während der Überprüfung nicht stören. Dies kann dazu führen, damit die Validierung fehlschlägt. Wenn ein Gerät die Validierung nicht besteht, aber richtig eingerichtet ist, können Sie die Überprüfung wiederholen, indem Sie das Gerät noch einmal auswählen.

Die Validierung ist ein einmaliger Schritt für ein Gerät. Ergebnisse werden für die Zukunft im Cache gespeichert. Nutzung von AGI. AGI führt die Validierung jedoch noch einmal durch, wenn sich die Geräteeinrichtung ändert. z. B. ob der GPU-Treiber oder die Android-Version aktualisiert wird.

Wenn ein Gerät als unterstütztes Gerät aufgeführt ist, haben Sie folgende Möglichkeiten: erwarten, dass das AGI die Validierung besteht. Wenn das Gerät nicht aufgeführt ist, lautet der GPU-Treiber wahrscheinlich nicht mit AGI kompatibel.

Wenn Ihr Gerät unterstützt wird, die Überprüfung aber fehlschlägt

Prüfen Sie, ob alle Android-Anforderungen erfüllt sind und Computeranforderungen, die in den vorherigen Abschnitten beschrieben wurden, und ob das Gerät ordnungsgemäß mit einem USB-Kabel an den Computer angeschlossen ist.

Wenn alle Anforderungen erfüllt sind, Problem melden in unserem GitHub in dem das Verhalten beschrieben wird.

Wenn Ihr Gerät nicht unterstützt wird

Wir arbeiten mit unseren OEM-Partnern zusammen, um weitere Geräte zu unterstützen. Sie können ein Problem melden in unserer GitHub-Repository, um Support für ein Gerät anzufordern.

Profildaten erfassen

In den folgenden Abschnitten wird beschrieben, wie Sie Profildaten erfassen und die Trace-Datei erstellt, damit Sie die Ergebnisse analysieren können.

Android-Einstellungen konfigurieren

Bevor Sie mit der Profilerstellung beginnen, müssen Sie diese Android-Apps und -Geräte konfigurieren Einstellungen, mit denen die App und das Gerät festgelegt werden, für das ein Profil erstellt werden soll.

Schließen Sie Ihr Android-Gerät mit einem USB-Kabel an den Computer an.
Starten Sie AGI auf Ihrem Computer.

Wenn Sie AGI zum ersten Mal starten, wird der Willkommensbildschirm angezeigt, fordert Sie den Pfad zur ausführbaren ADB an. AGI speichert diese Einstellungen in die Datei .agic im Ordner HOME. Wenn Sie dies bereits getan haben, können Sie diesen Schritt überspringen.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 1: Begrüßungsbildschirm
Geben Sie den Pfad zur ausführbaren ADB in das Feld Pfad zu ADB ein. Die Kontrollkästchen hinter diesem Feld sind optional.
Klicken Sie auf Jetzt starten, um den Startbildschirm aufzurufen.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 2: Hauptstartbildschirm von Android GPU Inspector
Klicken Sie im Startbildschirm auf Neuen Trace erstellen. Dadurch wird Folgendes angezeigt: Dialogfeld Neuen Trace erfassen. Alternativ können Sie auch auf das Schaltfläche Trace im Systemprofil erfassen
<ph type="x-smartling-placeholder">
</ph>
Abbildung 3: Dialogfeld „Neuen Trace erfassen“
Wählen Sie im Abschnitt Gerät und Typ das Android-Gerät aus, das Sie zu erstellen. Wenn es nicht in der Liste Gerät angezeigt wird, klicken Sie auf die Schaltfläche zum Aktualisieren um die Liste zu aktualisieren.
Wählen Sie im Abschnitt Anwendung die App aus, für die Sie ein Profil erstellen möchten. Wenn nur eine Aktivität enthält, können Sie das Paket statt auf die Aktivität.

AGI enthält eine Vulkan-Beispiel-App. Um die Beispiel-App anstelle Ihrer eigenen zu verwenden, führen Sie folgende Schritte aus:
1. Klicken Sie neben dem Feld Anwendung auf die Schaltfläche ....
  
  Daraufhin wird das Dialogfeld Select an Application to Trace (Anwendung zum Verfolgen auswählen) angezeigt, in dem zeigt eine Liste der Apps an, die auf dem ausgewählten Gerät nachverfolgt werden können.
2. Geben Sie im Textfeld Filter gapid ein, damit nur Apps angezeigt werden. deren Paketname gapid enthält.
3. Maximieren Sie das Paket und wählen Sie com.google.android.gapid.VkSampleActivity und klicken Sie dann auf OK.
  
  Dadurch kehren Sie zum Dialogfeld Capture A New Trace (Neuen Trace erfassen) zurück. Anwendung, das von der ausgewählten App ausgefüllt wird.
Lassen Sie im Abschnitt Application (Anwendung) die anderen Felder leer.
Klicken Sie auf OK.

Jetzt können Sie mit AGI ein System- und Frame-Profiling durchführen.

Profil für ein System erstellen

Führen Sie die folgenden Schritte aus, um ein Profil für ein System zu erstellen:

Klicken Sie im AGI-Startbildschirm auf Neuen Trace erfassen, um die Dialogfeld Capture System Profile (Systemprofil erfassen).
Wählen Sie in der Liste Typ die Option Systemprofil aus.
Setzen Sie im Bereich Start und Dauer die Option Start bei auf Manuell. und Duration auf 2.
Klicken Sie im Abschnitt Trace-Optionen auf Konfigurieren. Daraufhin wird eine Liste von Profilerstellungsoptionen.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 4 : Die Profilerstellungsoptionen in der Dialogfeld Capture System Profile (Systemprofil erfassen).
Wählen Sie die Profildaten aus, die Sie erfassen möchten.
Klicken Sie im Abschnitt GPU auf Auswählen.

Daraufhin wird eine Liste mit Zählern zur Auswahl angezeigt.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 5 : Zähler auswählen
Klicken Sie auf default (Standard), um die gewünschten Standardzähler auszuwählen, und klicken Sie dann auf OK. um die Profilerstellungsoptionen zurückzugeben.
Klicke auf OK, um zum Hauptdialogfeld Capture System Profile (Systemprofil erfassen) zurückzukehren.
Wählen Sie im Abschnitt Output (Ausgabe) ein Output Directory (Ausgabeverzeichnis) zum Speichern der Datei aus. Die Trace-Dateien, die während der Profilerstellung generiert werden. Das Feld Dateiname automatisch ausgefüllt, aber Sie können sie auch bearbeiten.
Klicken Sie auf OK. Dadurch wird die ausgewählte App auf dem Android-Gerät gestartet und öffnet ein Pop-up-Fenster mit der Schaltfläche Start.
Klicken Sie auf die Schaltfläche Start, um mit der Erfassung der Profildaten zu beginnen. bis der Vorgang abgeschlossen ist.
Klicken Sie auf Trace öffnen. Zunächst wird eine Ansicht angezeigt, ähnlich wie systrace.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 6 : Die Benutzeroberfläche des System Profiler

Zusätzlich zu den in Systrace verfügbaren Daten zeigt AGI auch GPU an. Leistungsinformationen. Weitere Informationen zum Aufrufen der Systemprofilerstellung finden Sie unter AGI-Systemprofil ansehen.

Informationen zu zusätzlichen Einstellungen finden Sie unter Optionen für die Systemprofilerstellung.

Profil für einen Frame erstellen

Führen Sie die folgenden Schritte aus, um ein Profil für einen einzelnen Frame aus Ihrer App zu erstellen:

Klicken Sie im AGI-Startbildschirm auf Neuen Trace erfassen, um die Dialogfeld Capture A New Trace (Neuen Trace erfassen). Alternativ können Sie auch auf das Schaltfläche Frame-Profil-Trace erfassen.
Wählen Sie aus der Liste Type (Typ) je nach ANGLE die Option Vulkan oder OpenGL on ANGLE aus. welche Graphics API Ihre App verwendet. Achten Sie darauf, das richtige Andernfalls erfasst AGI keine Grafikbefehle.
Legen Sie im Abschnitt Start und Dauer für Start bei die Option Manuell fest. Wenn auf die Schaltfläche Frame-Profil-Trace erfassen geklickt haben, ist dieser Schritt bereits abgeschlossen.
Wählen Sie im Abschnitt Output (Ausgabe) ein Output Directory (Ausgabeverzeichnis) zum Speichern der Datei aus. Ablaufverfolgungsdateien. Das Feld Dateiname sollte automatisch ausgefüllt werden, auch bearbeiten.
Optional:Bei einigen Apps wird ein anderer Prozess für die gesamten Grafikelemente gestartet. Datenverarbeitung. Geben Sie seinen Namen an, um diesen Prozess zu erfassen.
Klicken Sie auf OK. Dadurch wird deine App auf dem Android-Gerät gestartet und eine Pop-up-Fenster mit der Schaltfläche Start.
Klicken Sie auf die Schaltfläche Start und warten Sie einige Sekunden, bis die Profilerstellung abgeschlossen ist. abgeschlossen ist.
Klicken Sie auf Trace öffnen, um die Profiling-Daten anzusehen. Weitere Informationen zu den einzelnen auf der Frame Profiler-Benutzeroberfläche finden Sie Frame-Profiling – Übersicht

Informationen zu zusätzlichen Einstellungen finden Sie unter Optionen für die Frame-Profilerstellung.