トレース

API リファレンス
androidx.tracing

トレースイベントをシステムトレースバッファに書き込みます。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2026 年 1 月 28 日	1.3.0	-	-	2.0.0-alpha01

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 2.0

バージョン 2.0.0-alpha01

2026 年 1 月 28 日

androidx.tracing:tracing-*:2.0.0-alpha01 がリリースされました。バージョン 2.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

AndroidX Tracing 2.0 では、Tracing 1.0 の既存の android.os.Tracing ベースの API を補完する、オーバーヘッドの少ないインプロセストレース用の新しい API サーフェスが導入されています。新しい API は Android とホスト JVM の両方で利用できます。これにより、ホストツールは同じ標準の Perfetto トレース形式を使用して、パフォーマンス分析用の低オーバーヘッドトレースを出力できます。

出力されたトレースは Android Studio と Perfetto の両方でサポートされており、メタデータ（関数引数など）によるスライスのタグ付けやコルーチンコンテキストのトレース伝播など、拡張された機能セットで記録できます。

この最初のアルファ版は、インプロセストレースワークフロー専用です。Android OS トレースや Studio プロファイラのシステムトレースとの統合はまだ行われていません。これらは今後のアルファ版で提供される予定です。

  /**
  * A [TraceSink] defines how traces are serialized.
  *
  * [androidx.tracing.wire.TraceSink] uses the `Perfetto` trace packet format.
  */
  fun createSink(): TraceSink {
      val outputDirectory = File(/* pathname = */ "/tmp/perfetto")
      // We are using the factory function defined in androidx.tracing.wire
      return TraceSink(
          sequenceId = 1,
          directory = outputDirectory
      )
  }

  /**
  * Creates a new instance of [androidx.tracing.TraceDriver].
  */
  fun createTraceDriver(): TraceDriver {
      // We are using a factory function from androidx.tracing.wire here.
      // `isEnabled` controls whether tracing is enabled for the application.
      val driver = TraceDriver(sink = createSink(), isEnabled = true)
      return driver
  }

  fun main() {
      val driver = createTraceDriver()
      driver.use {
          driver.tracer.trace(category = CATEGORY_MAIN, name = "basic") {
              Thread.sleep(100L)
          }
      }
  }

API の変更

Tracer を TraceDriver のプロパティにします。（Iabd9b）
手動コンテキスト伝播のサポートを追加します。（I899ff）
トレースセクションにコールスタック情報を追加する機能を追加。（If6a1b）
新しい androidx.tracing API を導入します。（I5102b）
インスタントイベントにメタデータを含めることを許可し、インスタントとカウンタにカウンタを追加します。（Ia2ed3）
@DelicateTracingApi でアノテーションされた API のサーフェス領域を縮小します。最上位の API で @DelicateTracingApi の使用を必要としないようにしてください。（I565e0）
PropagationToken を統合して、コンテキストの伝播を簡素化します。（Iab839）
androidx.benchmark で BlackHole API を安定化しました。（I2b67e、b/451749438）
トレースセクションをルートスパンとしてアノテーションを付ける機能を追加しました。（Ic8365）
デベロッパーが伝播トークンを明示的に指定できるようにします。（I06bb1）
MetadataHandleCloseable の名前を EventMetadataCloseable に、MetadataHandle の名前を EventMetadata に変更しました。また、デベロッパーが使用する伝播トークンを明示的に指定できるように、Tracer.traceCoroutine にオプションの CoroutinePropagationToken 引数を追加しました。（I219f7、b/454147392）
新しい Tracer エントリポイントを導入しました。これにより、デベロッパーはトレース方法をより細かく制御できるようになります。（I24a7b）
SliceTrack でコンテキスト伝播を制御する機能を追加します。（Ieb8fc）
PooledTracePacketArray の fillCount が volatile として正しくマークされるようになりました。（I75d2c）
マーク MetadataEntry @DelicateTracingApi。（I8c723）
TraceSink がトレースイベントの損失（プールが枯渇した場合）を処理できるようにする機能を追加します。（I3b374）
述語に基づいてトレースイベントを条件付きで出力する機能を追加しました。（I621b4）
トレースイベントにカテゴリを追加する機能を追加しました。（I449c2）
TraceEvent、PooledTracePacketArray を DelicateTracingApi としてマークします。（Iaac6d）
ProcessTrack.id、ThreadTrack.id、ThreadTrack.name、CounterTrack.name、CounterTrack.parent を公開します。（I81210）
SliceTrack.traceFlow() API の名前を traceCoroutine() に変更しました。（I79ad0）
Perfetto トレースのデバッグアノテーションを使用して、スライスにコンテキスト情報を追加する機能を追加。（Ic2b56）
File / OutputStream を使用して WireTraceSink のインスタンスを構築できるようにします。（Iecea0）
廃止された @RequiresApi(21) アノテーションを削除（Ic4792）

バージョン 1.3

バージョン 1.3.0

2025 年 4 月 23 日

androidx.tracing:tracing:1.3.0、androidx.tracing:tracing-android:1.3.0、androidx.tracing:tracing-ktx:1.3.0 がリリースされました。バージョン 1.3.0 にはこれらの commit が含まれています。

1.2.0 以降の重要な変更

androidx.tracing.Trace クラスを Kotlin に変換し、tracing-ktx モジュールから tracing にすべてのコードを移動しました。
@Composable で使用できるように、トレースから crossinline を削除しました。（I53882、b/248344805）

バージョン 1.3.0-rc01

2025 年 4 月 9 日

androidx.tracing:tracing:1.3.0-rc01、androidx.tracing:tracing-android:1.3.0-rc01、androidx.tracing:tracing-ktx:1.3.0-rc01 がリリースされました。最後のベータ版からの変更はありません。バージョン 1.3.0-rc01 にはこれらの commit が含まれています。

バージョン 1.3.0-beta01

2025 年 2 月 12 日

androidx.tracing:tracing:1.3.0-beta01、androidx.tracing:tracing-android:1.3.0-beta01、androidx.tracing:tracing-ktx:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 にはこれらの commit が含まれています。

API の変更

tracing-ktx モジュールのすべてのコードを tracing に移動しました。（Iba550）
androidx.tracing.Trace クラスを Kotlin に変換しました。（Ie4e5d）

バグの修正

AGP 7.3 以降（R8 バージョン 3.3 など）で R8 を使用する場合、および AGP 8.1 以降（D8 バージョン 8.1 など）ですべてのビルドで、API モデリングを介して新しいプラットフォーム API へのアクセスが自動的に行われるため、新しいプラットフォーム API へのアクセスの手動でのアウトライン設定を削除しました。AGP を使用していないクライアントは、D8 バージョン 8.1 以降に更新することをおすすめします。詳しくは、こちらの記事をご覧ください。（Ia60e0、b/345472586）

バージョン 1.3.0-alpha02

2023 年 6 月 21 日

androidx.tracing:tracing:1.3.0-alpha02 と androidx.tracing:tracing-ktx:1.3.0-alpha02 がリリースされました。以前のアルファ版からの変更はありません。バージョン 1.3.0-alpha02 に含まれる commit については、こちらをご覧ください。

バージョン 1.3.0-alpha01

2023 年 6 月 7 日

androidx.tracing:tracing:1.3.0-alpha01 と androidx.tracing:tracing-ktx:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください。

API の変更

@Composable で使用できるように、トレースから crossinline を削除しました。（I53882、b/248344805）

バージョン 1.2

バージョン 1.2.0

2023 年 11 月 29 日

androidx.tracing:tracing:1.2.0 と androidx.tracing:tracing-ktx:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

1.1.0 以降の重要な変更

遅延文字列と Cookie の計算を使用して、trace() と traceAsync() のバリアントを追加します。Trace.begin がスローされた場合も Trace.end を正しくスキップするようになりました。

バージョン 1.2.0-rc01

2023 年 5 月 24 日

androidx.tracing:tracing:1.2.0-rc01 と androidx.tracing:tracing-ktx:1.2.0-rc01 がリリースされました。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください。

バグの修正

長いトレースセクション名が渡されたときにクラッシュしないよう、自動的に切り詰める（Iaf6e2）

バージョン 1.2.0-beta04

2023 年 5 月 3 日

androidx.tracing:tracing:1.2.0-beta04 と androidx.tracing:tracing-ktx:1.2.0-beta04 がリリースされました。変更はありません。バージョン 1.2.0-beta04 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-beta03

2023 年 4 月 5 日

androidx.tracing:tracing:1.2.0-beta03 と androidx.tracing:tracing-ktx:1.2.0-beta03 がリリースされました。新しい変更はありません。バージョン 1.2.0-beta03 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-beta02

2023 年 3 月 22 日

androidx.tracing:tracing:1.2.0-beta02 と androidx.tracing:tracing-ktx:1.2.0-beta02 がリリースされました。以前のベータ版からの変更はありません。バージョン 1.2.0-beta02 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-beta01

2023 年 3 月 8 日

androidx.tracing:tracing:1.2.0-beta01 と androidx.tracing:tracing-ktx:1.2.0-beta01 がリリースされました。前回のアルファ版からの変更はありません。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-alpha02

2023 年 2 月 23 日

androidx.tracing:tracing:1.2.0-alpha02 と androidx.tracing:tracing-ktx:1.2.0-alpha02 がリリースされました。以前のアルファ版からの変更はありません。バージョン 1.2.0-alpha02 に含まれる commit については、こちらをご覧ください。

バグの修正

このリリースでは、androidx.tracing: tracing-perfetto-common:1.0.0-alpha11 にアップグレードする際の Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 エラーを修正します。

バージョン 1.2.0-alpha01

2022 年 10 月 5 日

androidx.tracing:tracing:1.2.0-alpha01 と androidx.tracing:tracing-ktx:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

遅延文字列と Cookie の計算を使用して、trace() と traceAsync() のバリアントを追加します。Trace.begin がスローされた場合も Trace.end を正しくスキップするようになりました。（I31421、b/175233952、b/247066503）

Tracing バージョン 1.1

バージョン 1.1.0

2022 年 5 月 11 日

androidx.tracing:tracing:1.1.0 と androidx.tracing:tracing-ktx:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください。

1.0.0 以降の重要な変更

Trace.forceEnableAppTracing() API を追加しました。デバッグ不可のビルドでアプリトレースセクションのキャプチャ（android.os.Trace / androidx.tracing API）を強制的に有効にできるようになります。プロファイリング可能なマニフェストタグが API 29 に導入される前に、デバッグ不可の正確なシステムトレースを有効にする場合は、起動時にこの API を呼び出します。（I3a309）
Trace.java が初めて読み込まれるときにクラス検証エラーを回避します（05f6b4、cb101f）

バージョン 1.1.0-rc01

2022 年 4 月 20 日

androidx.tracing:tracing:1.1.0-rc01 と androidx.tracing:tracing-ktx:1.1.0-rc01 がリリースされました。beta01 からの変更はありません。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.1.0-beta01

2021 年 12 月 1 日

androidx.tracing:tracing:1.1.0-beta01 と androidx.tracing:tracing-ktx:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください。

1.1.0-alpha02 からの変更はありません。

バージョン 1.1.0-alpha02

2021 年 11 月 17 日

androidx.tracing:tracing:1.1.0-alpha02 と androidx.tracing:tracing-ktx:1.1.0-alpha02 がリリースされました。バージョン 1.1.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

Trace.forceEnableAppTracing() API を追加しました。デバッグ不可のビルドでアプリトレースセクションのキャプチャ（android.os.Trace / andoridx.tracing API）を強制的に有効にできるようになります。プロファイリング可能なマニフェストタグが API 29 に導入される前に、デバッグ不可の正確なシステムトレースを有効にする場合は、起動時にこの API を呼び出します。（I3a309）

バージョン 1.1.0-alpha01

2021 年 11 月 3 日

androidx.tracing:tracing:1.1.0-alpha01 と androidx.tracing:tracing-ktx:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください。

バグの修正

Trace.java が初めて読み込まれるときにクラス検証エラーを回避します（05f6b4、cb101f）

Tracing Perfetto バージョン 1.0.0

バージョン 1.0.1

2025 年 11 月 19 日

androidx.tracing:tracing-perfetto:1.0.1、androidx.tracing:tracing-perfetto-binary:1.0.1、androidx.tracing:tracing-perfetto-handshake:1.0.1 がリリースされました。バージョン 1.0.1 にはこれらの commit が含まれています。

バグの修正

16 KB ページサイズのサポート（b7a7dd）
AGP 7.3 以降（R8 バージョン 3.3 など）で R8 を使用する場合、および AGP 8.1 以降（D8 バージョン 8.1 など）ですべてのビルドで、API モデリングを介して新しいプラットフォーム API へのアクセスが自動的に行われるため、新しいプラットフォーム API へのアクセスの手動でのアウトライン設定を削除しました。AGP を使用していないクライアントは、D8 バージョン 8.1 以降に更新することをおすすめします。詳しくは、こちらの記事をご覧ください。（Ia60e0、b/345472586）
ライブラリに FastNative/CriticalNative のコピーをバンドルせず、安定版プラットフォームのコピーを使用します。（I8238a、b/35664282、b/280878596）

バージョン 1.0.0

2023 年 10 月 4 日

androidx.tracing:tracing-perfetto:1.0.0、androidx.tracing:tracing-perfetto-binary:1.0.0、androidx.tracing:tracing-perfetto-handshake:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください。

1.0.0 の主な機能

これは、Tracing-perfetto ライブラリの最初の安定版リリースです。

バージョン 1.0.0-rc01

2023 年 9 月 20 日

androidx.tracing:tracing-perfetto:1.0.0-rc01、androidx.tracing:tracing-perfetto-binary:1.0.0-rc01、androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 がリリースされました。最後のベータ版からの変更はありません。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-beta03

2023 年 8 月 30 日

androidx.tracing:tracing-perfetto:1.0.0-beta03、androidx.tracing:tracing-perfetto-binary:1.0.0-beta03、androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 がリリースされました。バージョン 1.0.0-beta03 に含まれる commit については、こちらをご覧ください。

androidx.benchmark のリリースに合わせてバージョンをバンプしました。

バージョン 1.0.0-beta02

2023 年 8 月 23 日

androidx.tracing:tracing-perfetto:1.0.0-beta02、androidx.tracing:tracing-perfetto-binary:1.0.0-beta02、androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 がリリースされました。バージョン 1.0.0-beta02 に含まれる commit については、こちらをご覧ください。

新機能

アプリの起動時（コールドスタート）のトレースのサポートを有効にしました。

バージョン 1.0.0-beta01

2023 年 7 月 18 日

androidx.tracing:tracing-perfetto:1.0.0-beta01、androidx.tracing:tracing-perfetto-binary:1.0.0-beta01、androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

androidx.tracing.perfetto.Trace の名前を androidx.tracing.perfetto.PerfettoSdkTrace に変更しました（I44af8）
プロトコルで「終了コード」定数の名前を「結果コード」定数に変更し、一貫性を確保（Id1d1e）
EnableTracingResponse の名前を Response に変更しました（I56275）
永続モードでコールドスタートのトレースを有効にするオプションを追加しました。（永続的かどうかにかかわらず）コールドスタートのトレースをクリアする関数を追加しました。（Iaa09d）
Perfetto SDK API を android.os.Trace と一貫性のあるものにしました。（I73ba0、b/282199917）
LibrarySource のファクトリーパターンに移行しました。これにより、必要に応じて、将来のユースケース（.so ファイルの直接読み込みなど）を API に簡単に追加できるようになります。（I128df）
enableTracingColdStart パラメータを enableTracingImmediate に一致させる（I54126）
enableTracingColdStart の killProcess 引数を削除しました（I81c4d）

バージョン 1.0.0-alpha17

2023 年 6 月 21 日

androidx.tracing:tracing-perfetto:1.0.0-alpha17、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17、androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 がリリースされました。以前のアルファ版からの変更はありません。バージョン 1.0.0-alpha17 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha16

2023 年 6 月 7 日

androidx.tracing:tracing-perfetto:1.0.0-alpha16、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16、androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 がリリースされました。以前のアルファ版からの変更はありません。バージョン 1.0.0-alpha16 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha15

2023 年 5 月 3 日

androidx.tracing:tracing-perfetto:1.0.0-alpha15、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15、androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 がリリースされました。変更はありません。バージョン 1.0.0-alpha15 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha14

2023 年 4 月 5 日

androidx.tracing:tracing-perfetto:1.0.0-alpha14、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14、androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 がリリースされました。新しい変更はありません。バージョン 1.0.0-alpha14 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha13

2023 年 3 月 22 日

androidx.tracing:tracing-perfetto:1.0.0-alpha13、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13、androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 がリリースされました。前回のリリースからの変更はありません。バージョン 1.0.0-alpha13 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha12

2023 年 3 月 8 日

androidx.tracing:tracing-perfetto:1.0.0-alpha12、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12、androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 がリリースされました。以前のアルファ版からの変更はありません。バージョン 1.0.0-alpha12 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha11

2023 年 2 月 22 日

androidx.tracing:tracing-perfetto:1.0.0-alpha11、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11、androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 がリリースされました。変更はありません。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha10

2023 年 2 月 8 日

androidx.tracing:tracing-perfetto:1.0.0-alpha10、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10、androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 がリリースされました。変更はありません。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha09

2023 年 2 月 10 日

androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

新機能

他の androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 ライブラリが連携できるように、バージョンバンプリリースを行いました。

2023 年 1 月 11 日

androidx.tracing:tracing-perfetto:1.0.0-alpha09 と androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 がリリースされました。変更はありません。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha08

2022 年 12 月 7 日

androidx.tracing:tracing-perfetto:1.0.0-alpha08、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08、androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

文字列の処理方法を最適化することでパフォーマンスを改善しました。

バグの修正

クラスが使用されている場合に PerfettoNative のメソッドがプルーニングされるのを防ぐ ProGuard ルールを追加しました（トレースが初期化されたものの、アプリにトレース呼び出しが存在しないニッチなケースでのクラッシュを防ぎます）。

バージョン 1.0.0-alpha07

2022 年 11 月 9 日

androidx.tracing:tracing-perfetto:1.0.0-alpha07、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07、androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

androidx.tracing:tracing-perfetto API の JNI オーバーヘッドを削減しました。

バージョン 1.0.0-alpha06

2022 年 10 月 24 日

androidx.tracing:tracing-perfetto:1.0.0-alpha06、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06、androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

この更新に変更は含まれていません。androidx.benchmark と同期するためにバージョン番号を更新しただけです。

バージョン 1.0.0-alpha05

2022 年 10 月 5 日

androidx.tracing:tracing-perfetto:1.0.0-alpha05、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05、androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha04

2022 年 9 月 21 日

androidx.tracing:tracing-perfetto:1.0.0-alpha04、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04、androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha03

2022 年 9 月 7 日

androidx.tracing:tracing-perfetto:1.0.0-alpha03、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03、androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 がリリースされました。

新機能

1.0.0-alpha02 以降の新機能はありません。

バージョン 1.0.0-alpha02

2022 年 8 月 24 日

androidx.tracing:tracing-perfetto:1.0.0-alpha02、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02、androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

バグの修正

Perfetto サービスの初期化にいくつかの改善を加えました。
専用の終了コード RESULT_CODE_CANCELLED を導入することにより、レスポンスなしのケースの処理を改善しました。
解析エラーの処理を改善しました。
EnableTracingResponse.requiredVersion を null 値可能にしました。これは、パッケージと通信できない場合、バージョンを認識できないためです。（I5ba20）

バージョン 1.0.0-alpha01

2022 年 7 月 27 日

androidx.tracing:tracing-perfetto:1.0.0-alpha01、androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01、androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

注: すべての androidx.tracing:tracing-perfetto* ライブラリは、最初は AndroidX ライブラリ内での内部使用のみを想定しています。これらのライブラリに直接依存する必要はありません。

新機能

すべての androidx.tracing:tracing-perfetto* ライブラリは、最初は AndroidX ライブラリ内での内部使用のみを想定しています。これらのライブラリに直接依存する必要はありません。これらの実装の詳細は、透明性の向上のためにドキュメント化しています。
androidx.tracing:tracing-perfetto は、低オーバーヘッドの Perfetto SDK を使用してトレースイベントを書き込むために利用できるライブラリです。Benchmark、Android Studio、または Perfetto UI 内で使用できます。
androidx.tracing:tracing-perfetto-binary は、androidx.tracing:tracing-perfetto に必要なバイナリ依存関係のセットです。
androidx.tracing:tracing-perfetto-common は、androidx.tracing:tracing-perfetto の内部依存関係です。androidx.tracing:tracing-perfetto と統合するツールで使用できます。

Tracing バージョン 1.0.0

バージョン 1.0.0

2020 年 10 月 28 日

androidx.tracing:tracing:1.0.0 と androidx.tracing:tracing-ktx:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください。

1.0.0 の主な機能

トレースイベントをシステムトレースバッファに書き込むために利用できます。Systrace や Perfetto などのツールを使用して可視化できます。このライブラリは、サポートが終了した androidx.core.os.TraceCompat クラスに代わるものです。

バージョン 1.0.0-rc01

2020 年 10 月 14 日

androidx.tracing:tracing:1.0.0-rc01 と androidx.tracing:tracing-ktx:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください。

このリリースは 1.0.0-beta01 と同一です。

バージョン 1.0.0-beta01

2020 年 6 月 24 日

androidx.tracing:tracing:1.0.0-beta01 と androidx.tracing:tracing-ktx:1.0.0-beta01 がリリースされました。1.0.0-alpha01 からの変更はありません。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha01

2020 年 6 月 10 日

androidx.tracing:tracing:1.0.0-alpha01 と androidx.tracing:tracing-ktx:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

androidx.tracing は、トレースイベントをシステムトレースバッファに書き込むために利用できるライブラリです。Systrace や Perfetto などのツールを使用して可視化できます。このライブラリは、サポートが終了した androidx.core.os.TraceCompat クラスに代わるものです。この初回リリースは 1.0.0-alpha01 です。