ProfilingManager.RequestProfiling Methode

Definition

Namespace:: Android.OS

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Anforderung der Systemprofilerstellung.

[Android.Runtime.Register("requestProfiling", "(ILandroid/os/Bundle;Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "", ApiSince=35)]
public void RequestProfiling(Android.OS.ProfilingType profilingType, Android.OS.Bundle? parameters, string? tag, Android.OS.CancellationSignal? cancellationSignal, Java.Util.Concurrent.IExecutor? executor, Java.Util.Functions.IConsumer? listener);

[<Android.Runtime.Register("requestProfiling", "(ILandroid/os/Bundle;Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "", ApiSince=35)>]
member this.RequestProfiling : Android.OS.ProfilingType * Android.OS.Bundle * string * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit

Parameter

profilingType: ProfilingType

Art der zu sammelnden Profilerstellung.

parameters: Bundle

Bündel von anforderungsbezogenen Parametern. Wenn das Bundle nicht erkannte Parameter enthält, schlägt die Anforderung fehl.android.os.ProfilingResult#ERROR_FAILED_INVALID_REQUEST Wenn die Werte für die Parameter außerhalb des unterstützten Bereichs liegen, wird der nächstmögliche Bereichswert ausgewählt. Die Verwendung von Androidx-Wrappern wird empfohlen, dies direkt zu generieren.

tag: String

Vom Aufrufer definierte Daten, um die Ausgabe zu identifizieren. Die ersten 20 alphanumerischen Zeichen und Bindestriche werden kleingeschrieben und im Ausgabedateinamen enthalten.

cancellationSignal: CancellationSignal

für anrufer angeforderte Stornierung. Wenn verfügbar, werden Ergebnisse zurückgegeben. Wenn dies null ist, kann die anfordernde App die Sammlung nicht beenden. Die Sammlung wird nach dem Timeout mit den bereitgestellten Konfigurationen oder mit Systemstandardeinstellungen beendet.

executor: IExecutor

Der Ausführende, mit dem der Rückruf ausgeführt werden soll. Wird nur für den in dieser Methode bereitgestellten Listener verwendet. Wenn dies null ist und zum Zeitpunkt der Anforderung keine globalen Executor- und Listenerkombinationen registriert werden, wird die Anforderung gelöscht.

listener: IConsumer

Listener, der mit Ergebnis ausgelöst werden soll. Alle global registrierten #registerForAllProfilingResults Listener werden ebenfalls ausgelöst. Wenn dies null ist und zum Zeitpunkt der Anforderung keine globalen Listener- und Executorkombinationen registriert werden, wird die Anforderung gelöscht.

Attribute: RegisterAttribute

Hinweise

Anforderung der Systemprofilerstellung.

Hinweis: Die direkte Verwendung dieser API wird für die meisten Anwendungsfälle nicht empfohlen. Erwägen Sie die Verwendung der von AndroidX bereitgestellten Wrapper auf höherer Ebene , die die Anforderung ordnungsgemäß erstellen und verfügbare Optionen mit vereinfachten Anforderungsparametern unterstützen.

Sowohl ein Listener als auch ein Executor müssen zum Zeitpunkt der Anforderung festgelegt werden, dass die Anforderung zur Erfüllung berücksichtigt wird. Listener-/Executor-Paare können in dieser Methode mit #registerForAllProfilingResultsoder beides festgelegt werden. Der Listener und der Executor müssen im selben Anruf zusammen festgelegt werden. Wenn keine Listener- und Executorkombination festgelegt ist, wird die Anforderung verworfen und kein Rückruf empfangen.

Anfragen werden eingeschränkt und werden nicht garantiert ausgefüllt.

Es kann zu einer Verzögerung kommen, bevor die Profilerstellung beginnt. Für fortlaufende Profilerstellungstypen (Systemablaufverfolgung, Stapelsampling und Heap-Profilerstellung) empfehlen wir, die Sammlung frühzeitig zu starten und sofort nach dem interessanten Bereich zu beenden cancellationSignal , um sicherzustellen, dass der gewünschte Abschnitt erfasst wird. Für Heap-Dumps wird empfohlen, lokal zu testen, um sicherzustellen, dass das Heap-Dump zur richtigen Zeit gesammelt wird.

Java Dokumentation für android.os.ProfilingManager.requestProfiling(int, android.os.Bundle, java.lang.String, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.os.ProfilingResult>).

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.

Gilt für: