İzleme

İzleme etkinliklerini sistem izleme arabelleğine yazın veya düşük ek yük içeren işlem içi izleri yakalayın.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
21 Ekim 2026 2.0.5 - - -

Bağımlılıkları bildirme

İzleme'ye bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu başlıklı makaleyi okuyun.

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

Eski

dependencies {
    def tracing_version = "2.0.5"

    // Core tracing API (for libraries and apps to emit trace events)
    implementation "androidx.tracing:tracing:$tracing_version"
    // In-process tracing backend and Perfetto sink (for apps)
    implementation "androidx.tracing:tracing-wire:$tracing_version"
    // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0)
    implementation "androidx.tracing:tracing-ktx:$tracing_version"
}

Kotlin

dependencies {
    val tracing_version = "2.0.5"

    // Core tracing API (for libraries and apps to emit trace events)
    implementation("androidx.tracing:tracing:$tracing_version")
    // In-process tracing backend and Perfetto sink (for apps)
    implementation("androidx.tracing:tracing-wire:$tracing_version")
    // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0)
    implementation("androidx.tracing:tracing-ktx:$tracing_version")
}

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 bildirimleriniz Jetpack'i geliştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa 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 sorun için oy verebilirsiniz.

Yeni bir sorun oluşturma

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

İzleme

Sürüm 2.0

Sürüm 2.0.5

21 Ekim 2026

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

Hata Düzeltmeleri

  • Havuz yönetiminde, aynı iş parçacığının paketleri eşzamanlı olarak temizleyip serbest bırakabildiği ve özellikle EmptyCoroutineContext kullanırken kilitlenmelere neden olabilen bir yarışma durumu düzeltildi. (Ia0aef48c, b/570135466)

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ışma 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:

  • İzleme içeriğini işlem sırasında, sahada kaydetme
  • Perfetto akışları (bir dilimden diğerine giden oklar)
  • Perfetto ek açıklamaları (anahtar/değer dilimi 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ına kıyasla ö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.
  • Olaydan sonra sistem izleme kaydıyla birleştirme (AndroidX Benchmark 1.5'te varsayılan olarak uygulanır)

Yeni izleme API'lerinin, henüz Studio sistem izleme kaydı tarafından yakalanmayan, işlem 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 kayıtları içerir.

API Değişiklikleri

  • instant(...) ve writeInstant(...) arasındaki belirsizliği gidermek için Tracer sürümünde 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)
  • Java ve Android kitaplıkları için Tracer keşfini 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 kayıtları 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 dosyasını 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 stub 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'sının (tracing-perfetto) etkinleştirilebilmesini sağlayan bir saklama kuralı düzeltildi. (I1d227)
  • flush() etkinliklerini izleme özelliği ekleyin. (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. trace / traceCoroutine içinde bir block() 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 kayıtları 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)
  • İzlemeyle ilgili meta veri ekleme yöntemi sunan bir TraceDriver oluştururken isteğe bağlı attributes() öğesini kullanın. (Ia147e)

Hata Düzeltmeleri

  • İşlem iş parçacıkları ve sayaç kanalları artık senkronize edilir. Bu işlem, ş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 havuz etkinlikleri yayınlanmaz.

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 sınıfını 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 oluşan yarışma durumu düzeltildi. (Ie145e)

Hata Düzeltmeleri

  • androidx.tracing artık varsayılan olarak izlerde üst eş yordamdan alt eş yordama bağlantı oluşturmaya çalışmaz. Temel izleme biçimi 1:N ve N:1 bağlantılarını desteklemediğinden bu durum kafa karıştırıcı olmuştur. Bu nedenle, hangi eş yordam diliminin neye bağlandığıyla ilgili belirsizlik nedeniyle bir ok yuvası oluşur. Kullanım alanınız için önemli olduğunda tokenForManualPropagation() API 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 kayıtları içerir.

Yeni özellikler

  • suspendCoroutineUninterceptedOrReturn içsel işlevi 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 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ük izleri 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 işlem içi izleme iş akışları için tasarlanmıştır ve henüz Android OS izleme veya Studio Profiler Sistem İzleme ile entegre değildir. Bu özellikler gelecekteki bir alfa sürümünde 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 ekleyin. (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 @DelicateTracingApi kullanımını gerektiren hiçbir şey olmamalıdır. (I565e0)
  • PropagationToken'leri birleştirerek bağlam yayılımını basitleştirin. (Iab839)
  • androidx.benchmark'da BlackHole API'leri stabilize edin. (I2b67e, b/451749438)
  • İzleme bölümüne kök aralık olarak ek açıklama ekleme özelliği ekleyin. (Ic8365)
  • Geliştiricinin yayılma jetonları hakkında açıkça bilgi vermesine izin verin. (I06bb1)
  • MetadataHandleCloseable, EventMetadataCloseable olarak ve MetadataHandle, EventMetadata olarak yeniden adlandırıldı. Ayrıca, geliştiricinin kullanılacak yayılma 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ştiğini kontrol etme özelliği eklendi. (Ieb8fc)
  • fillCount (PooledTracePacketArray) artık doğru şekilde geçici olarak işaretleniyor. (I75d2c)
  • MetadataEntry @DelicateTracingApi olarak işaretle. (I8c723)
  • TraceSink için kayıp izleme etkinliklerini (havuz tükendiğinde) işleme özelliği eklendi. (I3b374)
  • İzleme etkinliklerini bir yükleme dayalı olarak koşullu şekilde yayınlama özelliği ekleyin. (I621b4)
  • İzleme etkinliğine kategori ekleme özelliğini 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)
  • File/OutputStream ile bir WireTraceSink örneği oluşturmayı mümkün kılın. (Iecea0)
  • Eski @RequiresApi(21) ek açıklamalarını kaldırma (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 kayıtları 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'i 8.1 veya sonraki bir sürüme güncellemesi ö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 olmadan yayınlandı. 1.3.0-alpha02 sürümü bu kayıtları 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ü bu commit'leri içerir.

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

  • 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.

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 kilitlenmeleri önleme (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ü bu kayıtları 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ü bu kayıtları 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ü bu kayıtları 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 göre herhangi bir değişiklik olmadan yayınlandı. 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ü bu kayıtları 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ü bu commit'leri içerir.

1.0.0 sürümünden sonra 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 etiketi kullanıma sunulmadan önce hata ayıklanamayan doğru sistem izlemeyi etkinleştirmek için başlangıçta bunu ç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ü bu 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ü bu kayıtları 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ü bu kayıtları 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 başlatma işleminin başında bunu ç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ü bu 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, desteği sonlandırılan androidx.core.os.TraceCompat sınıfının yerini alı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 kayıtları 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 commit'leri 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ü bu kayıtları 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 boyutu desteği (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 özetlenmesi kaldırıldı. AGP kullanmayan müşterilerin D8'i 8.1 veya sonraki bir sürüme güncellemesi ö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ü bu kayıtları 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ü bu kayıtları içerir.

  • androidx.benchmark sürümüyle eşleşmesi için sürüm yükseltildi.

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şlatılırken (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 commit'leri içerir.

API Değişiklikleri

  • androidx.tracing.perfetto.Trace, androidx.tracing.perfetto.PerfettoSdkTrace olarak yeniden adlandırıldı (I44af8)
  • Tutarlılık için protokoldeki "çıkış kodu" sabitleri "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)
  • Tracing Perfetto SDK API'leri android.os.Trace ile tutarlı hale getirildi. (I73ba0, b/282199917)
  • LibrarySource için fabrika kalıbına geçildi.Böylece, gelecekteki kullanım alanları (ör. .so dosyasını doğrudan yükleme) gerektiğinde API'ye kolayca eklenebilecek. (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ü bu kayıtları 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ınlandı. 1.0.0-alpha14 sürümü bu kayıtları 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ü bu kayıtları 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ınlandı. 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ü bu kayıtları 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ınlanır. 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 taahhütleri 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ı önleyen bir proguard kuralı eklendi (izleme başlatıldığında ancak uygulamada izleme çağrısı olmadığında özel bir durumda kilitlenmeyi önler).

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ü bu kayıtları 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üncellemede herhangi bir değişiklik yoktur. Yalnızca androidx.benchmark ile senkronize etmek için sürüm numarası güncellenmiştir.

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ünden yeni özellik yok.

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 yapıldı.
  • Ö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ü bu kayıtları 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 onlara bağımlı olmanıza gerek yoktur.

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. Şeffaflık sağlamak amacıyla bu uygulama ayrıntılarını belgeliyoruz.

  • androidx.tracing:tracing-perfetto, düşük ek yük içeren Perfetto SDK'yı 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 androidx.tracing:tracing-perfetto ile entegrasyon için araçlar tarafından kullanılabilir.