追蹤

  
將追蹤事件寫入系統追蹤緩衝區。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
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 版包含這些修訂版本。

自 1.2.0 版以來的重要異動

  • 將 androidx.tracing.Trace 類別轉換為 Kotlin，並將所有程式碼從 tracing-ktx 模組移至 tracing。
  • 從追蹤記錄中移除 crossinline，以便在 @Composable 中使用。(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，且自上一個 Beta 版以來皆無異動。1.3.0-rc01 版本包含這些修訂版本。

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 版包含這些修訂版本。

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，且與先前的 Alpha 版本沒有差異。1.3.0-alpha02 版包含以下修訂項目。

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 版本包含以下修訂項目。

API 變更

  • 從追蹤記錄中移除 crossinline，以便在 @Composable 中使用。(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 版本包含以下修訂項目。

自 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 版包含此連結所列的修訂項目。

修正錯誤

  • 自動截斷長的追蹤記錄區段名稱，避免發生當機情形 (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 版包含以下修訂項目。

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 版本包含以下修訂項目。

1.2.0-beta02 版

2023 年 3 月 22 日

發布 androidx.tracing:tracing:1.2.0-beta02 和 androidx.tracing:tracing-ktx:1.2.0-beta02，且自上一個 Beta 版以來皆無異動。1.2.0-beta02 版包含此連結所列的修訂項目。

1.2.0-beta01 版本

2023 年 3 月 8 日

發布 androidx.tracing:tracing:1.2.0-beta01 和 androidx.tracing:tracing-ktx:1.2.0-beta01，且自上一個 Alpha 版發布以來皆無異動。1.2.0-beta01 版包含此連結所列的修訂項目。

1.2.0-alpha02 版本

2023 年 2 月 23 日

發布 androidx.tracing:tracing:1.2.0-alpha02 和 androidx.tracing:tracing-ktx:1.2.0-alpha02，且與上一個 Alpha 版本沒有差別。1.2.0-alpha02 版包含此連結所列的修訂項目。

修正錯誤

  • 這個版本會在升級至 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 版包含此連結所列的修訂項目。

新功能

  • 使用延遲字串和 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 版本包含以下修訂項目。

自 1.0.0 版本以來的重要異動

  • 新增了 Trace.forceEnableAppTracing() API，可在無法進行偵錯的建構作業上強制啟用應用程式追蹤區塊擷取 (即 android.os.Trace / androidx.tracing API)。請在啟動時呼叫此功能，以便在 API 29 推出可分析的資訊清單標記之前，啟用無法進行偵錯的準確系統追蹤。(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 版本包含以下修訂項目。

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 版本包含以下修訂項目。

自 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 版的修訂項。

新功能

  • 新增了 Trace.forceEnableAppTracing() API，可在無法進行偵錯的建構作業上強制啟用應用程式追蹤區塊擷取 (即 android.os.Trace / andoridx.tracing API)。請在啟動時呼叫此功能，以便在 API 29 推出可分析的資訊清單標記之前，啟用無法進行偵錯的準確系統追蹤。(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 版的修訂項。

修正錯誤

  • 避免在首次載入 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 版包含此連結所列的修訂項目。

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，且自上一個 Beta 版以來皆無異動。1.0.0-rc01 版本包含以下修訂項目。

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 版包含此連結所列的修訂項目。

  • 版本升級，以符合 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 版包含此連結所列的修訂項目。

新功能

  • 在應用程式啟動 (冷啟動) 時支援追蹤。

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 版本包含以下修訂項目。

API 變更

  • 已將 androidx.tracing.perfetto.Trace 重新命名為 androidx.tracing.perfetto.PerfettoSdkTrace (I44af8)
  • 為求一致，將通訊協定中的「exit code」重新命名為「result code」常數 (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，且與先前的 Alpha 版皆無異動。1.0.0-alpha17 版包含此連結所列的修訂項目。

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，且與先前的 Alpha 版皆無異動。1.0.0-alpha16 版包含此連結所列的修訂項目。

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 版包含此連結所列的修訂項目。

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 版包含此連結所列的修訂項目。

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 版包含此連結所列的修訂項目。

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，且自先前的 Alpha 版以來皆無異動。1.0.0-alpha12 版包含此連結所列的修訂項目。

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 版包含此連結所列的修訂項目。

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 版包含此連結所列的修訂項目。

1.0.0-alpha09 版本

2023 年 2 月 10 日

發布 androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09。查看 1.0.0-alpha09 版的修訂項。

新功能

  • 版本升級發布，讓其他 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 版包含此連結所列的修訂項目。

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 版包含此連結所列的修訂項目。

新功能

  • 透過最佳化字串的處理方式，改善效能。

修正錯誤

  • 新增 ProGuard 規則，避免使用類別時 PerfettoNative 的方法被截斷 (避免在追蹤初始化時在特殊案例中發生當機，但應用程式中沒有任何追蹤呼叫)。

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 版本包含以下修訂項目。

  • 降低了 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 版包含以下修訂項目。

  • 此更新未包含任何變更，只是更新版本號碼，以便與 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 版的修訂項。

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 版包含以下修訂項目。

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 版本包含以下修訂項目。

修正錯誤

  • 針對 Perfetto 服務初始化進行多項改善
  • 導入專屬的結束程式碼，以改善無回應案例的處理方式：RESULT_CODE_CANCELLED。
  • 改善剖析錯誤的處理方式。
  • 將 EnableTracingResponse.requiredVersion 設為可為空值，因為如果我們不能與套件通訊，則無法知道該版本。(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 版本包含以下修訂項目。

  • 注意：所有 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 版的修訂項。

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 版的修訂項。

這個版本與 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 版本包含以下修訂項目。

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 版包含此連結所列的修訂項目。

新功能

androidx.tracing 是一個程式庫，可協助將追蹤事件寫入系統追蹤緩衝區。您可以使用 Systrace 和 Perfetto 等工具以視覺化的方式呈現。此程式庫取代了已淘汰的 androidx.core.os.TraceCompat 類別。此初始版本為 1.0.0-alpha01。