Tracing

  
Menulis peristiwa pelacakan ke buffering pelacakan sistem.
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
23 April 2025 1.3.0 - - -

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.3

Versi 1.3.0

23 April 2025

androidx.tracing:tracing:1.3.0, androidx.tracing:tracing-android:1.3.0, dan androidx.tracing:tracing-ktx:1.3.0 dirilis. Versi 1.3.0 berisi commit ini.

Perubahan penting sejak versi 1.2.0

  • Mengonversi class androidx.tracing.Trace ke Kotlin, dan memindahkan semua kode dari modul tracing-ktx ke tracing.
  • Menghapus crossinline dari rekaman aktivitas untuk mengizinkan penggunaan di @Composable. (I53882, b/248344805)

Versi 1.3.0-rc01

9 April 2025

androidx.tracing:tracing:1.3.0-rc01, androidx.tracing:tracing-android:1.3.0-rc01, dan androidx.tracing:tracing-ktx:1.3.0-rc01 dirilis tanpa perubahan sejak versi beta terakhir. Versi 1.3.0-rc01 berisi commit ini.

Versi 1.3.0-beta01

12 Februari 2025

androidx.tracing:tracing:1.3.0-beta01, androidx.tracing:tracing-android:1.3.0-beta01, dan androidx.tracing:tracing-ktx:1.3.0-beta01 dirilis. Versi 1.3.0-beta01 berisi commit ini.

Perubahan API

  • Memindahkan semua kode dari modul tracing-ktx ke tracing. (Iba550)
  • Class androidx.tracing.Trace telah dikonversi ke Kotlin. (Ie4e5d)

Perbaikan Bug

  • Menghapus garis besar manual akses ke API platform baru karena hal ini terjadi secara otomatis melalui pemodelan API saat menggunakan R8 dengan AGP 7.3 atau yang lebih baru (misalnya, R8 versi 3.3) dan untuk semua build saat menggunakan AGP 8.1 atau yang lebih baru (misalnya, D8 versi 8.1). Klien yang tidak menggunakan AGP disarankan untuk mengupdate ke D8 versi 8.1 atau yang lebih baru. Baca artikel ini untuk informasi selengkapnya. (Ia60e0, b/345472586)

Versi 1.3.0-alpha02

21 Juni 2023

androidx.tracing:tracing:1.3.0-alpha02 dan androidx.tracing:tracing-ktx:1.3.0-alpha02 dirilis tanpa perubahan dari versi alfa sebelumnya. Versi 1.3.0-alpha02 berisi commit ini.

Versi 1.3.0-alpha01

7 Juni 2023

androidx.tracing:tracing:1.3.0-alpha01 dan androidx.tracing:tracing-ktx:1.3.0-alpha01 dirilis. Versi 1.3.0-alpha01 berisi commit ini.

Perubahan API

  • Menghapus crossinline dari rekaman aktivitas untuk mengizinkan penggunaan di @Composable. (I53882, b/248344805)

Versi 1.2

Versi 1.2.0

29 November 2023

androidx.tracing:tracing:1.2.0 dan androidx.tracing:tracing-ktx:1.2.0 dirilis. Versi 1.2.0 berisi commit ini.

Perubahan penting sejak 1.1.0

  • Menambahkan varian trace() dan traceAsync() dengan string lambat dan komputasi cookie. Sekarang juga akan melewati Trace.end dengan benar jika Trace.begin ditampilkan.

Versi 1.2.0-rc01

24 Mei 2023

androidx.tracing:tracing:1.2.0-rc01 dan androidx.tracing:tracing-ktx:1.2.0-rc01 dirilis. Versi 1.2.0-rc01 berisi commit ini.

Perbaikan Bug

  • Mencegah error saat nama bagian rekaman aktivitas yang panjang diteruskan dengan memotong secara otomatis (Iaf6e2)

Versi 1.2.0-beta04

3 Mei 2023

androidx.tracing:tracing:1.2.0-beta04 dan androidx.tracing:tracing-ktx:1.2.0-beta04 dirilis tanpa perubahan. Versi 1.2.0-beta04 berisi commit ini.

Versi 1.2.0-beta03

5 April 2023

androidx.tracing:tracing:1.2.0-beta03 dan androidx.tracing:tracing-ktx:1.2.0-beta03 dirilis tanpa perubahan baru. Versi 1.2.0-beta03 berisi commit ini.

Versi 1.2.0-beta02

22 Maret 2023

androidx.tracing:tracing:1.2.0-beta02 dan androidx.tracing:tracing-ktx:1.2.0-beta02 dirilis tanpa perubahan sejak versi beta sebelumnya. Versi 1.2.0-beta02 berisi commit ini.

Versi 1.2.0-beta01

8 Maret 2023

androidx.tracing:tracing:1.2.0-beta01 dan androidx.tracing:tracing-ktx:1.2.0-beta01 dirilis tanpa perubahan sejak versi alfa terakhir. Versi 1.2.0-beta01 berisi commit ini.

Versi 1.2.0-alpha02

23 Februari 2023

androidx.tracing:tracing:1.2.0-alpha02 dan androidx.tracing:tracing-ktx:1.2.0-alpha02 dirilis tanpa perubahan dari versi alfa sebelumnya. Versi 1.2.0-alpha02 berisi commit ini.

Perbaikan Bug

  • Rilis ini akan memperbaiki error Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 saat mengupgrade ke androidx.tracing: tracing-perfetto-common:1.0.0-alpha11

Versi 1.2.0-alpha01

5 Oktober 2022

androidx.tracing:tracing:1.2.0-alpha01 dan androidx.tracing:tracing-ktx:1.2.0-alpha01 dirilis. Versi 1.2.0-alpha01 berisi commit ini.

Fitur Baru

  • Menambahkan varian trace() dan traceAsync() dengan string lambat dan komputasi cookie. Sekarang juga akan melewati Trace.end dengan benar jika Trace.begin ditampilkan. (I31421, b/175233952, b/247066503)

Tracing Versi 1.1

Versi 1.1.0

11 Mei 2022

androidx.tracing:tracing:1.1.0 dan androidx.tracing:tracing-ktx:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Perubahan penting sejak versi 1.0.0

  • Menambahkan API Trace.forceEnableAppTracing() untuk mengaktifkan pengambilan bagian rekaman aktivitas aplikasi (yaitu android.os.Trace/androidx.tracing API) di build yang tidak dapat di-debug. Panggil ini di awal startup untuk mengaktifkan pelacakan sistem yang tidak dapat di-debug secara akurat sebelum pengenalan tag manifes yang dapat dibuat profil di API 29. (I3a309)
  • Menghindari error verifikasi class saat Trace.java dimuat untuk pertama kalinya (05f6b4 dan cb101f)

Versi 1.1.0-rc01

20 April 2022

androidx.tracing:tracing:1.1.0-rc01 dan androidx.tracing:tracing-ktx:1.1.0-rc01 dirilis, tanpa perubahan sejak beta01. Versi 1.1.0-rc01 berisi commit ini.

Versi 1.1.0-beta01

1 Desember 2021

androidx.tracing:tracing:1.1.0-beta01 dan androidx.tracing:tracing-ktx:1.1.0-beta01 dirilis. Versi 1.1.0-beta01 berisi commit ini.

Tidak ada perubahan sejak versi 1.1.0-alpha02.

Versi 1.1.0-alpha02

17 November 2021

androidx.tracing:tracing:1.1.0-alpha02 dan androidx.tracing:tracing-ktx:1.1.0-alpha02 dirilis. Versi 1.1.0-alpha02 berisi commit ini.

Fitur Baru

  • Menambahkan API ke Trace.forceEnableAppTracing() untuk mengaktifkan paksa pengambilan bagian rekaman aktivitas aplikasi (yaitu android.os.Trace API/andoridx.tracing API) di build yang tidak dapat di-debug. Panggil ini di awal startup untuk mengaktifkan pelacakan sistem yang tidak dapat di-debug secara akurat sebelum pengenalan tag manifes yang dapat dibuat profil di API 29. (I3a309)

Versi 1.1.0-alpha01

3 November 2021

androidx.tracing:tracing:1.1.0-alpha01 dan androidx.tracing:tracing-ktx:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Perbaikan Bug

  • Menghindari error verifikasi class saat Trace.java dimuat untuk pertama kalinya (05f6b4 dan cb101f)

Tracing Perfetto Versi 1.0.0

Versi 1.0.0

4 Oktober 2023

androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0, dan androidx.tracing:tracing-perfetto-handshake:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

  • Ini adalah rilis stabil pertama library Tracing-perfetto.

Versi 1.0.0-rc01

20 September 2023

androidx.tracing:tracing-perfetto:1.0.0-rc01, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01, dan androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 dirilis tanpa perubahan sejak versi beta terakhir. Versi 1.0.0-rc01 berisi commit ini.

Versi 1.0.0-beta03

30 Agustus 2023

androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03, dan androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 dirilis. Versi 1.0.0-beta03 berisi commit ini.

  • Penambahan versi agar cocok dengan rilis androidx.benchmark.

Versi 1.0.0-beta02

23 Agustus 2023

androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02, dan androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 dirilis. Versi 1.0.0-beta02 berisi commit ini.

Fitur Baru

  • Mengaktifkan dukungan untuk pelacakan saat aplikasi dimulai (cold start).

Versi 1.0.0-beta01

18 Juli 2023

androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01, dan androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

  • Mengganti nama androidx.tracing.perfetto.Trace menjadi androidx.tracing.perfetto.PerfettoSdkTrace (I44af8)
  • Mengganti nama konstanta "kode keluar" menjadi "kode hasil" dalam protokol untuk konsistensi (Id1d1e)
  • Mengganti nama EnableTracingResponse menjadi Response. (I56275)
  • Menambahkan opsi untuk mengaktifkan pelacakan cold start dalam mode persisten. Menambahkan fungsi untuk menghapus pelacakan cold start (persisten atau tidak). (Iaa09d)
  • Membuat API Perfetto SDK Pelacakan konsisten dengan android.os.Trace. (I73ba0, b/282199917)
  • Dipindahkan ke pola factory untuk LibrarySource yang memungkinkan kasus penggunaan di masa mendatang (misalnya, memuat file .so secara langsung) untuk ditambahkan dengan mudah ke API jika diperlukan. (I128df)
  • Membuat parameter enableTracingColdStart cocok dengan enableTracingImmediate (I54126)
  • Menghapus argumen killProcess di enableTracingColdStart (I81c4d)

Versi 1.0.0-alpha17

21 Juni 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha17, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17, dan androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 dirilis tanpa perubahan dari versi alfa sebelumnya. Versi 1.0.0-alpha17 berisi commit ini.

Versi 1.0.0-alpha16

7 Juni 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha16, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 dirilis tanpa perubahan dari versi alfa sebelumnya. Versi 1.0.0-alpha16 berisi commit ini.

Versi 1.0.0-alpha15

3 Mei 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha15, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 dirilis tanpa perubahan. Versi 1.0.0-alpha15 berisi commit ini.

Versi 1.0.0-alpha14

5 April 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha14, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 dirilis tanpa perubahan baru. Versi 1.0.0-alpha14 berisi commit ini.

Versi 1.0.0-alpha13

22 Maret 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha13, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 dirilis tanpa perubahan sejak rilis terakhir. Versi 1.0.0-alpha13 berisi commit ini.

Versi 1.0.0-alpha12

8 Maret 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha12, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 dirilis tanpa perubahan sejak versi alfa sebelumnya. Versi 1.0.0-alpha12 berisi commit ini.

Versi 1.0.0-alpha11

22 Februari 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha11, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 dirilis tanpa perubahan. Versi 1.0.0-alpha11 berisi commit ini.

Versi 1.0.0-alpha10

8 Februari 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha10, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 dirilis tanpa perubahan. Versi 1.0.0-alpha10 berisi commit ini.

Versi 1.0.0-alpha09

10 Februari 2023

androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.

Fitur Baru

  • Rilis penambahan nomor versi untuk memungkinkan library androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 lainnya digunakan bersama.

11 Januari 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha09 dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 dirilis tanpa perubahan. Versi 1.0.0-alpha09 berisi commit ini.

Versi 1.0.0-alpha08

7 Desember 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit berikut ini.

Fitur Baru

  • Meningkatkan performa dengan mengoptimalkan cara penanganan string.

Perbaikan Bug

  • Menambahkan aturan proguard yang mencegah metode PerfettoNative di-pruning jika class digunakan sepenuhnya (mencegah error dalam kasus khusus saat pelacakan diinisialisasi, tetapi tidak ada panggilan pelacakan di aplikasi).

Versi 1.0.0-alpha07

9 November 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

  • Mengurangi overhead JNI androidx.tracing:tracing-perfetto API.

Versi 1.0.0-alpha06

24 Oktober 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

  • Update ini tidak menyertakan perubahan, hanya mengupdate nomor versi untuk disinkronkan dengan androidx.benchmark.

Versi 1.0.0-alpha05

5 Oktober 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit berikut ini.

Versi 1.0.0-alpha04

21 September 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Versi 1.0.0-alpha03

7 September 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 dirilis.

Fitur Baru

  • Tidak ada fitur baru dari versi 1.0.0-alpha02.

Versi 1.0.0-alpha02

24 Agustus 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit berikut.

Perbaikan Bug

  • Beberapa peningkatan pada inisialisasi layanan Perfetto
  • Peningkatan penanganan kasus tanpa respons dengan memperkenalkan kode keluar khusus: RESULT_CODE_CANCELLED.
  • Peningkatan penanganan error penguraian.
  • Membuat nullable EnableTracingResponse.requiredVersion, karena kita tidak dapat mengetahui versi jika kita tidak dapat berkomunikasi dengan paket. (I5ba20)

Versi 1.0.0-alpha01

27 Juli 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01, dan androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

  • Catatan: Semua library androidx.tracing:tracing-perfetto* awalnya hanya dimaksudkan untuk penggunaan internal di dalam library AndroidX. Anda tidak perlu bergantung padanya secara langsung.

Fitur Baru

  • Semua library androidx.tracing:tracing-perfetto* awalnya hanya dimaksudkan untuk penggunaan internal di dalam library AndroidX dan Anda tidak perlu bergantung padanya secara langsung. Kami mendokumentasikan detail implementasi ini untuk transparansi.

  • androidx.tracing:tracing-perfetto adalah library yang memudahkan penulisan peristiwa pelacakan menggunakan Perfetto SDK dengan overhead rendah. Ini dapat digunakan di dalam UI Benchmark, Android Studio, atau Perfetto.

  • androidx.tracing:tracing-perfetto-binary adalah serangkaian dependensi biner yang diperlukan untuk androidx.tracing:tracing-perfetto.

  • androidx.tracing:tracing-perfetto-common adalah dependensi internal androidx.tracing:tracing-perfetto dan dapat digunakan oleh alat untuk berintegrasi dengan androidx.tracing:tracing-perfetto.

Tracing Versi 1.0.0

Versi 1.0.0

28 Oktober 2020

androidx.tracing:tracing:1.0.0 dan androidx.tracing:tracing-ktx:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

Membantu menulis peristiwa pelacakan ke buffering pelacakan sistem. Library ini dapat divisualisasikan menggunakan alat seperti Systrace dan Perfetto. Library ini menggantikan class androidx.core.os.TraceCompat yang sudah tidak digunakan lagi.

Versi 1.0.0-rc01

14 Oktober 2020

androidx.tracing:tracing:1.0.0-rc01 dan androidx.tracing:tracing-ktx:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit ini.

Rilis ini sama persis dengan 1.0.0-beta01.

Versi 1.0.0-beta01

24 Juni 2020

androidx.tracing:tracing:1.0.0-beta01 dan androidx.tracing:tracing-ktx:1.0.0-beta01 dirilis tanpa perubahan sejak 1.0.0-alpha01. Versi 1.0.0-beta01 berisi commit ini.

Versi 1.0.0-alpha01

10 Juni 2020

androidx.tracing:tracing:1.0.0-alpha01 dan androidx.tracing:tracing-ktx:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

androidx.tracing adalah library yang memudahkan menulis peristiwa pelacakan ke buffer pelacakan sistem. Library ini dapat divisualisasikan menggunakan alat seperti Systrace dan Perfetto. Library ini menggantikan class androidx.core.os.TraceCompat yang tidak digunakan lagi. Rilis awal ini adalah 1.0.0-alpha01.