Tracing

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

フィードバック

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

新しい問題を報告する

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

バージョン 1.3

バージョン 1.3.0-alpha02

2023 年 6 月 21 日

androidx.tracing:tracing:1.3.0-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • @Composable で使用できるようにするため、トレースから crossinline を削除しました。(I53882b/248344805

バージョン 1.2

バージョン 1.2.0

2023 年 11 月 29 日

androidx.tracing:tracing:1.2.0androidx.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-rc01androidx.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-beta04androidx.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-beta03androidx.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-beta02androidx.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-beta01androidx.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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

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

Tracing バージョン 1.1

バージョン 1.1.0

2022 年 5 月 11 日

androidx.tracing:tracing:1.1.0androidx.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 が初めて読み込まれるときにクラス検証エラーを回避します(05f6b4cb101f

バージョン 1.1.0-rc01

2022 年 4 月 20 日

androidx.tracing:tracing:1.1.0-rc01androidx.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-beta01androidx.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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください

バグの修正

  • Trace.java が初めて読み込まれるときにクラス検証エラーを回避します(05f6b4cb101f

Tracing Perfetto バージョン 1.0.0

バージョン 1.0.0

2023 年 10 月 4 日

androidx.tracing:tracing-perfetto:1.0.0androidx.tracing:tracing-perfetto-binary:1.0.0androidx.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-rc01androidx.tracing:tracing-perfetto-binary:1.0.0-rc01androidx.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-beta03androidx.tracing:tracing-perfetto-binary:1.0.0-beta03androidx.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-beta02androidx.tracing:tracing-perfetto-binary:1.0.0-beta02androidx.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-beta01androidx.tracing:tracing-perfetto-binary:1.0.0-beta01androidx.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 との整合性を確保しました。(I73ba0b/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-alpha17androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17androidx.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-alpha16androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16androidx.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-alpha15androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15androidx.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-alpha14androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14androidx.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-alpha13androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13androidx.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-alpha12androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12androidx.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-alpha11androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11androidx.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-alpha10androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10androidx.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-alpha09androidx.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-alpha08androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08androidx.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-alpha07androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07androidx.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-alpha06androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06androidx.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-alpha05androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05androidx.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-alpha04androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04androidx.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-alpha03androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03androidx.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-alpha02androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02androidx.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-alpha01androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01androidx.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.0androidx.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-rc01androidx.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-beta01androidx.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-alpha01androidx.tracing:tracing-ktx:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

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