Mengambil dan membaca laporan bug

Laporan bug berisi log perangkat, pelacakan tumpukan, dan informasi diagnostik lainnya untuk membantu Anda menemukan dan memperbaiki bug dalam aplikasi. Anda dapat memperoleh laporan bug dari perangkat melalui opsi developer Ambil laporan bug, dari menu Android Emulator, atau perintah adb bugreport pada komputer pengembangan.

Gambar 1. Opsi developer

Untuk mengambil laporan bug, Anda harus mengaktifkan Opsi developer di perangkat agar dapat mengakses opsi Ambil laporan bug.

Mengambil laporan bug dari perangkat

Gambar 2. Laporan bug sudah siap

Untuk mendapatkan laporan bug langsung dari perangkat, lakukan langkah berikut:

  1. Pastikan Anda telah mengaktifkan Opsi Developer.
  2. Pada Opsi developer, ketuk Ambil laporan bug.
  3. Pilih jenis laporan bug yang Anda inginkan, dan ketuk Laporkan.

    Setelah beberapa saat, Anda akan menerima notifikasi bahwa laporan bug sudah siap (lihat gambar 2).

  4. Untuk membagikan laporan bug, ketuk notifikasi.

Mengambil laporan bug dari Android Emulator

Dari Android Emulator, Anda dapat menggunakan fitur File a bug pada jendela Extended controls:

  1. Klik More pada panel emulator.
  2. Pada jendela Extended controls, pilih Bug report di sebelah kiri.

    Sebuah layar akan terbuka tempat Anda dapat melihat detail laporan bug seperti screenshot, info konfigurasi AVD, dan log laporan bug. Anda juga dapat mengetik pesan yang berisi langkah-langkah reproduksi masalah untuk disimpan bersama laporan.

  3. Tunggu laporan bug selesai dikumpulkan, lalu klik Save Report.

Mengambil laporan bug menggunakan adb

Jika hanya ada satu perangkat yang terhubung, Anda dapat memperoleh laporan bug menggunakan adb sebagai berikut:

    $ adb bugreport E:\Reports\MyBugReports
    

Jika jalur untuk laporan bug tidak ditentukan, maka laporan akan disimpan ke direktori lokal.

Jika ada beberapa perangkat yang terhubung, Anda harus menentukan perangkat dengan opsi -s. Jalankan perintah adb berikut untuk mendapatkan nomor seri perangkat dan menghasilkan laporan bug.

    $ adb devices
    List of devices attached
    emulator-5554      device
    8XV7N15C31003476 device

    $ adb -s 8XV7N15C31003476 bugreport
    

Memeriksa file ZIP laporan bug

Secara default, file ZIP ini disebut bugreport-BUILD_ID-DATE.zip dan dapat berisi beberapa file, tetapi file yang paling penting adalah bugreport-BUILD_ID-DATE.txt. Ini adalah laporan bug dan berisi output diagnostik untuk layanan sistem (dumpsys), log error (dumpstate), dan log pesan sistem (logcat). Pesan sistem mencakup pelacakan tumpukan saat perangkat menampilkan error, dan pesan yang ditulis dari semua aplikasi dengan class Log.

File ZIP ini berisi file metadata version.txt yang memuat huruf rilis Android, dan jika systrace diaktifkan, file ZIP ini juga berisi file systrace.txt. Fitur Systrace membantu menganalisis performa aplikasi Anda dengan mengambil dan menampilkan waktu eksekusi proses aplikasi Anda dan proses sistem Android lainnya.

Fitur dumpstate menyalin file dari sistem file perangkat ke file ZIP pada folder FS sehingga Anda dapat mereferensikannya. Misalnya, file /dirA/dirB/fileC di perangkat akan menghasilkan entri FS/dirA/dirB/fileC dalam file ZIP tersebut.

Gambar 3. Struktur file laporan bug

Untuk informasi selengkapnya, lihat Membaca laporan bug.

Mendapatkan laporan dari pengguna

Mendapatkan laporan bug seperti dijelaskan di atas sangat membantu jika Anda menggunakan aplikasi tersebut sendiri, tetapi pengguna akhir tidak akan dapat membagikan jenis laporan bug ini kepada Anda dengan mudah. Untuk mendapatkan laporan kerusakan beserta pelacakan tumpukan dari pengguna sebenarnya, Anda dapat memanfaatkan fitur pelaporan kerusakan pada Google Play dan Firebase.

Konsol Google Play

Anda dapat memperoleh laporan dari Konsol Google Play untuk melihat data kerusakan dan error aplikasi tidak merespons (ANR) dari pengguna yang menginstal aplikasi Anda dari Google Play. Data tersedia hingga rentang waktu enam bulan ke belakang.

Untuk informasi selengkapnya, lihat Menampilkan kerusakan & error aplikasi tidak merespons (ANR) di bantuan Konsol Play.

Firebase Crash Reporting

Firebase Crashlytics Reporting membuat laporan mendetail yang berisi error dalam aplikasi Anda. Error dikelompokkan ke dalam masalah berdasarkan kemiripan pelacakan tumpukan, dan diprioritaskan berdasarkan tingkat keseriusan dampaknya terhadap pengguna. Selain laporan otomatis, Anda dapat membuat log peristiwa kustom untuk membantu mengetahui langkah yang menyebabkan error.

Untuk mulai menerima laporan kerusakan dari pengguna, cukup tambahkan dependensi Firebase ke file build.gradle Anda. Untuk informasi selengkapnya, lihat Firebase Crashlytics.