Wenn Sie einen Methoden-Trace der Ausführung Ihrer App generieren möchten, können Sie Ihre App mit der Klasse Debug instrumentieren. Wenn Sie Ihre App auf diese Weise instrumentieren, haben Sie mehr Kontrolle darüber, wann das Gerät mit der Aufzeichnung von Tracing-Informationen beginnt und wann es damit aufhört. Das Gerät speichert die Trace-Logs auch unter den von Ihnen angegebenen Namen, sodass Sie die einzelnen Logs später leicht identifizieren können. Anschließend können Sie sich die einzelnen Trace-Logs mit dem CPU-Profiler von Android Studio ansehen.
Sie können das Tracing im CPU-Profiler auch starten und beenden, ohne den Code Ihrer App zu instrumentieren.
Bevor Sie Trace-Logs generieren, müssen Sie dafür sorgen, dass Ihre App Logik zum Speichern von Trace-Logs in ihrem app-spezifischen Verzeichnis enthält.
Anwendung instrumentieren
Wenn Sie Trace-Logs erstellen möchten, rufen Sie startMethodTracing() an der Stelle auf, an der das System mit dem Logging von Tracing-Daten beginnen soll.
Im Aufruf können Sie den Namen für die Datei .trace angeben. Das System speichert sie in einem paketspezifischen Verzeichnis, das für nichtflüchtige App-Daten auf dem Zielgerät vorgesehen ist. Dies ist dasselbe Verzeichnis, das von getExternalFilesDir() zurückgegeben wird und sich auf den meisten Geräten im Verzeichnis ~/sdcard/ befindet.
Diese Datei enthält die binären Methoden-Trace-Daten und eine Zuordnungstabelle mit Thread- und Methodennamen. Rufen Sie stopMethodTracing() auf, um das Tracing zu beenden.
Im folgenden Beispiel wird die Aufzeichnung eines Trace-Logs mit dem Namen sample.trace gestartet und beendet:
// Starts recording a trace log with the name you provide. For example, the // following code tells the system to start recording a .trace file to the // device with the name "sample.trace". Debug.startMethodTracing("sample") // The system begins buffering the generated trace data, until your // application calls stopMethodTracing(), at which time it writes // the buffered data to the output file. Debug.stopMethodTracing()
Wenn deine App startMethodTracing() noch einmal aufruft, ohne den Namen des Trace-Logs zu ändern, wird das vorhandene, auf dem Gerät gespeicherte Log überschrieben. Informationen zum dynamischen Ändern des Namens der einzelnen Trace-Logs finden Sie im Abschnitt Mehrere Logs speichern.
Wenn das System die maximale Puffergröße erreicht, bevor Sie stopMethodTracing() aufrufen, wird das Tracing beendet und eine Benachrichtigung an die Konsole gesendet.
Die Methoden zum Starten und Beenden von Traces funktionieren im gesamten App-Prozess. Sie können also startMethodTracing() in der Methode onCreate(Bundle) Ihrer Aktivität und stopMethodTracing() in der Methode onDestroy() dieser Aktivität aufrufen.
Beachten Sie, dass Ihre Anwendung langsamer ausgeführt wird, wenn die Profilerstellung aktiviert ist. Sie sollten die Profildaten also nicht verwenden, um absolute Zeitangaben zu ermitteln (z. B. „Die Ausführung der Methode foo() dauert 2,5 Sekunden“). Die Zeitangaben in den Trace-Logs sind nur nützlich, wenn sie mit vorherigen Trace-Logs verglichen werden. So können Sie feststellen, ob die letzten Änderungen Ihre App schneller oder langsamer machen.
Bei der Bereitstellung auf Geräten mit Android 5.0 (API-Level 21) und höher können Sie die Profilerstellung mit weniger Auswirkungen auf die Laufzeitleistung durchführen. Wenn Sie die Stichprobenprofilerstellung aktivieren möchten, rufen Sie startMethodTracingSampling() (anstelle von startMethodTracing()) mit einem bestimmten Stichprobenintervall auf. Das System erfasst regelmäßig Stichproben, bis Ihre App stopMethodTracing() aufruft.
Mehrere Protokolle speichern
Wenn deine App einen Methoden-Trace mehrmals startet und stoppt, ohne einen neuen Namen für das Trace-Log anzugeben, wird das ältere Trace-Log durch das neue überschrieben. Es wird also nur das neueste Trace-Log beibehalten. Wenn Sie mehrere Trace-Logs auf Ihrem Gerät speichern möchten, benennen Sie das Trace-Log jedes Mal dynamisch um, wenn Ihre App startMethodTracing() aufruft.
Im folgenden Beispiel wird die Klasse SimpleDateFormat verwendet, um das aktuelle Datum und die aktuelle Uhrzeit beim Benennen der einzelnen Trace-Logs einzufügen:
// Uses the SimpleDateFormat class to create a String with // the current date and time. val dateFormat: DateFormat = SimpleDateFormat("dd_MM_yyyy_hh_mm_ss", Locale.getDefault()) val logDate: String = dateFormat.format(Date()) // Applies the date and time to the name of the trace log. Debug.startMethodTracing("sample-$logDate")
Auf Trace-Logs auf dem Gerät zugreifen
Nachdem das System das Trace-Log auf Ihrem Gerät erstellt hat, können Sie auf eine der folgenden Arten auf die Datei zugreifen:
Geräte-Explorer verwenden Klicken Sie auf View > Tool Windows > Device Explorer (Ansicht > Toolfenster > Device Explorer) oder in der Toolfensterleiste auf den Button Device Explorer
, um den Device Explorer zu öffnen. Wie in Abbildung 1 dargestellt, finden Sie die .trace-Dateien im paketspezifischen Verzeichnis Ihrer App.
Abbildung 1. Trace-Logs mit dem Device Explorer finden
Kopieren Sie die Datei mit dem Befehl
adb pullauf Ihren lokalen Computer. Mit dem folgenden Befehl wird ein Trace-Log mit dem Namensample.tracevom Gerät in das Verzeichnis~/Documents/trace-logs/auf Ihrem lokalen Computer kopiert.adb pull path-on-device/sample.trace ~/Documents/trace-logs/
Anschließend können Sie die Trace-Datei mit dem CPU-Profiler importieren.