Tracing

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

フィードバック

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

新しい問題を報告する

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

バージョン 1.2

バージョン 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-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 年 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 です。