System-Trace auf einem Gerät erfassen

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:

  1. Entwickleroptionen aktivieren
  2. Öffnen Sie den Bildschirm mit den Einstellungen für Entwickleroptionen.
  3. Wählen Sie im Abschnitt Debugging die Option System-Tracing aus. Ablaufverfolgung wird die App mit dem App-Menü geöffnet.
  4. 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.
    Abbildung 2. Die Kachel System-Tracing im Schnelleinstellungen.

    Hinweis:Standardmäßig weist das System fügt die Kachel Systemverfolgung als erste Kachel in der 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:

  1. 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> Benachrichtigung mit der Nachricht &quot;Die Spur wird aufgezeichnet. Zum Beenden tippen
  zu verfolgen.&quot;
    Abbildung 3: Dauerhafte Benachrichtigung, die nach dem Starten eines System-Trace auf dem Gerät.
  2. Führen Sie in Ihrer App die Aktionen aus, die das System prüfen soll.

  3. 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> Benachrichtigung mit der Nachricht „Trace gespeichert. Zum Teilen tippen
  Trace&quot; aus.
    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. 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:

  1. Entwickleroptionen aktivieren
  2. Öffnen Sie den Bildschirm mit den Einstellungen für Entwickleroptionen. Gehen Sie im Abschnitt Debugging so vor: Wählen Sie System-Tracing aus. Die System-Tracing-App wird geöffnet.

    Wenn Sie die Kachel Systemverfolgung einrichten, tippen Sie auf die Kachel und halten Sie sie gedrückt, um die System Tracing App aufzurufen.

  3. Achten Sie darauf, dass Debug-fähige Anwendungen verfolgen ausgewählt ist. Diese enthalten Apps, die das Debugging im System-Trace aktiviert ist.

  4. Wählen Sie optional die Kategorien von System- und Sensoraufrufen 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.

  5. 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.

  6. 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
  7. Führen Sie in Ihrer App die Aktionen aus, die das System prüfen soll.

  8. 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 System-Trace-Ergebnisse 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.

Erstellen Sie über eine webbasierte Benutzeroberfläche einen HTML-Bericht aus der Trace-Datei oder aus der Befehlszeile aus.

Webbasierte Benutzeroberfläche

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