Debug.StartMethodTracing メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| StartMethodTracing() |
既定のログ名とバッファー サイズでメソッド トレースを開始します。 |
| StartMethodTracing(String) |
トレース ログ ファイルのパスを指定して、メソッド トレースを開始します。 |
| StartMethodTracing(String, Int32) |
トレース ログ ファイル名とバッファー サイズを指定して、メソッド トレースを開始します。 |
| StartMethodTracing(String, Int32, DebugTraceOptions) |
トレース ログ ファイル名、バッファー サイズ、フラグを指定して、メソッド トレースを開始します。 |
StartMethodTracing()
既定のログ名とバッファー サイズでメソッド トレースを開始します。
[Android.Runtime.Register("startMethodTracing", "()V", "")]
public static void StartMethodTracing();
[<Android.Runtime.Register("startMethodTracing", "()V", "")>]
static member StartMethodTracing : unit -> unit
- 属性
注釈
既定のログ名とバッファー サイズでメソッド トレースを開始します。
既定では、トレース ファイルは "dmtrace.trace" と呼ばれ、 Context#getExternalFilesDir(String)によって返されるプライマリ共有/外部ストレージ上のパッケージ固有のディレクトリの下に配置されます。
トレース ファイルの読み取りについては、 Traceview を使用したトレース ログの検査 を参照してください。
メソッド トレースが有効になっている場合、VM の実行速度は通常よりも遅くなります。そのため、トレース ファイルからのタイミングは相対的な観点からのみ考慮する必要があります (たとえば、実行 #2 よりも #1 が高速に実行されました)。 ネイティブ メソッドの時間は変わらないため、これを使用して、同じメソッドの解釈された実装とネイティブ実装のパフォーマンスを比較しないでください。 別の方法として、 #startMethodTracingSampling(String, int, int) を介したサンプリング ベースのメソッド トレース、または #startNativeTracing()を介したエミュレーターでの "ネイティブ" トレースの使用を検討してください。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
StartMethodTracing(String)
トレース ログ ファイルのパスを指定して、メソッド トレースを開始します。
[Android.Runtime.Register("startMethodTracing", "(Ljava/lang/String;)V", "")]
public static void StartMethodTracing(string? tracePath);
[<Android.Runtime.Register("startMethodTracing", "(Ljava/lang/String;)V", "")>]
static member StartMethodTracing : string -> unit
パラメーター
- tracePath
- String
作成するトレース ログ ファイルへのパス。
null場合、既定では "dmtrace.trace" になります。 ファイルが既に存在する場合は、切り捨てられます。 指定されたパスが ".trace" で終わらない場合は、追加されます。
- 属性
注釈
トレース ログ ファイルのパスを指定して、メソッド トレースを開始します。
相対ファイル パスが指定されると、トレース ファイルは、 Context#getExternalFilesDir(String)によって返されるプライマリ共有/外部ストレージ上のパッケージ固有のディレクトリの下に配置されます。
トレース ファイルの読み取りについては、 Traceview を使用したトレース ログの検査 を参照してください。
メソッド トレースが有効になっている場合、VM の実行速度は通常よりも遅くなります。そのため、トレース ファイルからのタイミングは相対的な観点からのみ考慮する必要があります (たとえば、実行 #2 よりも #1 が高速に実行されました)。 ネイティブ メソッドの時間は変わらないため、これを使用して、同じメソッドの解釈された実装とネイティブ実装のパフォーマンスを比較しないでください。 別の方法として、 #startMethodTracingSampling(String, int, int) を介したサンプリング ベースのメソッド トレース、または #startNativeTracing()を介したエミュレーターでの "ネイティブ" トレースの使用を検討してください。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
StartMethodTracing(String, Int32)
トレース ログ ファイル名とバッファー サイズを指定して、メソッド トレースを開始します。
[Android.Runtime.Register("startMethodTracing", "(Ljava/lang/String;I)V", "")]
public static void StartMethodTracing(string? tracePath, int bufferSize);
[<Android.Runtime.Register("startMethodTracing", "(Ljava/lang/String;I)V", "")>]
static member StartMethodTracing : string * int -> unit
パラメーター
- tracePath
- String
作成するトレース ログ ファイルへのパス。
null場合、既定では "dmtrace.trace" になります。 ファイルが既に存在する場合は、切り捨てられます。 指定されたパスが ".trace" で終わらない場合は、追加されます。
- bufferSize
- Int32
収集するトレース データの最大量。 指定しない場合、既定値は 8 MB です。
- 属性
注釈
トレース ログ ファイル名とバッファー サイズを指定して、メソッド トレースを開始します。
相対ファイル パスが指定されると、トレース ファイルは、 Context#getExternalFilesDir(String)によって返されるプライマリ共有/外部ストレージ上のパッケージ固有のディレクトリの下に配置されます。
トレース ファイルの読み取りについては、 Traceview を使用したトレース ログの検査 を参照してください。
メソッド トレースが有効になっている場合、VM の実行速度は通常よりも遅くなります。そのため、トレース ファイルからのタイミングは相対的な観点からのみ考慮する必要があります (たとえば、実行 #2 よりも #1 が高速に実行されました)。 ネイティブ メソッドの時間は変わらないため、これを使用して、同じメソッドの解釈された実装とネイティブ実装のパフォーマンスを比較しないでください。 別の方法として、 #startMethodTracingSampling(String, int, int) を介したサンプリング ベースのメソッド トレース、または #startNativeTracing()を介したエミュレーターでの "ネイティブ" トレースの使用を検討してください。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
StartMethodTracing(String, Int32, DebugTraceOptions)
トレース ログ ファイル名、バッファー サイズ、フラグを指定して、メソッド トレースを開始します。
[Android.Runtime.Register("startMethodTracing", "(Ljava/lang/String;II)V", "")]
public static void StartMethodTracing(string? tracePath, int bufferSize, Android.OS.DebugTraceOptions flags);
[<Android.Runtime.Register("startMethodTracing", "(Ljava/lang/String;II)V", "")>]
static member StartMethodTracing : string * int * Android.OS.DebugTraceOptions -> unit
パラメーター
- tracePath
- String
作成するトレース ログ ファイルへのパス。
null場合、既定では "dmtrace.trace" になります。 ファイルが既に存在する場合は、切り捨てられます。 指定されたパスが ".trace" で終わらない場合は、追加されます。
- bufferSize
- Int32
収集するトレース データの最大量。 指定しない場合、既定値は 8 MB です。
- flags
- DebugTraceOptions
メソッドのトレースを制御するためのフラグ。 次のフラグがサポートされています: 0x0001 #TRACE_COUNT_ALLOCS
Flags to control time source: These are available with API #34 and higher.
0x0010 Report the elapsed time since the start of the trace.
0x0100 Report the time the thread has spent on the CPU since the start of the
trace. Please note that the thread cpu incurs a significant (typically
2-3x) performance penalty. Use this flag only when necessary.
If neither of these flags are set, both the elapsed time and the thread cpu time
are reported.
- 属性
注釈
トレース ログ ファイル名、バッファー サイズ、フラグを指定して、メソッド トレースを開始します。
相対ファイル パスが指定されると、トレース ファイルは、 Context#getExternalFilesDir(String)によって返されるプライマリ共有/外部ストレージ上のパッケージ固有のディレクトリの下に配置されます。
トレース ファイルの読み取りについては、 Traceview を使用したトレース ログの検査 を参照してください。
メソッド トレースが有効になっている場合、VM の実行速度は通常よりも遅くなります。そのため、トレース ファイルからのタイミングは相対的な観点からのみ考慮する必要があります (たとえば、実行 #2 よりも #1 が高速に実行されました)。 ネイティブ メソッドの時間は変わらないため、これを使用して、同じメソッドの解釈された実装とネイティブ実装のパフォーマンスを比較しないでください。 別の方法として、 #startMethodTracingSampling(String, int, int) を介したサンプリング ベースのメソッド トレース、または #startNativeTracing()を介したエミュレーターでの "ネイティブ" トレースの使用を検討してください。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。