Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
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:
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.
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
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:
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.
Geben Sie im Textfeld Filtergapid ein, damit nur Apps angezeigt werden.
deren Paketname gapid enthält.
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.
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.
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
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.