Merekam aktivitas dengan Winscope

Jalankan Winscope secara lokal atau akses dari server web.

Anda dapat mengambil rekaman aktivitas menggunakan Winscope untuk pengembangan dan proses debug lokal. Winscope menggunakan adb, yang mendukung koneksi perangkat melalui USB atau Wi-Fi.

Saat Anda meluncurkan Winscope, layar Collect Traces akan muncul.

Koneksi perangkat

Anda dapat menghubungkan perangkat di Winscope menggunakan Winscope Proxy atau Web Device Proxy. Secara default, halaman beranda Winscope menampilkan UI penyiapan koneksi Winscope Proxy.

Untuk mulai mengambil rekaman aktivitas, pilih salah satu mekanisme koneksi perangkat berikut.

Penyiapan Winscope Proxy

Ikuti langkah-langkah berikut untuk menyiapkan Winscope Proxy:

1. Di bagian Collect Traces pada halaman beranda, pilih Winscope Proxy dari menu Select connection type:

   

   Gambar 1. Mengambil rekaman aktivitas menggunakan Winscope Proxy.

2. Luncurkan proxy Winscope ADB Connect untuk mengambil rekaman aktivitas langsung dari browser Anda, dengan menjalankan perintah berikut:

   python3 $ANDROID_BUILD_TOP/development/tools/winscope/src/adb/winscope_proxy.py
   

3. Perhatikan token proxy Winscope yang ditampilkan di terminal setelah eksekusi.

4. Setelah Anda meluncurkan proxy Winscope ADB Connect, layar akan berubah sebagai berikut. Untuk membuat koneksi awal ke proxy, masukkan token proxy Winscope dari langkah 3, lalu klik Connect.

   

   Gambar 2. Menghubungkan ke Winscope Proxy.

Penyiapan Web Device Proxy

Ikuti langkah-langkah berikut untuk menyiapkan Web Device Proxy:

1. Di bagian Collect Traces pada halaman beranda, pilih Web Device Proxy dari menu Select connection type:

   

   Gambar 3. Mengambil rekaman aktivitas menggunakan Web Device Proxy.

2. Jika Anda tidak memiliki daemon Web Device Proxy di komputer, klik Install atau jalankan penginstal.

3. Setujui akses origin ke Web Device Proxy melalui dialog.

   

   Gambar 4. Mengotorisasi origin.

4. Setujui akses untuk setiap perangkat baru saat pertama kali Anda terhubung ke perangkat. Jika dialog tidak muncul secara otomatis, klik ikon lock_open di samping perangkat:

   

   Gambar 5. Mengotorisasi perangkat.

Trace

Ikuti langkah-langkah berikut untuk mengumpulkan rekaman aktivitas:

1. Saat terhubung, untuk memulai proses pengambilan rekaman aktivitas, pilih target dan konfigurasi setelan. Kemudian, klik Start trace untuk memulai pengambilan rekaman aktivitas:

   

   Gambar 6. Mengumpulkan rekaman aktivitas di Winscope.

2. Untuk menghentikan pengambilan rekaman aktivitas, klik End trace:

   

   Gambar 7. Mengakhiri rekaman aktivitas di Winscope.

Opsi rekaman aktivitas

Bagian ini menjelaskan opsi untuk setiap jenis rekaman aktivitas.

Perekaman layar

Dengan Winscope, Anda dapat merekam layar beberapa tampilan. Pilih tampilan dari menu untuk merekam layar. Jika Anda tidak melakukan pilihan, Winscope akan merekam tampilan aktif secara default.

SurfaceFlinger

• Buffer size: Menyesuaikan ukuran buffer ring dalam memori untuk rekaman aktivitas SurfaceFlinger. Buffer yang lebih besar memungkinkan pengumpulan lebih banyak data, tetapi meningkatkan penggunaan memori.

• Input: Jika platform berisi data input, lacak spesifikasi jendela input.

• Composition: Melacak jenis komposisi dan wilayah yang terlihat.

• Metadata: Melacak metadata platform tambahan, termasuk lapisan di luar layar.

• HWC: Melacak metadata hardware composer tambahan yang tidak terstruktur.

• Trace buffers: Mengonfigurasi SurfaceFlinger untuk melacak semua perubahan buffer di platform. Secara default, SurfaceFlinger hanya melacak status baru saat geometri diubah.

• Virtual displays: Menyertakan lapisan tampilan virtual dalam rekaman aktivitas.

WindowManager

• Buffer size: Menyesuaikan ukuran buffer ring dalam memori untuk rekaman aktivitas WindowManager. Buffer yang lebih besar memungkinkan pengumpulan lebih banyak data, tetapi meningkatkan penggunaan memori.

• Tracing type: Menentukan opsi frekuensi untuk mengumpulkan status:

  • frame: Dalam mode ini, WindowManager membuang satu status per frame, sehingga hanya status WindowManager yang valid yang diambil. Mode ini memiliki overhead performa terendah.
  • transaction: Mode ini merekam status WindowManager setiap kali transaksi dilakukan. Anda dapat melakukan beberapa transaksi dalam satu frame, sehingga memungkinkan proses debug status WindowManager perantara selama frame. Namun, mode ini memiliki overhead performa yang lebih tinggi dibandingkan dengan mode frame.

• Tracing level: Menentukan detail rekaman aktivitas WindowManager:

  • verbose: Menyertakan semua informasi jendela dan konfigurasi untuk setiap jendela. Mode ini memiliki overhead memori dan performa tertinggi.
  • debug: Menyertakan informasi tentang semua jendela, tetapi hanya mencatat konfigurasi jendela jika berisi konfigurasi penggantian yang diminta.
  • critical: Menyertakan informasi yang sama dengan mode Debug, tetapi hanya menyertakan jendela yang terlihat. Mode ini memiliki overhead memori dan performa terkecil.

Dump

Untuk mengambil dump status menggunakan Winscope, di bagian Collect Traces pada halaman beranda pilih tab Dump , lalu klik Dump state:

Gambar 8. Dump status di Winscope.

Konfigurasi screenshot

Winscope memungkinkan pengambilan screenshot untuk beberapa tampilan. Pilih tampilan dari menu untuk mengambil screenshot. Jika tidak ada pilihan yang dibuat, screenshot akan dikumpulkan untuk tampilan aktif.