İzleme
| 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.
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
EmptyCoroutineContextkullanı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.TraceAPI'si vetrace() {}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
PerfettoCapturevePerfettoTraceRuleartık işlem içi izleri yakalayabilir ve bunları hedef paket için birleştirebilir. (I9a00b, b/497959820)androidx.benchmarkartık 24minSdkdeğ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(...)vewriteInstant(...)arasındaki belirsizliği gidermek içinTracersü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)
TraceSinkiçindeBufferedSinkveProtoWriteroluşturma işlemini erteleyin. (Ibd098)- Java ve Android kitaplıkları için
Tracerkeş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.recordExceptiondosyasınıTracer.recordExceptionAndThrowolarak 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/traceCoroutineiçinde birblock()istisna oluşturduğunda, ilgili yığın izleme öğelerini temsil eden meta verilerle istisna için birinstantetkinliği oluşturun. (I682e5, b/501536851, b/437166283) - Java
Longtürünü alan birsetCounter(...)aşırı yüklemesi ekleyin. (Ic0469, b/356082604) - Tracing 2.0 artık platforma özgü
Threadtanımlayıcıları içinLongkullanıyor. (I67277)
Hata Düzeltmeleri
AttributeEntry.reset()ile ilgili dokümanları iyileştirme (I5d3a1, b/496079439)
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
TraceSinkfabrika işlevleri artıkAbstractTraceSinkyerineTraceSinkdö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
TraceDriveroluş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
AbstractTraceDriversınıfını tamamen soyut hale getirin vePerfettouygulamasınıtracing-wiremodü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ıkAbstractTrace{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
InMemoryRingBufferTraceSinkuygulaması 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.tracingartık varsayılan olarak izlerde üst eş yordamdan alt eş yordama bağlantı oluşturmaya çalışmaz. Temel izleme biçimi1:NveN:1bağ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ğundatokenForManualPropagation()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
suspendCoroutineUninterceptedOrReturniç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öğesiniTraceDriveröğ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.tracingAPI'lerini kullanıma sunma (I5102b) - Anlık etkinliklerin meta veri içermesine izin verin ve anlık etkinlikler ile sayaçlara sayaç ekleyin. (Ia2ed3)
@DelicateTracingApiile ek açıklama eklenen API'nin yüzey alanını azaltın. Üst düzey API'de@DelicateTracingApikullanı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'daBlackHoleAPI'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,EventMetadataCloseableolarak veMetadataHandle,EventMetadataolarak yeniden adlandırıldı. Ayrıca, geliştiricinin kullanılacak yayılma jetonunu açıkça belirtmesine olanak tanımak içinTracer.traceCoroutineişlevine isteğe bağlı birCoroutinePropagationTokenbağımsız değişkeni eklendi. (I219f7, b/454147392)- Geliştiricilere izleme konusunda çok daha fazla kontrol sağlayan yeni bir
Tracergiriş noktası kullanıma sunuldu. (I24a7b) SliceTrackiç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@DelicateTracingApiolarak işaretle. (I8c723)TraceSinkiç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ıDelicateTracingApiolarak işaretle. (Iaac6d)ProcessTrack.id,ThreadTrack.id,ThreadTrack.name,CounterTrack.nameveCounterTrack.parentherkese açık hale getirildi. (I81210)SliceTrack.traceFlow()API'sitraceCoroutine()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/OutputStreamile birWireTraceSinkö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.Tracesınıfı Kotlin'e dönüştürüldü vetracing-ktxmodülündeki tüm kodlartracingmodülüne taşındı.@Composableiç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-ktxmodülündeki tüm kodlartracingmodülüne taşındı. (Iba550)androidx.tracing.Tracesı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
@Composableiç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()vetraceAsync()varyantları ekleyin. Ayrıca,Trace.beginhata verirseTrace.endartı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-alpha11sürümüne yükseltme yaparken karşılaşılanCould not find androidx.tracing:tracing-ktx:1.2.0-alpha02hatası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()vetraceAsync()varyantları ekleyin. Ayrıca,Trace.beginhata verirseTrace.endartı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
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/CriticalNativekopyaları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.PerfettoSdkTraceolarak yeniden adlandırıldı (I44af8)- Tutarlılık için protokoldeki "çıkış kodu" sabitleri "sonuç kodu" olarak yeniden adlandırıldı (Id1d1e)
EnableTracingResponse,Responseolarak 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.Traceile tutarlı hale getirildi. (I73ba0, b/282199917) LibrarySourceiçin fabrika kalıbına geçildi.Böylece, gelecekteki kullanım alanları (ör..sodosyasını doğrudan yükleme) gerektiğinde API'ye kolayca eklenebilecek. (I128df)enableTracingColdStartparametrelerienableTracingImmediateile eşleştiriliyor (I54126)enableTracingColdStartiçindekillProcessbağı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-alpha09kitaplı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
PerfettoNativeyö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-perfettoAPI'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.requiredVersionnull 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.