İzleme

  
İzleme etkinliklerini sistem izleme arabelleğine yazın.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
12 Ekim 2026 2.0.4 - - -

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. Lütfen yeni bir tane oluşturmadan önce bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir sorun için oy verebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Issue Tracker belgelerine bakın.

İzleme

Sürüm 2.0

Sürüm 2.0.4

12 Ekim 2026

androidx.tracing:tracing-*:2.0.4 yayınlandı. 2.0.4 sürümü bu commit'leri içerir.

Hata Düzeltmeleri
  • İzleme paketleri temizlenirken oluşan yarış durumu düzeltildi. (aosp/4344047)

Sürüm 2.0.3

23 Eylül 2026

androidx.tracing:tracing-*:2.0.3 yayınlandı. 2.0.3 sürümü bu commit'leri içerir.

Sürüm 2.0.2

9 Eylül 2026

androidx.tracing:tracing-*:2.0.2 yayınlandı. 2.0.2 sürümü bu commit'leri içerir.

Sürüm 2.0.1

26 Ağustos 2026

androidx.tracing:tracing-*:2.0.1 yayınlandı. 2.0.1 sürümü bu commit'leri içerir.

Sürüm 2.0.0

12 Ağustos 2026

androidx.tracing:tracing-*:2.0.0 yayınlandı. 2.0.0 sürümü bu commit'leri içerir.

2.0.0 sürümünün önemli özellikleri:

Yeni işlem içi API şunları sağlar:

  • İşlem sırasında, sahada iz içeriği kaydetme
  • Perfetto akışları (bir dilimden diğerine giden oklar)
  • Perfetto ek açıklamaları (anahtar/değer dilim meta verileri)
  • traceCoroutine() {}: İş parçacığı geçişlerini izleyen Coroutine Tracing API
  • Category filtering
  • Mevcut android.os.Trace API'si ve trace() {} sarmalayıcısından önemli ölçüde daha düşük ek yük
  • KMP izleme: Android bağımlılığı olmayan kitaplıklarda ve ana makine JVM projelerinde kullanılabilir.
  • Sistem izleme kaydıyla birleştirme (AndroidX Benchmark 1.5'te varsayılan olarak uygulanır)

Yeni izleme API'lerinin, Studio sistem izleme kaydı tarafından henüz yakalanmayan, süreç kontrollü bir arabelleğe kayıt yaptığını unutmayın. Bu sorun, Studio Profiler'ın gelecek bir sürümünde giderilecektir.

Mevcut android.os.Trace / trace() {} API'lerinin desteği sonlandırılmadı. Bu API'ler, özellikle kitaplıklarda her zaman sistem izleme arabelleğine kaydedilmesi gereken düşük frekanslı etkinlikler için önerilir.

Sürüm 2.0.0-rc01

29 Temmuz 2026

androidx.tracing:tracing-*:2.0.0-rc01 yayınlandı. 2.0.0-rc01 sürümü bu kayıtları içerir.

Sürüm 2.0.0-beta01

15 Temmuz 2026

androidx.tracing:tracing-*:2.0.0-beta01 yayınlandı. 2.0.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • PerfettoCapture ve PerfettoTraceRule artık işlem içi izleri yakalayabilir ve bunları hedef paket için birleştirebilir. (I9a00b, b/497959820)
  • androidx.benchmark artık 24 minSdk değerine sahip. (Ic2a85)

Hata Düzeltmeleri

  • Tracing 2.0-beta01 sürümü. (I1b162)
  • Parça bilgileri oluştururken platforma özgü mesaj dizisi tanımlayıcıları kullanın. (I6ba64)

Sürüm 2.0.0-alpha09

23 Haziran 2026

androidx.tracing:tracing-*:2.0.0-alpha09 yayınlandı. 2.0.0-alpha09 sürümü bu commit'leri içerir.

API Değişiklikleri

  • instant(...) ile writeInstant(...) arasında ayrım yapmak için Tracer'da küçük bir API değişikliği yapıldı. (I0935a)
  • Anlık etkinliklerde yayılma jetonları için destek ekleyin. (I99f81)
  • Deneysel manuel bağlam yayma API'sinde Perfetto akışlarının tam kullanımına izin ver. (I20cb6)
  • TraceSink içinde BufferedSink ve ProtoWriter oluşturma işlemini erteleyin. (Ibd098)
  • Tracer keşfini hem Java hem de Android kitaplıkları için basit ve takılabilir hale getirin. (I99111)
  • Kitaplık geliştiricilerin, işlem içi izleme için kullanılabilecek bir TraceDriver örneğini keşfetmesini kolaylaştırın. (Ia503e)

Sürüm 2.0.0-alpha08

19 Mayıs 2026

androidx.tracing:tracing-*:2.0.0-alpha08 yayınlandı. 2.0.0-alpha08 sürümü bu commit'leri içerir.

API değişiklikleri

  • Süreç genelinde kullanılacak TraceDriver örneklerini keşfetme ve geçersiz kılma özelliğini ekleyin. (I3f715)
  • Tracer.recordException adlı öğeyi Tracer.recordExceptionAndThrow olarak yeniden adlandırın. (I4411f, b/503092450)

Sürüm 2.0.0-alpha07

6 Mayıs 2026

androidx.tracing:tracing-*:2.0.0-alpha07 yayınlandı. 2.0.0-alpha07 sürümü bu kayıtları içerir.

API Değişiklikleri

  • İzleme devre dışı bırakıldığında kullanılabilecek bir saplama izleyici elde etmek için API ekleyin. (I84c98)
  • İzleme yaşam döngüsünü sistem izleme ile tutarlı hale getirin. (Ib391b)
  • Sayaç API'leri artık tamamen tahsisat gerektirmez. (I5e73a)

Hata Düzeltmeleri

  • Perfetto SDK'nın (tracing-perfetto) etkinleştirilebilmesini sağlayan bir tutma kuralı düzeltildi. (I1d227)
  • flush() etkinliklerini izleme özelliği eklendi. (I38014, b/495852704)

Sürüm 2.0.0-alpha06

22 Nisan 2026

androidx.tracing:tracing-*:2.0.0-alpha06 yayınlandı. 2.0.0-alpha06 sürümü bu kayıtları içerir.

API değişiklikleri

  • Diğer kullanıcıların güvenli bir şekilde havuz oluşturabilmesi için File.createPerfettoFile() kısıtlamasını kaldırın. block(), trace / traceCoroutine içinde bir istisna oluşturduğunda, ilgili yığın izleme öğelerini temsil eden meta verilerle istisna için bir instant etkinliği oluşturun. (I682e5, b/501536851, b/437166283)
  • Java Long türünü alan bir setCounter(...) aşırı yüklemesi ekleyin. (Ic0469, b/356082604)
  • Tracing 2.0 artık platforma özgü Thread tanımlayıcıları için Long kullanıyor. (I67277)

Hata Düzeltmeleri

Sürüm 2.0.0-alpha05

8 Nisan 2026

androidx.tracing:tracing-*:2.0.0-alpha05 yayınlandı. 2.0.0-alpha05 sürümü bu commit'leri içerir.

API Değişiklikleri

  • TraceSink fabrika işlevleri artık AbstractTraceSink yerine TraceSink döndürüyor. Dosyaların artık benzersiz bir son eki var. İzleme paketlerini depolamak için kullanılacak yeni bir dosyayı atomik olarak oluşturabildiğimizden emin oluruz. (I4c4aa, b/496298726)
  • Eş yordam bağlamı yayılımını basitleştirip hızlandırın. (Ia62db)
  • TraceDriver oluştururken izle ilgili meta veri ekleme imkanı sunan isteğe bağlı attributes() öğesini kullanın. (Ia147e)

Hata düzeltmeleri

  • İşlem iş parçacıkları ve sayaç parçaları artık senkronize edilir. Bu, şu biçimdeki istisnaları düzeltir: java.lang.NullPointerException: Cannot invoke "androidx.tracing.ThreadTrack.flush$tracing()" because "threadTrack" is null
  • İzleme devre dışı bırakıldığında sink etkinlikleri yayınlamaktan kaçının.

Sürüm 2.0.0-alpha04

25 Mart 2026

androidx.tracing:tracing-*:2.0.0-alpha04 yayınlandı. 2.0.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

  • AbstractTraceDriver öğesini tamamen soyut hale getirin ve Perfetto uygulamasını tracing-wire modülüne taşıyın. (Ie2f59)
  • Yanlış olanı kullanmamak için temel uygulamalara daha açıklayıcı adlar verin. Daha önce androidx.tracing.Trace{Sink|Driver} sınıfını genişleten geliştiricilerin artık AbstractTrace{Sink|Driver} sınıfını kullanmaya geçmesi gerekecek. (I9b46d)

Sürüm 2.0.0-alpha03

11 Mart 2026

androidx.tracing:tracing-*:2.0.0-alpha03 yayınlandı. 2.0.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Kapasite kısıtlaması ayarlamaya olanak tanıyan ve açıkça istenmediği sürece diske yazmayı önleyen deneysel bir InMemoryRingBufferTraceSink uygulaması eklendi. (I1dc44, b/484409653, I65a37, b/484409653)
  • Eş yordam askıya alma ve devam ettirme işlemleri için izleme etkinlikleri yayınlanırken ortaya çıkan yarışma durumu düzeltildi. (Ie145e)

Hata Düzeltmeleri

  • androidx.tracing artık varsayılan olarak izlemelerde üstten alta alt yordam bağlantıları oluşturmaya çalışmaz. Temel izleme biçimi 1:N ve N:1 bağlantılarını desteklemediğinden bu durum kafa karışıklığına neden oluyordu. Bu nedenle, hangi eş yordam diliminin neye bağlandığıyla ilgili belirsizlik nedeniyle oklar birbirine karışıyordu. Kullanım alanınız için önemli olduğunda tokenForManualPropagation() API'si ile yayılmayı manuel olarak etkinleştirebilirsiniz. (Ib2cf9)

Sürüm 2.0.0-alpha02

25 Şubat 2026

androidx.tracing:tracing-*:2.0.0-alpha02 yayınlandı. 2.0.0-alpha02 sürümü bu commit'leri içerir.

Yeni Özellikler

  • suspendCoroutineUninterceptedOrReturn iç fonksiyonu kullanılarak Perfetto Trace Sink uygulamasının performansı iyileştirildi (2ea97b).

Sürüm 2.0.0-alpha01

28 Ocak 2026

androidx.tracing:tracing-*:2.0.0-alpha01 yayınlandı. 2.0.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

AndroidX Tracing 2.0, Tracing 1.0'daki mevcut android.os.Tracing tabanlı API'leri tamamlayıcı nitelikte, düşük ek yük içeren ve işlem içi izleme için önemli bir yeni API yüzeyi sunar. Yeni API'ler hem Android'de hem de ana makine JVM'sinde kullanılabilir. Bu sayede ana makine araçları, aynı standart Perfetto izleme biçimini kullanarak performans analizi için düşük ek yüke sahip izlemeler yayınlayabilir.

Yayınlanan izler hem Android Studio hem de Perfetto tarafından desteklenir ve dilimleri meta verilerle (ör. işlev bağımsız değişkenleri) etiketleme ve eş yordam bağlam izi yayma gibi genişletilmiş bir özellik setiyle kaydedilebilir.

Bu ilk alfa sürümü yalnızca devam eden izleme iş akışları için tasarlanmıştır ve henüz Android OS izleme veya Studio Profiler System Tracing ile entegre edilmemiştir. Bu özellikler gelecekteki bir alfa sürümünde kullanıma sunulacaktır.

  /**
  * A [TraceSink] defines how traces are serialized.
  *
  * [androidx.tracing.wire.TraceSink] uses the `Perfetto` trace packet format.
  */
  fun createSink(): TraceSink {
      val outputDirectory = File(/* pathname = */ "/tmp/perfetto")
      // We are using the factory function defined in androidx.tracing.wire
      return TraceSink(
          sequenceId = 1,
          directory = outputDirectory
      )
  }

  /**
  * Creates a new instance of [androidx.tracing.TraceDriver].
  */
  fun createTraceDriver(): TraceDriver {
      // We are using a factory function from androidx.tracing.wire here.
      // `isEnabled` controls whether tracing is enabled for the application.
      val driver = TraceDriver(sink = createSink(), isEnabled = true)
      return driver
  }

  fun main() {
      val driver = createTraceDriver()
      driver.use {
          driver.tracer.trace(category = CATEGORY_MAIN, name = "basic") {
              Thread.sleep(100L)
          }
      }
  }

API değişiklikleri

  • Tracer öğesini TraceDriver öğesinin bir özelliği yapın. (Iabd9b)
  • Manuel bağlam yayma desteği eklendi. (I899ff)
  • İzleme bölümüne çağrı yığını bilgileri ekleme özelliği eklendi. (If6a1b)
  • Yeni androidx.tracing API'lerini kullanıma sunma (I5102b)
  • Anlık etkinliklerin meta veri içermesine izin verin ve anlık etkinlikler ile sayaçlara sayaç ekleyin. (Ia2ed3)
  • @DelicateTracingApi ile ek açıklama eklenen API'nin yüzey alanını azaltın. Üst düzey API'de hiçbir şey @DelicateTracingApi kullanımını gerektirmemelidir. (I565e0)
  • PropagationToken'leri birleştirerek bağlam yayılımını basitleştirin. (Iab839)
  • androidx.benchmark'da BlackHole API'yi stabilize edin. (I2b67e, b/451749438)
  • İzleme bölümünü kök yayılma olarak açıklama özelliği eklendi. (Ic8365)
  • Geliştiricinin, yayma jetonları hakkında açıkça bilgi vermesine izin verin. (I06bb1)
  • MetadataHandleCloseable, EventMetadataCloseable olarak, MetadataHandle ise EventMetadata olarak yeniden adlandırıldı. Ayrıca, geliştiricinin kullanılacak yayma jetonunu açıkça belirtmesine olanak tanımak için Tracer.traceCoroutine işlevine isteğe bağlı bir CoroutinePropagationToken bağımsız değişkeni eklendi. (I219f7, b/454147392)
  • Geliştiricilere izleme konusunda çok daha fazla kontrol sağlayan yeni bir Tracer giriş noktası kullanıma sunuldu. (I24a7b)
  • SliceTrack içinde bağlam yayılımının nasıl gerçekleşeceğini kontrol etme özelliği eklendi. (Ieb8fc)
  • fillCount, PooledTracePacketArray içinde artık doğru şekilde geçici olarak işaretleniyor. (I75d2c)
  • MetadataEntry @DelicateTracingApi olarak işaretleyin. (I8c723)
  • TraceSink'nın, havuz tükendiğinde kayıp izleme etkinliklerini işleyebilme özelliği eklendi. (I3b374)
  • Koşullu olarak izleme etkinlikleri yayınlama özelliği ekleyin. (I621b4)
  • İzleme etkinliğine kategori ekleme özelliği ekleyin. (I449c2)
  • TraceEvent (PooledTracePacketArray) adlı katılımcıyı DelicateTracingApi olarak işaretle. (Iaac6d)
  • ProcessTrack.id, ThreadTrack.id, ThreadTrack.name, CounterTrack.name ve CounterTrack.parent herkese açık hale getirildi. (I81210)
  • SliceTrack.traceFlow() API'si traceCoroutine() olarak yeniden adlandırıldı. (I79ad0)
  • Perfetto izindeki hata ayıklama ek açıklamaları aracılığıyla dilimlere bağlamsal bilgi ekleme özelliği eklendi. (Ic2b56)
  • WireTraceSink örneğinin File / OutputStream ile oluşturulmasını sağlar. (Iecea0)
  • Eski @RequiresApi(21) ek açıklamaları kaldırılıyor (Ic4792)

Sürüm 1.3

Sürüm 1.3.0

23 Nisan 2025

androidx.tracing:tracing:1.3.0, androidx.tracing:tracing-android:1.3.0 ve androidx.tracing:tracing-ktx:1.3.0 yayınlandı. 1.3.0 sürümü bu commit'leri içerir.

1.2.0 sürümünden sonra yapılan önemli değişiklikler

  • androidx.tracing.Trace sınıfı Kotlin'e dönüştürüldü ve tracing-ktx modülündeki tüm kodlar tracing modülüne taşındı.
  • @Composable içinde kullanılmasına izin vermek için izden crossinline'ı kaldırın. (I53882, b/248344805)

Sürüm 1.3.0-rc01

9 Nisan 2025

androidx.tracing:tracing:1.3.0-rc01, androidx.tracing:tracing-android:1.3.0-rc01 ve androidx.tracing:tracing-ktx:1.3.0-rc01, son beta sürümünden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.3.0-rc01 sürümü bu kayıtları içerir.

Sürüm 1.3.0-beta01

12 Şubat 2025

androidx.tracing:tracing:1.3.0-beta01, androidx.tracing:tracing-android:1.3.0-beta01 ve androidx.tracing:tracing-ktx:1.3.0-beta01 yayınlandı. 1.3.0-beta01 sürümü bu commit'leri içerir.

API değişiklikleri

  • tracing-ktx modülündeki tüm kodlar tracing modülüne taşındı. (Iba550)
  • androidx.tracing.Trace sınıfı Kotlin'e dönüştürüldü. (Ie4e5d)

Hata düzeltmeleri

  • AGP 7.3 veya sonraki sürümlerle (ör. R8 sürüm 3.3) R8 kullanıldığında ve AGP 8.1 veya sonraki sürümlerle (ör. D8 sürüm 8.1) tüm derlemeler için API modelleme aracılığıyla otomatik olarak gerçekleştiğinden yeni platform API'lerine erişimin manuel olarak özetlenmesi kaldırıldı. AGP kullanmayan müşterilerin D8'in 8.1 veya sonraki bir sürümüne güncellemeleri önerilir. Daha fazla bilgi için bu makaleye göz atın. (Ia60e0, b/345472586)

Sürüm 1.3.0-alpha02

21 Haziran 2023

androidx.tracing:tracing:1.3.0-alpha02 ve androidx.tracing:tracing-ktx:1.3.0-alpha02, önceki alfa sürümüne göre herhangi bir değişiklik yapılmadan yayınlanır. 1.3.0-alpha02 sürümü şu commit'leri içerir.

Sürüm 1.3.0-alpha01

7 Haziran 2023

androidx.tracing:tracing:1.3.0-alpha01 ve androidx.tracing:tracing-ktx:1.3.0-alpha01 yayınlandı. 1.3.0-alpha01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • @Composable içinde kullanılmasına izin vermek için izden crossinline'ı kaldırın. (I53882, b/248344805)

Sürüm 1.2

Sürüm 1.2.0

29 Kasım 2023

androidx.tracing:tracing:1.2.0 ve androidx.tracing:tracing-ktx:1.2.0 yayınlandı. 1.2.0 sürümü şu commit'leri içerir.

1.1.0 sürümünden sonra yapılan önemli değişiklikler

  • Geç yüklenen dize ve çerez hesaplamasıyla trace() ve traceAsync() varyantlarını ekleyin. Ayrıca, Trace.begin hata verirse Trace.end artık doğru şekilde atlanıyor.

Sürüm 1.2.0-rc01

24 Mayıs 2023

androidx.tracing:tracing:1.2.0-rc01 ve androidx.tracing:tracing-ktx:1.2.0-rc01 yayınlandı. 1.2.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Uzun izleme bölümü adları otomatik olarak kısaltılarak iletildiğinde kilitlenmelerin önlenmesi (Iaf6e2)

Sürüm 1.2.0-beta04

3 Mayıs 2023

androidx.tracing:tracing:1.2.0-beta04 ve androidx.tracing:tracing-ktx:1.2.0-beta04, değişiklik yapılmadan yayınlanır. 1.2.0-beta04 sürümü şu commit'leri içerir.

Sürüm 1.2.0-beta03

5 Nisan 2023

androidx.tracing:tracing:1.2.0-beta03 ve androidx.tracing:tracing-ktx:1.2.0-beta03, yeni değişiklikler olmadan yayınlandı. 1.2.0-beta03 sürümü şu commit'leri içerir.

Sürüm 1.2.0-beta02

22 Mart 2023

androidx.tracing:tracing:1.2.0-beta02 ve androidx.tracing:tracing-ktx:1.2.0-beta02, önceki beta sürümünden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.2.0-beta02 sürümü şu commit'leri içerir.

Sürüm 1.2.0-beta01

8 Mart 2023

androidx.tracing:tracing:1.2.0-beta01 ve androidx.tracing:tracing-ktx:1.2.0-beta01, son alfa sürümünden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.2.0-beta01 sürümü bu kayıtları içerir.

Sürüm 1.2.0-alpha02

23 Şubat 2023

androidx.tracing:tracing:1.2.0-alpha02 ve androidx.tracing:tracing-ktx:1.2.0-alpha02, önceki alfa sürümüne kıyasla herhangi bir değişiklik yapılmadan yayınlanır. 1.2.0-alpha02 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Bu sürüm, androidx.tracing: tracing-perfetto-common:1.0.0-alpha11 sürümüne yükseltme yaparken karşılaşılan Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 hatasını düzeltir.

Sürüm 1.2.0-alpha01

5 Ekim 2022

androidx.tracing:tracing:1.2.0-alpha01 ve androidx.tracing:tracing-ktx:1.2.0-alpha01 yayınlandı. 1.2.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Yavaş dize ve çerez hesaplamasıyla trace() ve traceAsync() varyantları ekleyin. Ayrıca, Trace.begin hata verirse Trace.end artık doğru şekilde atlanır. (I31421, b/175233952, b/247066503)

Sürüm 1.1

Sürüm 1.1.0

11 Mayıs 2022

androidx.tracing:tracing:1.1.0 ve androidx.tracing:tracing-ktx:1.1.0 yayınlandı. 1.1.0 sürümü şu commit'leri içerir.

1.0.0 sürümünden bu yana yapılan önemli değişiklikler

  • Hata ayıklanamayan derlemelerde uygulama izleme bölümü yakalamayı (ör. android.os.Trace / androidx.tracing API'leri) zorunlu olarak etkinleştirmek için Trace.forceEnableAppTracing() bir API eklendi. API 29'da profileable manifest etiketinin kullanıma sunulmasından önce hata ayıklanamayan doğru sistem izlemeyi etkinleştirmek için bunu başlangıçta çağırın. (I3a309)
  • Trace.java ilk kez yüklendiğinde sınıf doğrulama hatalarını önleme (05f6b4 ve cb101f)

Sürüm 1.1.0-rc01

20 Nisan 2022

androidx.tracing:tracing:1.1.0-rc01 ve androidx.tracing:tracing-ktx:1.1.0-rc01, beta01 tarihinden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.1.0-rc01 sürümü şu commit'leri içerir.

Sürüm 1.1.0-beta01

1 Aralık 2021

androidx.tracing:tracing:1.1.0-beta01 ve androidx.tracing:tracing-ktx:1.1.0-beta01 yayınlandı. 1.1.0-beta01 sürümü şu commit'leri içerir.

1.1.0-alpha02 tarihinden bu yana değişiklik yok.

Sürüm 1.1.0-alpha02

17 Kasım 2021

androidx.tracing:tracing:1.1.0-alpha02 ve androidx.tracing:tracing-ktx:1.1.0-alpha02 yayınlandı. 1.1.0-alpha02 sürümü şu commit'leri içerir.

Yeni özellikler

  • Hata ayıklanamayan derlemelerde uygulama izleme bölümü yakalamayı (ör. android.os.Trace / andoridx.tracing API'leri) zorunlu olarak etkinleştirmek için Trace.forceEnableAppTracing() API'si eklendi. API 29'da profillenebilir manifest etiketi kullanıma sunulmadan önce hata ayıklanamayan doğru sistem izlemeyi etkinleştirmek için bunu başlangıçta çağırın. (I3a309)

Sürüm 1.1.0-alpha01

3 Kasım 2021

androidx.tracing:tracing:1.1.0-alpha01 ve androidx.tracing:tracing-ktx:1.1.0-alpha01 yayınlandı. 1.1.0-alpha01 sürümü bu commit'leri içerir.

Hata düzeltmeleri

  • Trace.java ilk kez yüklendiğinde sınıf doğrulama hatalarını önleme (05f6b4 ve cb101f)

Sürüm 1.0

Sürüm 1.0.0

28 Ekim 2020

androidx.tracing:tracing:1.0.0 ve androidx.tracing:tracing-ktx:1.0.0 yayınlandı. 1.0.0 sürümü şu commit'leri içerir.

1.0.0 sürümünün önemli özellikleri

İzleme etkinliklerinin sistem izleme arabelleğine yazılmasına yardımcı olur. Bu durum, Systrace ve Perfetto gibi araçlar kullanılarak görselleştirilebilir. Bu kitaplık, kullanımdan kaldırılan androidx.core.os.TraceCompat sınıfının yerini almıştır.

Sürüm 1.0.0-rc01

14 Ekim 2020

androidx.tracing:tracing:1.0.0-rc01 ve androidx.tracing:tracing-ktx:1.0.0-rc01 yayınlandı. 1.0.0-rc01 sürümü bu commit'leri içerir.

Bu sürüm, 1.0.0-beta01 ile aynı.

Sürüm 1.0.0-beta01

24 Haziran 2020

androidx.tracing:tracing:1.0.0-beta01 ve androidx.tracing:tracing-ktx:1.0.0-beta01, 1.0.0-alpha01 tarihinden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha01

10 Haziran 2020

androidx.tracing:tracing:1.0.0-alpha01 ve androidx.tracing:tracing-ktx:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü şu commit'leri içerir.

Yeni özellikler

androidx.tracing, izleme etkinliklerini sistem izleme arabelleğine yazmaya yardımcı olan bir kitaplıktır. Bu durum, Systrace ve Perfetto gibi araçlar kullanılarak görselleştirilebilir. Bu kitaplık, desteği sonlandırılan androidx.core.os.TraceCompat sınıfının yerini alır. Bu ilk sürüm 1.0.0-alpha01'dir.

Perfetto'yu izleme

Sürüm 1.0

Sürüm 1.0.1

19 Kasım 2025

androidx.tracing:tracing-perfetto:1.0.1, androidx.tracing:tracing-perfetto-binary:1.0.1 ve androidx.tracing:tracing-perfetto-handshake:1.0.1 yayınlandı. 1.0.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • 16 KB sayfa boyutları için destek (b7a7dd)
  • AGP 7.3 veya sonraki sürümlerle (ör. R8 sürüm 3.3) R8 kullanıldığında ve AGP 8.1 veya sonraki sürümlerle (ör. D8 sürüm 8.1) tüm derlemeler için API modelleme aracılığıyla otomatik olarak gerçekleştiğinden yeni platform API'lerine erişimin manuel olarak ana hatlarıyla belirtilmesi kaldırıldı. AGP kullanmayan müşterilerin D8'in 8.1 veya sonraki bir sürümüne güncellemeleri önerilir. Daha fazla bilgi için bu makaleye göz atın. (Ia60e0, b/345472586)
  • Kitaplıkta FastNative/CriticalNative kopyalarını paketlemekten kaçının ve kararlı platform kopyalarını kullanın. (I8238a, b/35664282, b/280878596)

Sürüm 1.0.0

4 Ekim 2023

androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0 ve androidx.tracing:tracing-perfetto-handshake:1.0.0 yayınlandı. 1.0.0 sürümü bu commit'leri içerir.

1.0.0 sürümünün önemli özellikleri

  • Bu, Tracing-perfetto kitaplıklarının ilk kararlı sürümüdür.

Sürüm 1.0.0-rc01

20 Eylül 2023

androidx.tracing:tracing-perfetto:1.0.0-rc01, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 ve androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01, son beta sürümünden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-rc01 sürümü şu commit'leri içerir.

Sürüm 1.0.0-beta03

30 Ağustos 2023

androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03 ve androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 yayınlandı. 1.0.0-beta03 sürümü şu commit'leri içerir:

  • androidx.benchmark sürümüyle eşleşecek şekilde sürüm artırıldı.

Sürüm 1.0.0-beta02

23 Ağustos 2023

androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02 ve androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 yayınlandı. 1.0.0-beta02 sürümü bu kayıtları içerir.

Yeni özellikler

  • Uygulama başlangıcında (baştan başlatma) izleme desteği etkinleştirildi.

Sürüm 1.0.0-beta01

18 Temmuz 2023

androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01 ve androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • androidx.tracing.perfetto.Trace, androidx.tracing.perfetto.PerfettoSdkTrace olarak yeniden adlandırıldı (I44af8)
  • Protokolde tutarlılık için "exit code" (çıkış kodu) sabitleri "result code" (sonuç kodu) olarak yeniden adlandırıldı (Id1d1e).
  • EnableTracingResponse, Response olarak yeniden adlandırıldı. (I56275)
  • Soğuk başlatma izlemeyi kalıcı modda etkinleştirme seçeneği eklendi. Soğuk başlatma izlemeyi (kalıcı veya kalıcı olmayan) temizlemek için bir işlev eklendi. (Iaa09d)
  • Perfetto SDK API'leri, android.os.Trace ile tutarlı hale getirildi. (I73ba0, b/282199917)
  • Gelecekteki kullanım alanlarının (ör. .so dosyasının doğrudan yüklenmesi) gerekirse API'ye kolayca eklenmesine olanak tanıyan LibrarySource için fabrika düzenine geçildi. (I128df)
  • enableTracingColdStart parametreleri enableTracingImmediate ile eşleştiriliyor (I54126)
  • enableTracingColdStart içinde killProcess bağımsız değişkeni kaldırıldı (I81c4d)

Sürüm 1.0.0-alpha17

21 Haziran 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha17, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17 ve androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17, önceki alfa sürümüne kıyasla herhangi bir değişiklik olmadan yayınlandı. 1.0.0-alpha17 sürümü şu commit'leri içerir.

Sürüm 1.0.0-alpha16

7 Haziran 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha16, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha16, önceki alfa sürümüne kıyasla herhangi bir değişiklik olmadan yayınlandı. 1.0.0-alpha16 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha15

3 Mayıs 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha15, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-alpha15 sürümü şu taahhütleri içerir:

Sürüm 1.0.0-alpha14

5 Nisan 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha14, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 yeni değişiklikler olmadan yayınlanır. 1.0.0-alpha14 sürümü şu commit'leri içerir.

Sürüm 1.0.0-alpha13

22 Mart 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha13, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha13, son sürümden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-alpha13 sürümü bu commit'leri içerir.

Sürüm 1.0.0-alpha12

8 Mart 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha12, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha12, önceki alfa sürümünden bu yana herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-alpha12 sürümü şu commit'leri içerir.

Sürüm 1.0.0-alpha11

22 Şubat 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha11, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 herhangi bir değişiklik yapılmadan yayınlandı. 1.0.0-alpha11 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha10

8 Şubat 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha10, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha10, herhangi bir değişiklik yapılmadan yayınlanır. 1.0.0-alpha10 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha09

10 Şubat 2023

androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü şu commit'leri içerir.

Yeni özellikler

  • Diğer androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 kitaplıklarının birlikte çalışmasına olanak tanıyan sürüm yükseltme sürümü.

11 Ocak 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha09 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha09, değişiklik yapılmadan yayınlandı. 1.0.0-alpha09 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha08

7 Aralık 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Dizelerin işlenme şekli optimize edilerek performans artırıldı.

Hata Düzeltmeleri

  • Sınıf kullanılıyorsa PerfettoNative yöntemlerinin budanmasını engelleyen bir ProGuard kuralı eklendi (izleme başlatıldığında ancak uygulamada izleme çağrıları bulunmadığında nadir görülen bir kilitlenme önlenir).

Sürüm 1.0.0-alpha07

9 Kasım 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü şu commit'leri içerir.

  • androidx.tracing:tracing-perfetto API'lerinin JNI ek yükü azaltıldı.

Sürüm 1.0.0-alpha06

24 Ekim 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü şu taahhütleri içerir:

  • Bu güncelleme herhangi bir değişiklik içermez. Yalnızca androidx.benchmark ile senkronize etmek için sürüm numarası güncellenir.

Sürüm 1.0.0-alpha05

5 Ekim 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha04

21 Eylül 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü şu commit'leri içerir.

Sürüm 1.0.0-alpha03

7 Eylül 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 yayınlandı.

Yeni Özellikler

  • 1.0.0-alpha02 sürümünde yeni özellik yoktur.

Sürüm 1.0.0-alpha02

24 Ağustos 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Perfetto hizmetinin başlatılmasıyla ilgili çeşitli iyileştirmeler
  • Özel bir çıkış kodu (RESULT_CODE_CANCELLED) eklenerek yanıt alınamayan durumların işlenmesi iyileştirildi.
  • Ayrıştırma hatalarının işlenmesi iyileştirildi.
  • Paketle iletişim kuramazsak sürümü bilemeyeceğimiz için EnableTracingResponse.requiredVersion null değer alabilir hale getirildi. (I5ba20)

Sürüm 1.0.0-alpha01

27 Temmuz 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01 ve androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü şu commit'leri içerir.

  • Not: Tüm androidx.tracing:tracing-perfetto* kitaplıkları başlangıçta yalnızca AndroidX kitaplıklarında dahili kullanım için tasarlanmıştır. Doğrudan bunlara bağımlı olmanız gerekmez.

Yeni özellikler

  • Tüm androidx.tracing:tracing-perfetto* kitaplıkları başlangıçta yalnızca AndroidX kitaplıklarında dahili kullanım için tasarlanmıştır ve bunlara doğrudan bağımlı olmanız gerekmez. Bu uygulama ayrıntılarını şeffaflık için belgelendiriyoruz.

  • androidx.tracing:tracing-perfetto, düşük ek yüke sahip Perfetto SDK'sını kullanarak izleme etkinlikleri yazmaya yardımcı olan bir kitaplıktır. Bu, Benchmark, Android Studio veya Perfetto kullanıcı arayüzünde kullanılabilir.

  • androidx.tracing:tracing-perfetto-binary, androidx.tracing:tracing-perfetto için gereken bir dizi ikili bağımlılıktır.

  • androidx.tracing:tracing-perfetto-common, androidx.tracing:tracing-perfetto'nun dahili bir bağımlılığıdır ve araçlar tarafından androidx.tracing:tracing-perfetto ile entegre olmak için kullanılabilir.