Bergabunglah bersama kami di ⁠#Android11: The Beta Launch Show pada tanggal 3 Juni!

Mengambil pelacakan sistem di perangkat

Perangkat yang menjalankan Android 9 (API level 28) atau yang lebih baru menyertakan aplikasi tingkat sistem yang disebut Pelacakan Sistem. Aplikasi ini mirip dengan utilitas command line systrace, tetapi aplikasi ini memungkinkan Anda merekam pelacakan langsung dari perangkat pengujian itu sendiri, tanpa perlu mencolokkan perangkat dan menghubungkannya melalui ADB. Selanjutnya Anda dapat menggunakan aplikasi untuk berbagi hasil dari pelacakan ini dengan tim pengembangan Anda.

Aplikasi ini sangat berguna untuk merekam pelacakan saat menangani bug terkait performa pada aplikasi Anda, seperti startup lambat, transisi lambat, atau jank pada UI.

Merekam pelacakan sistem

Aplikasi Pelacakan Sistem ini memungkinkan Anda untuk merekam pelacakan sistem menggunakan tile Setelan Cepat atau menu pada aplikasi itu sendiri. Bagian berikut menjelaskan cara menyelesaikan proses perekaman menggunakan antarmuka ini.

Merekam menggunakan tile Setelan Cepat

Secara umum, tile Setelan Cepat merupakan cara yang lebih mudah untuk menyelesaikan proses pelacakan sistem pada perangkat.

Menyiapkan tile

Gambar 2. Tombol Tampilkan tile Setelan Cepat pada aplikasi Pelacakan Sistem

Jika menggunakan Pelacakan Sistem untuk pertama kalinya pada perangkat uji, atau jika Anda tidak melihat tile Pelacakan Sistem pada panel Setelan Cepat perangkat (Gambar 1), selesaikan langkah-langkah penyiapan berikut:

  1. Aktifkan opsi developer, jika Anda belum melakukannya.
  2. Buka layar setelan Opsi Developer.
  3. Di bagian Debugging, pilih Pelacakan Sistem. Aplikasi Pelacakan Sistem akan terbuka, menampilkan menu aplikasi.
  4. Dari menu aplikasi, aktifkan Tampilkan tile Setelan Cepat, seperti yang ditunjukkan pada Gambar 2. Sistem akan menambahkan tile Pelacakan Sistem ke panel Setelan Cepat, yang muncul pada Gambar 1:

    Gambar 1. Tile Pelacakan Sistem pada panel Setelan Cepat

    Catatan: Secara default, sistem akan menambahkan tile Pelacakan Sistem sebagai tile pertama pada panel Setelan Cepat. Jika ingin tile muncul di posisi yang berbeda, gunakan mode edit panel untuk memindahkan tile tersebut.

Menyelesaikan rekaman pelacakan sistem

Untuk merekam pelacakan sistem menggunakan panel Setelan Cepat, selesaikan langkah-langkah berikut:

  1. Ketuk tile Pelacakan Sistem, yang memiliki label "Rekam pelacakan". Tile tersebut aktif, dan notifikasi akan terus muncul untuk memberi tahu Anda bahwa sistem sekarang merekam aktivitas, seperti yang ditunjukkan pada Gambar 3:

    Notifikasi dengan pesan 'Pelacakan sedang direkam. Ketuk untuk menghentikan pelacakan.'
    Gambar 3. Notifikasi yang terus muncul setelah memulai pelacakan sistem di perangkat
  2. Lakukan tindakan di aplikasi yang Anda inginkan untuk diperiksa sistem.

  3. Setelah Anda menyelesaikan tindakan ini, hentikan pelacakan dengan mengetuk tile Pelacakan Sistem pada panel Setelan Cepat atau pada notifikasi Pelacakan Sistem.

    Sistem akan menampilkan notifikasi baru yang berisi pesan "Menyimpan pelacakan". Jika penyimpanan selesai, sistem akan menutup notifikasi dan menampilkan notifikasi ketiga, mengonfirmasi bahwa pelacakan berhasil disimpan dan Anda siap untuk membagikan pelacakan sistem, seperti yang ditunjukkan di Gambar 4:

    Notifikasi dengan pesan 'Pelacakan disimpan. Ketuk untuk membagikan pelacakan.'
    Gambar 4. Notifikasi yang terus muncul setelah sistem selesai menyimpan pelacakan

Merekam menggunakan menu aplikasi

Menu aplikasi memungkinkan Anda untuk mengonfigurasi beberapa setelan lanjutan yang terkait dengan pelacakan sistem dan menyediakan tombol untuk memulai dan menghentikan pelacakan sistem.

Untuk merekam pelacakan sistem menggunakan menu aplikasi Pelacakan Sistem, selesaikan langkah-langkah berikut:

  1. Aktifkan opsi developer, jika Anda belum melakukannya.
  2. Buka layar setelan Opsi Developer. Di bagian Proses debug, pilih Pelacakan Sistem. Aplikasi Pelacakan Sistem akan terbuka.

    Alternatifnya, jika telah menyiapkan tile Pelacakan Sistem, Anda dapat mengetuk lama tile untuk membuka aplikasi Pelacakan Sistem.

  3. Pastikan Aplikasi pelacakan yang dapat di-debug dipilih untuk menyertakan aplikasi yang telah mengaktifkan proses debug di pelacakan sistem.

  4. Secara opsional, pilih Kategori panggilan sensor dan sistem untuk merekam aktivitas, dan pilih Ukuran buffer per-CPU (dalam KB). Pilih kategori yang sesuai dengan kasus penggunaan yang Anda uji, seperti kategori Audio untuk menguji operasi Bluetooth atau kategori Memori untuk alokasi heap.

    Gambar 5. Tombol Rekam pelacakan di aplikasi Pelacakan Sistem
  5. Secara opsional, pilih Pelacakan panjang untuk mengaktifkan pelacakan yang disimpan terus-menerus di penyimpanan perangkat. Untuk menggunakan opsi ini, Anda harus menetapkan batas untuk Ukuran pelacakan panjang maksimum dan Durasi pelacakan panjang maksimum.

  6. Aktifkan tombol Rekam pelacakan, yang ditandai di Gambar 5. Tile aktif, dan notifikasi akan terus muncul guna memberi tahu Anda bahwa sistem sekarang merekam pelacakan (Gambar 3).

  7. Lakukan tindakan di aplikasi yang Anda inginkan untuk diperiksa sistem.

  8. Setelah menyelesaikan tindakan ini, hentikan pelacakan dengan menonaktifkan tombol Rekam pelacakan.

    Sistem akan menampilkan notifikasi baru yang berisi pesan "Menyimpan pelacakan". Jika penyimpanan selesai, sistem akan menutup notifikasi dan menampilkan notifikasi ketiga, mengonfirmasi bahwa pelacakan berhasil disimpan dan Anda siap untuk membagikan pelacakan sistem, seperti yang ditunjukkan di Gambar 4.

Membagikan pelacakan sistem

Aplikasi Pelacakan Sistem membantu Anda membagikan pelacakan sistem sebagai bagian dari beberapa alur kerja yang berbeda. Pada perangkat yang menjalankan Android 10 (API level 29) atau yang lebih lama, file pelacakan disimpan dengan ekstensi nama file .perfetto-trace dan dapat dibuka di Perfetto UI. Pada perangkat yang menjalankan versi Android yang lebih lama, file pelacakan disimpan dengan ekstensi nama file .ctrace, yang menunjukkan format Systrace.

Membagikan sebagai pesan

Pelacakan Sistem memungkinkan Anda untuk berbagi pelacakan yang dikumpulkan dengan aplikasi lain di perangkat. Dengan demikian, Anda dapat mengirim pelacakan ke tim pengembangan melalui email atau aplikasi pelacakan bug tanpa perlu menghubungkan perangkat ke mesin pengembangan.

Setelah Anda menangkap pelacakan sistem, ketuk notifikasi yang muncul di perangkat (lihat Gambar 4). Alat pilih intent platform akan muncul, memungkinkan Anda berbagi pelacakan menggunakan aplikasi pesan pilihan Anda.

Berbagi dari aplikasi File

Pada perangkat yang menjalankan Android 10 (API level 29), pelacakan ditampilkan di aplikasi File. Jika diinginkan, Anda dapat membagikan pelacakan dari aplikasi ini.

Mendownload laporan menggunakan ADB

Jika diinginkan, Anda juga dapat mengekstrak pelacakan sistem dari perangkat menggunakan ADB. Hubungkan perangkat yang merekam pelacakan ke mesin pengembangan Anda, kemudian jalankan perintah berikut di jendela terminal:

    cd /path-to-traces-on-my-dev-machine && \
      adb pull /data/local/traces/ .

Mengonversi antara format pelacakan

Anda bisa mengonversi file pelacakan Perfetto ke dalam format Systrace. Lihat Mengonversi antara format pelacakan untuk mengetahui informasi selengkapnya.

Membuat laporan HTML

Saat membagikan pelacakan, laporan tersebut sendiri berada di file .perfetto-trace (pada perangkat yang menjalankan Android 10 atau yang lebih tinggi) atau file .ctrace (untuk semua versi lainnya).

Buat laporan HTML dari file pelacakan menggunakan UI berbasis web atau dari command line.

UI berbasis web

Gunakan Perfetto UI untuk membuka file pelacakan dan membuat laporan.

Untuk file Perfetto, klik Buka file pelacakan. Untuk file Systrace, klik Buka dengan UI lama. UI lama memiliki tampilan dan nuansa yang sama dengan laporan Systrace.

Command line

Jalankan perintah berikut di jendela terminal untuk membuat laporan HTML dari file pelacakan:

    cd /path-to-traces-on-my-dev-machine && \
      systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Jika belum memiliki program command line systrace, Anda dapat mendownloadnya dari project Catapult di GitHub, atau langsung dari Proyek Open Source Android.