ProfilingManager Klasse

Definition

[Android.Runtime.Register("android/os/ProfilingManager", ApiSince=35, DoNotGenerateAcw=true)]
public sealed class ProfilingManager : Java.Lang.Object

[<Android.Runtime.Register("android/os/ProfilingManager", ApiSince=35, DoNotGenerateAcw=true)>]
type ProfilingManager = class
    inherit Object

Vererbung

Object

JavaObject

Object

ProfilingManager

Attribute

RegisterAttribute

Hinweise

Diese Klasse ermöglicht dem Aufrufer: <ul><li>Request Profiling und Lauschen auf Ergebnisse. Unterstützte Profilerstellungstypen sind: Systemablaufverfolgungen, Java-Heapabbilder, Heapprofile und Stapelüberwachungen.</li li><>Register triggers for the system to capture profiling on the apps behalf.</li></ul>

Die #requestProfiling API kann verwendet werden, um mit der Profilerstellung zu beginnen. Die Profilerstellung kann manuell mit dem in der Anforderung bereitgestellten CancellationSignal oder aufgrund eines Timeouts beendet werden. Bei dem Timeout kann es sich entweder um den Systemstandard oder den Aufrufer handeln, der im Parameterbundle für ausgewählte Typen definiert ist.

Die Profilerstellungsergebnisse werden an das Datenverzeichnis der anfordernden App übermittelt, und ein Zeiger auf die Datei wird mit den von der App bereitgestellten Listenern empfangen.

Apps können Listener auf eine oder beide Arten bereitstellen: <ul><li>A anforderungsspezifische Listener, die in der Anforderung enthalten sind. Dies wird nur mit einem Ergebnis der Anforderung ausgelöst, mit der sie bereitgestellt wurde.</li><>Li Ein globaler Listener, der von #registerForAllProfilingResults. Dies wird für alle Ergebnisse ausgelöst, die zu Ihrer App gehören. Dieser Listener ist die einzige Möglichkeit, Ergebnisse von vom System ausgelösten Profilerstellungsinstanzen zu empfangen, die mit #addProfilingTriggers.</li></ul>

Anforderungen sind eingeschränkt und können nicht garantiert ausgefüllt werden. Die Einschränkung der Rate kann für lokale Tests #requestProfiling mit dem Shellbefehl deaktiviert werden. device_config put profiling_testing rate_limiter.disabled true

Für lokale Tests kann einfacher auf Profilerstellungsergebnisse zugegriffen werden, indem der Debugmodus aktiviert wird. Dadurch werden Ausgabedateien in einem temporären Systemverzeichnis beibehalten. Die Speicherorte der aufbewahrten Dateien sind in logcat verfügbar. Das Verhalten und der Befehl variiert je nach Version: <ul><li>für Android-Versionen 16 und höher, der Debugmodus behält sowohl unrededacted (sofern zutreffend) als auch redacted ergebnisse im temporären Verzeichnis bei. Sie kann mit dem Shellbefehl device_config put profiling_testing delete_temporary_results.disabled true aktiviert und deaktiviert werden, indem Sie denselben Wert wieder auf "false" festlegen. Auf beibehaltene Ergebnisse kann für alle Buildtypen zugegriffen werden. </li li><>für Android, Version 15, Debugmodus behält nur das nicht festgelegte Ergebnis (sofern zutreffend) im temporären Verzeichnis bei. Sie kann mit dem Shellbefehl device_config put profiling_testing delete_unredacted_trace.disabled true aktiviert und deaktiviert werden, indem Sie denselben Wert wieder auf "false" festlegen. Auf die beibehaltene nicht komprimierte Datei kann nur auf Builds mit Stammzugriff zugegriffen werden. Um auf die redacted-Ausgabedatei auf einem nicht gerooteten Gerät zuzugreifen, können Apps die Datei von /pkg/files/profiling/file.type zu /pkg/cache/file.typekopieren. </li></ul>

Um Profilerstellungstrigger zu testen, aktivieren Sie den Testmodus für Ihre App mit dem Shellbefehldevice_config put profiling_testing system_triggered_profiling.testing_package_name com.your.app, der folgendes bewirkt: <ul><li>Stellen Sie sicher, dass eine Hintergrundablaufverfolgung ausgeführt wird.</li li><>Allow all trigger for the provided package name to pass the system level rate limiter. Dieser Modus wird fortgesetzt, bis der Shellbefehl device_config delete profiling_testing system_triggered_profiling.testing_package_namemanuell beendet wurde. </li></ul>

Die Ergebnisse sind redigiert und enthalten nur spezifische Informationen zum anfordernden Prozess.

Hinweis: Sehen Sie sich die Erfassung realer Benutzerdaten mithilfe von ProfilingManager an, um einen detaillierten Leitfaden zur Verwendung dieser API zu erhalten, der die Erfassung von Profilerstellung umfasst, indem Sie die Ergebnisse interpretieren.

Java Dokumentation für android.os.ProfilingManager.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.