追蹤

  
將追蹤事件寫入系統追蹤緩衝區。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
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-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)
  • 為求一致性，通訊協定中已將「結束程式碼」重新命名為「結果程式碼」常數 (Id1d1e)
  • EnableTracingResponse 已重新命名為 Response。(I56275)。
  • 已新增在永久模式下啟用冷啟動追蹤功能的選項。新增了函式，用於清除 (永久或不持續) 冷啟動追蹤。(Iaa09d)。
  • 已採用與 android.os.Trace 一致的 Tracing Perfetto SDK API。(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。