追蹤

  
將追蹤事件寫入系統追蹤緩衝區。
最近更新時間 穩定版 候選版 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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.3.0-alpha011.3.0-alpha01 版本包含以下修訂項目。

API 變更

  • 從追蹤記錄中移除 crossinline,允許在 @Composable 中使用。(I53882b/248344805)

1.2 版本

1.2.0 版

2023 年 11 月 29 日

發布 androidx.tracing:tracing:1.2.0androidx.tracing:tracing-ktx:1.2.01.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-rc01androidx.tracing:tracing-ktx:1.2.0-rc011.2.0-rc01 版包含此連結所列的修訂項目。

修正錯誤

  • 自動截斷長追蹤記錄部分名稱,避免發生當機情形 (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 版包含此連結所列的修訂項目。

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

1.2.0-beta02 版

2023 年 3 月 22 日

發布 androidx.tracing:tracing:1.2.0-beta02androidx.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-beta01androidx.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-alpha02androidx.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-alpha01androidx.tracing:tracing-ktx:1.2.0-alpha011.2.0-alpha01 版包含此連結所列的修訂項目。

新功能

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

自 1.0.0 版本以來的重要異動

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

1.1.0-beta01 版本

2021 年 12 月 1 日

發布 androidx.tracing:tracing:1.1.0-beta01androidx.tracing:tracing-ktx:1.1.0-beta011.1.0-beta01 版本包含以下修訂項目。

1.1.0-alpha02 以來沒有變更。

1.1.0-alpha02 版本

2021 年 11 月 17 日

發布 androidx.tracing:tracing:1.1.0-alpha02androidx.tracing:tracing-ktx:1.1.0-alpha021.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-alpha01androidx.tracing:tracing-ktx:1.1.0-alpha01查看 1.1.0-alpha01 版的修訂項

修正錯誤

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

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,且自上一個 Beta 版以來皆無異動。1.0.0-rc01 版包含此連結所列的修訂項目。

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

  • 要與 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-beta021.0.0-beta02 版包含此連結所列的修訂項目。

新功能

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

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

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

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

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

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

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

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

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

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-alpha09androidx.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-alpha08androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08androidx.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-alpha07androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07androidx.tracing:tracing-perfetto-common:1.0.0-alpha071.0.0-alpha07 版本包含以下修訂項目。

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

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

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

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

修正錯誤

  • 針對 Perfetto 服務初始化進行多項改善
  • 導入專屬的結束程式碼,以改善無回應案例的處理方式:RESULT_CODE_CANCELLED。
  • 改善剖析錯誤的處理方式。
  • EnableTracingResponse.requiredVersion 設為可為空值,因為如果我們不能與套件通訊,則無法知道該版本。(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-alpha011.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.0androidx.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-rc01androidx.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-beta01androidx.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-alpha01androidx.tracing:tracing-ktx:1.0.0-alpha011.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

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