Geräte mit Android 9 (API-Level 28) oder höher enthalten eine App auf Systemebene
namens System Tracing. Diese App ähnelt der
systrace-Befehlszeilentool, aber
können Sie Traces direkt von einem Testgerät aus aufzeichnen,
muss das Gerät über adb anschließen und verbinden. Sie können dann die Methode
App, um die Ergebnisse dieser Traces mit Ihrem Entwicklungsteam zu teilen.
Geräte mit Android 10 und höher zeichnen Traces im Perfetto-Format auf, während
Frühere Geräte zeichnen sie im Systrace-Format auf. Wir empfehlen die Verwendung von Perfetto
Trace Viewer, um beide Formate und
und analysieren dann die Traces.
Es ist hilfreich, Traces zu protokollieren,
wenn Sie leistungsbezogene Fehler in Ihrer App beheben,
wie etwa langsamer Start, langsame Übergänge
oder Verzögerungen auf der Benutzeroberfläche.
System-Trace aufzeichnen
Mit der System Tracing App können Sie über die Schnelleinstellungen eine Systemverfolgung aufzeichnen.
Kachel oder ein Menü in der App selbst. In den folgenden Abschnitten wird beschrieben, wie Sie
und schließen den Aufzeichnungsprozess
über diese Schnittstellen ab.
Mit der Kachel „Schnelleinstellungen“ aufnehmen
Die Kachel „Schnelleinstellungen“ ist in der Regel die bequemste Methode, um die
Prozess zur Systemverfolgung auf dem Gerät.
Kachel einrichten
Wenn Sie die System-Tracing-Funktion zum ersten Mal auf Ihrem Testgerät verwenden oder
die Kachel System-Tracing in den Schnelleinstellungen Ihres Geräts nicht angezeigt wird,
wie in Abbildung 2 gezeigt, führen Sie die folgenden Einrichtungsschritte aus:
Öffnen Sie den Bildschirm mit den Einstellungen für Entwickleroptionen.
Wählen Sie im Abschnitt Debugging die Option System-Tracing aus. Ablaufverfolgung
wird die App mit dem App-Menü geöffnet.
Aktivieren Sie im App-Menü die Option Schnelleinstellungen-Kachel anzeigen, wie in Abbildung 1 gezeigt.
Das System fügt dem Bereich Schnelleinstellungen die Kachel System-Tracing hinzu.
wie in Abbildung 2 gezeigt:
<ph type="x-smartling-placeholder"></ph>
Abbildung 1: Der Schalter Schnelleinstellungen-Kachel anzeigen in
die System Tracing App.
<ph type="x-smartling-placeholder"></ph>
.
Abbildung 2. Die Kachel System-Tracing im
Schnelleinstellungen.
Hinweis:Standardmäßig weist das System
fügt die Kachel Systemverfolgung als erste Kachel im Quick
Einstellungen. Wenn die Kachel an einer anderen Position angezeigt werden soll,
verwenden Sie den Bearbeitungsmodus des Felds, um die Kachel zu verschieben.
System-Trace-Aufzeichnung abschließen
Wenn Sie über die Schnelleinstellungen eine Systemverfolgung aufzeichnen möchten, führen Sie die folgenden Schritte aus:
folgenden Schritten:
Tippen Sie auf die Kachel System-Tracing mit dem Label Trace aufzeichnen. Die
Kachel wird aktiviert und du wirst durch eine dauerhafte Benachrichtigung darüber informiert
dass das System einen Trace aufzeichnet, wie in Abbildung 3 dargestellt:
<ph type="x-smartling-placeholder"></ph>
Abbildung 3: Dauerhafte Benachrichtigung, die nach dem
Starten eines System-Trace auf dem Gerät.
Führen Sie in Ihrer App die Aktionen aus, die das System prüfen soll.
Beenden Sie das Tracing, indem Sie in der Schnellübersicht auf die Kachel System-Tracing tippen.
Einstellungen oder in der System-Tracing-Benachrichtigung.
Das System zeigt eine neue Benachrichtigung mit der Meldung "Wird gespeichert
Trace". Wenn der Speichervorgang abgeschlossen ist, werden die Benachrichtigungen geschlossen und
wird eine dritte Benachrichtigung angezeigt, mit der bestätigt wird, dass Ihr Trace gespeichert wurde und
können Sie den System-Trace teilen (siehe Abbildung).
4:
<ph type="x-smartling-placeholder"></ph>
Abbildung 4: Dauerhafte Benachrichtigung, die nach dem
Das System hat einen aufgezeichneten Trace gespeichert.
Über das App-Menü aufnehmen
Im App-Menü können Sie verschiedene erweiterte Systemeinstellungen konfigurieren.
Tracing und bietet einen Switch zum Starten und Beenden eines System-Trace.
Wenn Sie ein System-Trace über das App-Menü „System Tracing“ aufzeichnen möchten, führen Sie die Schritte
folgenden Schritten:
Öffnen Sie den Einstellungsbildschirm für die Entwickleroptionen. Gehen Sie im Abschnitt Debugging so vor:
Wählen Sie System-Tracing aus. Die System-Tracing-App wird geöffnet.
Achten Sie darauf, dass Debug-fähige Anwendungen verfolgen ausgewählt ist. Diese enthalten Apps, die
das Debugging im System-Trace aktiviert ist.
Wählen Sie optional die Kategorien für System- und Sensoraufrufe aus, die verfolgt werden sollen.
und wählen Sie eine Puffergröße pro CPU in KB aus. Wählen Sie entsprechende Kategorien aus
zu testen, z. B. die Kategorie Audio für
Testen der Bluetooth-Vorgänge oder der Kategorie Speicher für Heap-Zuweisungen.
Wählen Sie optional Lange Traces aus, um gespeicherte Traces zu aktivieren.
kontinuierlich zum Gerätespeicher wechseln. Legen Sie für diese Option Limits für die maximal
lange Trace-Größe und Maximale lange Trace-Dauer.
Aktivieren Sie den Schalter Trace aufzeichnen (siehe Abbildung 5). Die Kachel wird zu
aktiviert ist und Sie eine dauerhafte Benachrichtigung erhalten, dass das System
einen Trace aufzeichnet, wie in Abbildung 3 dargestellt.
<ph type="x-smartling-placeholder"></ph>
Abbildung 5: Der Schalter Trace aufzeichnen im System
Tracing-Einstellungen
Führen Sie in Ihrer App die Aktionen aus, die das System prüfen soll.
Beenden Sie das Tracing, indem Sie den Schalter Trace aufzeichnen deaktivieren.
Das System zeigt eine neue Benachrichtigung mit der Meldung "Wird gespeichert
Trace". Wenn der Speichervorgang abgeschlossen ist, werden die Benachrichtigungen geschlossen und
wird eine dritte Benachrichtigung angezeigt, mit der bestätigt wird, dass Ihr Trace gespeichert wurde und
können Sie den System-Trace freigeben, wie in
Abbildung 4.
System-Trace freigeben
Mit der System Tracing App können Sie Ergebnisse von System-Traces als Teil mehrerer
unterschiedliche Workflows. Auf einem Gerät mit Android 10 (API-Level 29) oder höher:
Dateien mit der Dateiendung „.perfetto-trace“ gespeichert und können geöffnet werden
in der Perfetto-UI aus. Auf einem Gerät
mit einer früheren Android-Version werden die Trace-Dateien im .ctrace gespeichert.
Dateinamenerweiterung, die das Systrace-Format angibt.
Als Nachricht teilen
Mit der System-Tracing-Funktion können Sie Ihre erfassten Traces mit anderen Apps auf Ihrem
. Sie können den Trace per E-Mail oder per
App zur Fehlerverfolgung, ohne ein Gerät mit der Entwicklungsumgebung verbinden zu müssen
Maschine.
Nachdem Sie eine Systemverfolgung aufgezeichnet haben, tippen Sie auf die Benachrichtigung, die auf
Gerät, wie in Abbildung 4 gezeigt. Die
Intent-Auswahl wird angezeigt, mit der Sie den Trace über die Messaging-App von
die gewünschte Option auswählen.
Über die App „Dateien“ teilen
Auf Geräten mit Android 10 (API-Level 29) oder höher werden Traces in der
App „Dateien“. Du kannst einen Trace von dieser App aus teilen.
Bericht über ADB herunterladen
Sie können ein System-Trace auch mit adb von einem Gerät extrahieren. Verbinden Sie das
Gerät, mit dem der Trace auf Ihrem Entwicklungscomputer aufgezeichnet wurde, und führen Sie dann den
die folgenden Befehle in einem Terminalfenster ein:
cd /path-to-traces-on-my-dev-machine && \
adb pull /data/local/traces/ .
Zwischen Trace-Formaten konvertieren
Sie können Perfetto-Ablaufverfolgungsdateien in das Systrace-Format konvertieren. Weitere Informationen finden Sie unter Umwandeln
zwischen Trace-Formaten
.
HTML-Bericht erstellen
Wenn Sie Ihren Trace freigeben, befindet sich der Bericht selbst in einer .perfetto-trace-Datei auf
Geräte mit Android 10
oder eine .ctrace-Datei für alle anderen Versionen.
Verwenden Sie die Perfetto-UI,
die Ablaufverfolgungsdatei und
generieren den Bericht.
Für eine Perfetto-Datei klicken Sie auf Trace-Datei öffnen. Klicken Sie für eine Systrace-Datei auf
Mit alter UI öffnen: Die Legacy-Benutzeroberfläche hat dasselbe Design wie die
Systrace-Bericht.
Befehlszeile
Führen Sie die folgenden Befehle in einem Terminalfenster aus, um einen HTML-Bericht zu generieren
aus der Trace-Datei:
cd /path-to-traces-on-my-dev-machine && \
systrace --from-file trace-file-name{.ctrace | .perfetto-trace}
Wenn Sie das systrace-Befehlszeilentool noch nicht haben, können Sie es herunterladen
aus der
Katapult
auf GitHub oder direkt aus dem Android Open Source-
Projekt
Empfehlungen für dich
Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
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.