ProfilingManager.RequestProfiling メソッド

定義

名前空間:: Android.OS

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

システムプロファイルを要求します。

[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

パラメーター

profilingType: ProfilingType

収集するプロファイルの種類。

parameters: Bundle

要求に関連するパラメーターのバンドル。バンドルに認識されないパラメーターが含まれている場合、要求は android.os.ProfilingResult#ERROR_FAILED_INVALID_REQUESTで失敗します。パラメーターの値がサポートされている範囲外の場合は、範囲の値で可能な限り最も近い値が選択されます。これを直接生成するよりも、androidx ラッパーを使用することをお勧めします。

tag: String

出力の識別に役立つ呼び出し元定義データ。最初の 20 文字の英数字とダッシュは小文字になり、出力ファイル名に含まれます。

cancellationSignal: CancellationSignal

呼び出し元が取り消しを要求した場合。使用可能な場合は、結果が返されます。これが null の場合、要求しているアプリはコレクションを停止できません。指定された構成またはシステムの既定値を使用してタイムアウトした後、コレクションが停止します

executor: IExecutor

コールバックする Executor。このメソッドで提供されるリスナーにのみ使用されます。これが null で、要求時にグローバル Executor とリスナーの組み合わせが登録されていない場合、要求は削除されます。

listener: IConsumer

結果でトリガーされるリスナー。 #registerForAllProfilingResults経由で登録されたグローバルリスナーもトリガーされます。これが null で、要求時にグローバルリスナーと Executor の組み合わせが登録されていない場合、要求は削除されます。

属性: RegisterAttribute

注釈

システムプロファイルを要求します。

注: ほとんどのユースケースでは、この API を直接使用することはお勧めしません。要求を正しく構築する AndroidX によって提供される上位レベルのラッパーの使用を検討し、簡略化された要求パラメーターで使用可能なオプションをサポートします。

要求がフルフィルメントと見なされるためには、要求の時点でリスナーと Executor の両方を設定する必要があります。このメソッドでは、リスナーと Executor のペアを、 #registerForAllProfilingResultsまたはその両方で設定できます。リスナーと Executor は、同じ呼び出しで一緒に設定する必要があります。リスナーと Executor の組み合わせが設定されていない場合、要求は破棄され、コールバックは受信されません。

要求はレート制限され、入力される保証はありません。

プロファイリングが開始されるまでに遅延が発生する可能性があります。継続的プロファイリングの種類 (システムトレース、スタックサンプリング、ヒーププロファイリング) の場合は、収集を早期に開始し、対象領域の直後に cancellationSignal で停止して、プロファイリングするセクションが確実にキャプチャされるようにすることをお勧めします。ヒープダンプの場合は、ヒープダンプが適切なタイミングで収集されるようにローカルでテストすることをお勧めします。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象