トレース

  
トレース イベントをシステム トレース バッファに書き込みます。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2025 年 4 月 23 日 1.3.0 - - -

フィードバック

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

新しい問題を報告する

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

バージョン 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）

バグの修正

  • 新しいプラットフォーム API へのアクセスの手動アウトラインを削除しました。これは、AGP 7.3 以降（R8 バージョン 3.3 など）で R8 を使用する場合、および AGP 8.1 以降（D8 バージョン 8.1 など）を使用するすべてのビルドで、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.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）
  • Tracing 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 です。