Metrikler

  
Uygulamanız için çeşitli çalışma zamanı metriklerini izleme ve raporlama
Son Güncelleme Kararlı sürüm Sürüm Adayı Beta Sürümü Alfa sürümü
8 Ekim 2025 1.0.0 - - -

Bağımlılıkları bildirme

Metrikler'e bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:

Eski

dependencies {
    implementation "androidx.metrics:metrics-performance:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.metrics:metrics-performance:1.0.0")
}

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz varsa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.

Sürüm 1.0.0

Sürüm 1.0.0

8 Ekim 2025

androidx.metrics:metrics-performance:1.0.0 iptal edilir. 1.0.0 sürümü bu commit'leri içerir.

1.0.0 sürümündeki başlıca özellikler:

  • JankStats API, uygulamanızın kare performansını ölçmenize ve performans metriklerine bağlam (ne olduğu ve karelerin nerede üretildiği) eklemenize olanak tanır. Daha fazla bilgi için dokümanlara bakın.

Sürüm 1.0.0-rc01

24 Eylül 2025

androidx.metrics:metrics-performance:1.0.0-rc01 iptal edilir. 1.0.0-rc01 sürümü bu commit'leri içerir.

Sürüm 1.0.0-beta04

10 Eylül 2025

androidx.metrics:metrics-performance:1.0.0-beta04 iptal edilir. 1.0.0-beta04 sürümü bu commit'leri içerir.

Harici Katkı (External Contribution)

Sürüm 1.0.0-beta03

27 Ağustos 2025

androidx.metrics:metrics-performance:1.0.0-beta03 iptal edilir. 1.0.0-beta03 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • IllegalArgumentException("Hiç eklenmemiş olan OnFrameMetricsAvailableListener öğesini kaldırma girişimi") düzeltildi. Bir pencere donanım hızlandırmalı olmadığında kare zamanlamasını kaydetme girişimi yapılmaz. Bunun nedeni, bu işlemin Window.OnFrameMetricsAvailableListener tarafından desteklenmemesidir. (I8fef2, b/436880904)

Sürüm 1.0.0-beta02

12 Mart 2025

androidx.metrics:metrics-performance:1.0.0-beta02 iptal edilir. 1.0.0-beta02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Kilitlenmeleri düzeltme DelegatingFrameMetricsListener cannot be cast... (Id891c, b/311218678).

Sürüm 1.0.0-beta01

10 Ocak 2024

Bu kitaplığın API'si ve işlevleri bir süredir kararlıdır. Bu sürüm, kitaplığı beta sürümüne taşır.

androidx.metrics:metrics-performance:1.0.0-beta01 iptal edilir. 1.0.0-beta01 sürümü şu commit'leri içerir.

Sürüm 1.0.0-alpha04

5 Nisan 2023

Bu sürümde, daha doğru ve kapsamlı zamanlama bilgilerini içeren en son düzeltmelerle JankStats güncellenir.

androidx.metrics:metrics-performance:1.0.0-alpha04 iptal edilir. 1.0.0-alpha04 sürümü şu commit'leri içerir.

API Değişiklikleri

  • cpuDuration artık daha doğru ve API31'de yeni totalDuration (I59ce8, b/243694893)

Sürüm 1.0.0-alpha03

27 Temmuz 2022

androidx.metrics:metrics-performance:1.0.0-alpha03 iptal edilir. 1.0.0-alpha03 sürümü şu commit'leri içerir.

  • Kitaplık beta sürümüne yaklaştıkça bu sürümde küçük API iyileştirmeleri yapıldı. API değişikliklerinden biri, createAndTrack() nesnesi oluşturmak için kullanılan JankStats fabrika yönteminden Executor'ı kaldırıyor. Bu durum, OnFrameListener geri çağırması için sonuçlar doğurur. Çünkü bu dinleyici artık kare başına verileri JankStats'ye (API 24'ten önceki sürümlerdeki ana/UI iş parçacığı ve API 24'ten sonraki sürümlerdeki FrameMetrics iş parçacığı) ileten iş parçacığında çağrılır. Ayrıca, dinleyiciye iletilen FrameData nesnesi artık her karede yeniden kullanılır. Bu nedenle, dinleyici döndüğünde bu nesne eski olarak kabul edileceğinden, geri çağırma sırasında bu nesnedeki verilerin başka bir yere kopyalanıp önbelleğe alınması gerekir.

  • Aynı anda yapılan işlemlerle ilgili sorunlar da dahil olmak üzere çeşitli hata düzeltmeleri yapıldı.

  • Son olarak, FrameData'nın (yukarıda bahsedilen) yeniden kullanılmasıyla ilgili düzeltme, artık kare metriklerinin iletilmesi nedeniyle kare başına sıfır tahsis olduğu anlamına geliyor. Daha önce çok fazla ayırma işlemi yapılmıyordu ancak yeni yaklaşım sayesinde uygulamanızda kare başına GC ek yükü olmadan JankStats kullanabilirsiniz.

API Değişiklikleri

  • Bu aramaların sonuçlarını daha net hale getirmek için PerformanceMetricsState içindeki yöntem ve parametre adları güncellendi. (I56da5, b/233421985)
  • Ayırmaları izlemek için karşılaştırma testleri eklendi, durum yönetimi ve raporlamayla ilgili bazı dahili ayırmalar kaldırıldı. Dinleyicilere iletilen FrameData değerinin artık geçici olarak kabul edildiğini unutmayın. Bu yapı, bir sonraki kare için yeniden kullanılır ve veriler yalnızca dinleyici döndürene kadar güvenilirdir.
  • JankStats için oluşturucudan Executor kaldırıldı. Artık dahili verilerin alındığı iş parçacığı üzerinde dinleyiciler çağrılıyor. (I12743)

Hata Düzeltmeleri

  • OnFrameMetricsAvailableListener öğesinin iki kez kaldırılması nedeniyle oluşan kilitlenme düzeltildi (I44094, b/239457413)
  • Daha tutarlı ve öngörülebilir kare zamanlaması için OnPreDrawListener iletilerini sıranın başına yerleştirme mantığına geri dönüldü. (I05a43, b/233358407)
  • Kare başına veri göndermek için yineleme yapılırken dinleyici temsilcileri listesinin de değiştirildiği ConcurrentModificationException hatası düzeltildi. (Ib7693, b/236612357)

Sürüm 1.0.0-alpha02

29 Haziran 2022

androidx.metrics:metrics-performance:1.0.0-alpha02 iptal edilir. 1.0.0-alpha02 sürümü şu commit'leri içerir.

API Değişiklikleri

Hata Düzeltmeleri

Sürüm 1.0.0-alpha01

9 Şubat 2022

androidx.metrics:metrics-performance:1.0.0-alpha01 iptal edilir. 1.0.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • JankStats kitaplığı, uygulamanızda çalışma zamanında geri çağırmaları izlemenize ve almanıza olanak tanıyan işlevler sunar. Bu işlevler, gerçek dünyadaki performans sorunlarını bulmanıza yardımcı olabilir.
  • JankStats, kullanıcı arayüzü durumuyla ilgili bilgilerin kolayca eklenmesini sağlayan bir API'yi, kare başına performansı izleme ve raporlama özellikleriyle birleştirerek geliştiricilerin bir uygulamanın performans sorunları olup olmadığını değil, ne zaman ve neden olduğunu anlamasına olanak tanır.