Mit Android GPU Inspector (AGI) können Sie ein bestimmtes Frame Ihrer Android-App profilieren und damit eine detaillierte Analyse der GPU-Nutzung der App durchführen. Mit diesen Profiling-Daten erhalten Sie ein besseres Verständnis der GPU-Nutzung Ihrer App als mit dem System-Profiling allein.
Beim Frame-Profiling mit AGI werden zuerst Traces und andere Leistungsdaten erfasst und dann gemessen und zur Analyse angezeigt.
Die verfügbaren Daten zur Frame-Profilierung umfassen Folgendes:
Vulkan-API-Aufrufe
Framebuffer-Inhalt
Gerenderte Mesh-Zeichenaufrufe
RAM- und GPU-Arbeitsspeicherwerte für Befehle
GPU-Leistungsdaten für Rendering-Ereignisse
Pipelinedaten
Statusdaten rendern
Textur- und Shader-Ressourcen
Erste Schritte
In der AGI-Kurzanleitung wird beschrieben, wie Sie AGI einrichten, Frame-Profildaten erfassen und die resultierende Tracedatei öffnen. Im nächsten Abschnitt werden die Konfigurationsoptionen genauer beschrieben.
Profilerstellungsoptionen
In diesem Abschnitt werden die wichtigsten Optionen beschrieben, die beim Erstellen eines Frame-Profils verfügbar sind.
Optionen für die Graphics API
Die Optionen für die Graphics API geben die von Ihrer App verwendete Graphics API an. Die Optionen sind im Dialogfeld Systemprofil erfassen in der Liste Typ verfügbar. Folgende Optionen sind verfügbar:
- Vulkan: für Apps, die die Vulkan API direkt verwenden.
- OpenGL on ANGLE: für Apps, die OpenGL ES verwenden.
AGI verfolgt Vulkan-Befehle direkt. Wenn Ihre App jedoch OpenGL ES verwendet, nutzt AGI einen benutzerdefinierten ANGLE-Build, um die Befehle in Vulkan-Befehle zu übersetzen, bevor die App getracet wird.
Zusätzliche Argumente
Im Feld Zusätzliche Argumente können Sie zusätzliche Flags an den adb-Befehl am start-activity übergeben, der an Ihr Gerät gesendet wird, um Ihre App während des Profilings zu starten. Weitere Informationen finden Sie unter adb-Befehle.
Optionen für Start und Dauer
Im Bereich Start und Dauer können Sie angeben, wie AGI den zu profilierenden Frame erfasst. Folgende Optionen sind verfügbar:
Beginn: AGI erfasst alle Befehle vom Start der Anwendung bis zum Ende des ersten gerenderten Frames.
Manuell: Drücken Sie eine Taste im Tracing-Dialogfeld, um den Frame manuell zu erfassen.
Zeit: AGI nimmt automatisch ein Bild auf, nachdem die angegebene Anzahl von Sekunden vergangen ist.
Frame: AGI erfasst automatisch den angegebenen Frame.
Trace-Optionen
Der Bereich Trace-Optionen enthält Einstellungen zum Konfigurieren von Trace-Flags. Folgende Einstellungen sind verfügbar:
Zwischenspeichern deaktivieren: Deaktiviert das Zwischenspeichern von Daten auf dem Gerät während der Erfassung. Diese Option ist nützlich, um einen App-Absturz zu beheben, da sie dafür sorgt, dass alle Tracing-Daten bis zum Absturz serialisiert werden. Dadurch erhöht sich jedoch der Aufwand von AGI während des Profilings geringfügig.
Nicht unterstützte Erweiterungen einbeziehen: Schließen Sie Erweiterungen ein, die von AGI auf dem Gerät nicht unterstützt werden. Wenn Ihre App eine Erweiterung verwendet, die von AGI nicht unterstützt wird, kann es beim Wiedergeben des Traces zu unerwünschtem Verhalten kommen, z. B. zu subtilen Fehlern oder Abstürzen. Liste der unterstützten Erweiterungen
Paketdaten löschen: Verwenden Sie den
pm clear-adb-Befehl, um das Gerät aufzufordern, die Nutzerdaten Ihrer App vor dem Start zu löschen.
Ausgabeeinstellungen
Der Abschnitt Ausgabe enthält Einstellungen für die Speicherung von Tracedateien, z. B.:
Geben Sie das Verzeichnis an, in dem die Tracedatei gespeichert werden soll.
Ändern Sie den automatisch generierten Dateinamen für die Tracedatei.
Seht euch die Ergebnisse an.
Wenn Sie eine Trace-Datei mit Frame-Profiler-Daten öffnen, werden die Daten in der Frame Profiler-Benutzeroberfläche zur Analyse angezeigt.
Frame Profiler ist die AGI-Komponente, die die UI und die Instrumentierung für das Profiling eines einzelnen Frames verwaltet. Im Frame Profiler werden Daten in den folgenden UI-Elementen angezeigt:
Bereich „Befehle“: Vulkan-API-Aufrufe.
Bereich „Framebuffer“: Framebuffer-Inhalt.
Bereich „Geometrie“: Rendern von Mesh-Draw-Aufrufen.
Bereich „Arbeitsspeicher“: Werte für RAM und GPU-Arbeitsspeicher für Befehle.
Bereich „Leistung“: GPU-Leistungsdaten für Rendering-Ereignisse.
Bereich „Pipeline“: Inhalt der Pipeline.
Bereich „Shader“: Shader-Inhalte.
Bereich „Status“: Der Rendering-Status für gesendete Befehle.
Bereich „Texturen“: Eine Liste von Texturressourcen, die mit einem Befehl verknüpft sind.
Bereich „Texture“: Der Inhalt einer ausgewählten Texturressource.
Bereich „Bericht“: Eine Liste mit Profilierungsfehlern.
Ergebnisse analysieren
In den folgenden Themen wird beschrieben, wie Sie Frame-Profiling-Daten mit AGI analysieren: