指標
| 最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
|---|---|---|---|---|
| 2024 年 1 月 10 日 | - | - | 1.0.0-beta01 | - |
宣告依附元件
如要新增 Metrics 的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：
Groovy
dependencies {
implementation "androidx.metrics:metrics-performance:1.0.0-beta01"
}
Kotlin
dependencies {
implementation("androidx.metrics:metrics-performance:1.0.0-beta01")
}
如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
1.0.0 版本
1.0.0-beta01 版本
2024 年 1 月 10 日
這個程式庫的 API 和功能已穩定運作一段時間。這個版本只會將程式庫推送至 Beta 版。
發布 androidx.metrics:metrics-performance:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。
1.0.0-alpha04 版
2023 年 4 月 5 日
此版本將 JankStats 更新為最新修正檔，包括更準確且更全面的時間資訊。
發布 androidx.metrics:metrics-performance:1.0.0-alpha04。查看 1.0.0-alpha04 版的修訂項。
API 變更
cpuDuration現在更準確，且 API 31 上的新totalDuration(I59ce8、b/243694893)
1.0.0-alpha03 版本
2022 年 7 月 27 日
發布 androidx.metrics:metrics-performance:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。
隨著程式庫即將發布 Beta 版，這個版本包含微幅的 API 修正項目。其中一個 API 變更是從
createAndTrack()工廠方法移除 Executor，以便建立JankStats物件。這會影響OnFrameListener回呼，因為系統現已在執行緒上呼叫事件監聽器，該執行緒會將每個影格資料傳送至JankStats(API 24 以下版本的主/UI 執行緒，以及 API 24 以上版本的FrameMetrics執行緒)。此外，傳遞至事件監聽器的FrameData物件現在會重複使用每個頁框，因此在回呼期間，必須立即複製該物件的資料並快取至其他位置。這個版本也修正了各項錯誤，包括一些並行問題。
最後，修正重複使用
FrameData的修正 (如上文所述) 表示由於影格指標傳送的關係，目前每個影格沒有任何配置。以往的配置資源不多，但使用新的做法後，您可以使用JankStats，而不會在應用程式中產生任何因影格所致的 GC 負擔。
API 變更
- 更新
PerformanceMetricsState中的方法和參數名稱，讓這些呼叫的結果更加明確。(I56da5、b/233421985) - 新增基準測試以追蹤配置情形，移除部分與狀態管理和報告相關的內部配置。請注意，傳遞給事件監聽器的
FrameData現已視為可變動，該結構將在下一個影格中重複使用，而且只有在事件監聽器回傳之前的資料才可信賴。 - 從
JankStats的建構函式中移除 Executor；現在，系統會在接收內部資料的任何執行緒上呼叫事件監聽器。(I12743)。
修正錯誤
- 修正因重複移除
OnFrameMetricsAvailableListener所造成的當機問題 (I44094、b/239457413) - 返回在佇列前張貼
OnPreDrawListener訊息的原始邏輯，藉此提高影格時間的一致性和可預測性。(I05a43、b/233358407) - 修正
ConcurrentModificationException錯誤，避免事件監聽器委派清單在疊代傳送每個影格的資料時遭到修改。(Ib7693、b/236612357)
1.0.0-alpha02 版
2022 年 6 月 29 日
發布 androidx.metrics:metrics-performance:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。
API 變更
- 已將
MetricsStateHolder重新命名為 Holder (PerformanceMetricsState內)：(I5a4d9、b/226565716、b/213499234)
修正錯誤
- 修正了在處理舊狀態正確無誤的影格之前，可以用新值替換狀態的時間問題 (aosp/2061892、b/213499234)
- 修正了新增/移除事件監聽器的並行修改例外狀況 (aosp/2092714、b/213499234)
- 提高 startTime 計算的準確度 (aosp/2027704、b/213245198)
- 修正
FrameData.equals()實作中的錯誤 (aosp/2025866、b/218296544)
1.0.0-alpha01 版
2022 年 2 月 9 日
發布 androidx.metrics:metrics-performance:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。
新功能
JankStats程式庫提供在執行階段檢測及接收回呼的功能，有助於找出實際的效能問題。JankStats結合了易於插入 UI 狀態相關資訊的 API，並提供各影格效能的追蹤和回報功能，讓開發人員瞭解應用程式是否有效能問題，以及發生時機和原因。