Debug ANR

Memecahkan ANR di game Unity Anda adalah proses yang sistematis:

Gambar 1. Langkah-langkah untuk mengatasi ANR di game Unity.

Mengintegrasikan layanan pelaporan

Layanan pelaporan seperti Android vitals, Firebase Crashlytics, dan Backtrace (partner Unity yang tersertifikasi) menyediakan logging dan analisis error untuk game Anda dalam skala besar. Integrasikan SDK layanan pelaporan ke dalam game Anda di awal siklus pengembangan. Analisis layanan pelaporan yang paling sesuai dengan kebutuhan dan anggaran game Anda.

Layanan pelaporan yang berbeda memiliki cara yang berbeda dalam mencatat ANR. Sertakan layanan pelaporan kedua untuk meningkatkan peluang mendapatkan data yang valid guna mendukung keputusan Anda dalam memperbaiki ANR.

Mengintegrasikan SDK pelaporan tidak memengaruhi performa game atau ukuran APK.

Menganalisis simbol

Analisis laporan dari layanan pelaporan Anda dan periksa apakah pelacakan tumpukan dalam format yang dapat dibaca manusia. Lihat Membuat simbolisasi error dan ANR Android untuk game Unity guna mengetahui informasi selengkapnya.

Gambar 2. Crashlytics menampilkan ID build dan simbol libil2cpp.so yang hilang.

Cara memeriksa ID build simbol

Jika sistem pelaporan menampilkan ID build yang tidak ada, tetapi simbol build masih ada di penyimpanan mesin build, Anda dapat memeriksa ID build simbol, lalu menguploadnya ke layanan pelaporan. Jika tidak, build baru akan diperlukan untuk mengupload file simbol.

Di Windows atau macOS:

  1. Buka folder simbol berdasarkan backend pembuatan skrip Anda (lihat Resolusi:)
    1. Gunakan perintah berikut (di Windows, gunakan Cygwin untuk menjalankan utilitas readelf)
    2. Penggunaan grep bersifat opsional untuk memfilter output teks
    3. Mencari ID Build
readelf -n libil2cpp.so | grep 'Build ID'
Build ID: b42473fb7449e44e0182dd1f580c99bab0cd8a95

Memeriksa kode game

Saat stack trace menampilkan fungsi dalam library libil2cpp.so, error terjadi pada kode C#, yang dikonversi ke C++. Library libil2cpp.so tidak hanya memiliki kode game Anda, tetapi juga plugin dan paket.

Nama file C++ mengikuti nama assembly yang ditentukan dalam project Unity. Jika tidak, nama file akan memiliki nama Assembly-C# default. Misalnya, gambar 3 menunjukkan error pada file Game.cpp (ditandai dengan warna biru), yang adalah nama yang ditentukan dalam file Assembly Definition. Logger adalah nama class (ditandai dengan warna merah) dalam skrip C#, diikuti dengan nama fungsi (ditandai dengan warna hijau). Terakhir adalah nama lengkap yang dihasilkan pengonversi IL2CPP (ditandai dengan warna oranye).

Gambar 3. Uji stack panggilan project dari Backtrace.

Periksa kode game Anda dengan melakukan hal berikut:

  • Periksa project C# untuk menemukan kode yang mencurigakan. Biasanya, pengecualian C# yang tidak ditangani tidak menyebabkan ANR atau error aplikasi. Meskipun demikian, pastikan kode berjalan dengan benar dalam berbagai situasi. Periksa apakah kode menggunakan modul mesin pihak ketiga, dan analisis apakah rilis terbaru menyebabkan error. Selain itu, tinjau apakah Anda baru saja mengupdate Unity atau apakah error hanya terjadi di perangkat tertentu.
  • Ekspor game sebagai project Android Studio. Dengan akses lengkap ke kode sumber C# yang dikonversi game, Anda dapat menemukan fungsi yang menyebabkan ANR. Kode C++ terlihat sangat berbeda dengan kode C# Anda, dan konversi kode jarang mengalami masalah. Jika Anda menemukan sesuatu, ajukan tiket dukungan ke Unity.
  • Tinjau kode sumber game dan pastikan logika apa pun yang berjalan di callbacks OnApplicationFocus() dan OnApplicationPause() dibersihkan dengan benar.
    • Mesin Unity memiliki waktu tunggu untuk menjeda eksekusinya; beban kerja yang berlebihan pada callback ini dapat menyebabkan ANR.
    • Tambahkan log atau breadcrumb ke bagian-bagian kode untuk meningkatkan analisis data Anda.
  • Gunakan Unity Profiler untuk menyelidiki performa game. Membuat profil aplikasi juga dapat menjadi cara yang bagus untuk membantu mengidentifikasi bottleneck yang mungkin menyebabkan ANR.
  • Cara yang efektif untuk mengidentifikasi operasi I/O yang panjang di thread utama adalah dengan menggunakan mode ketat.
  • Analisis Android Vitals atau histori layanan pelaporan lainnya dan periksa versi rilis game yang paling sering mengalami error. Tinjau kode sumber Anda dalam histori kontrol versi dan bandingkan perubahan kode di antara rilis. Jika Anda menemukan sesuatu yang mencurigakan, lakukan eksperimen dengan setiap perubahan atau potensi perbaikan satu per satu.
  • Periksa histori pelaporan ANR Google Play untuk perangkat dan versi Android yang menerima ANR terbanyak. Jika perangkat atau versi sudah usang, kemungkinan Anda dapat mengabaikannya dengan aman jika hal tersebut tidak memengaruhi profitabilitas game. Pelajari data dengan cermat karena sekelompok pengguna tertentu tidak akan dapat lagi memainkan game Anda. Untuk mengetahui informasi selengkapnya, lihat Dasbor distribusi.
  • Tinjau kode sumber game untuk memastikan Anda tidak memanggil kode apa pun yang mungkin menyebabkan masalah, misalnya, finish dapat menjadi destruktif jika tidak digunakan dengan benar. Lihat panduan developer Android untuk mempelajari pengembangan Android lebih lanjut.
  • Setelah meninjau data dan mengekspor build game ke Android Studio, Anda akan menangani kode C dan C++, sehingga Anda dapat memanfaatkan alat di luar solusi standar Unity, seperti Android Memory Profiler, Android CPU Profiler, dan perfetto.

Kode mesin Unity

Untuk mengetahui apakah ANR terjadi di sisi mesin Unity, periksa libUnity.so atau libMain.so di stack trace. Jika Anda menemukannya, lakukan langkah-langkah berikut:

  • Pertama, telusuri saluran komunitas (Forum Unity, Diskusi Unity, Stackoverflow).
  • Jika Anda tidak menemukan apa pun, laporkan bug untuk menyelesaikan masalah. Berikan pelacakan tumpukan simbolis sehingga engineer mesin dapat lebih memahami dan menyelesaikan error.
  • Periksa apakah Unity LTS terbaru telah melakukan peningkatan terkait masalah Anda. Jika ya, upgrade game Anda untuk menggunakan versi tersebut. (Solusi ini mungkin hanya dapat dilakukan oleh beberapa developer.)
  • Jika kode Anda menggunakan Activity kustom, bukan default, tinjau kode Java untuk memastikan aktivitas tidak menyebabkan masalah apa pun.

SDK pihak ketiga

  • Pastikan semua library pihak ketiga sudah yang terbaru dan tidak memiliki laporan error atau ANR untuk Android versi terbaru.
  • Buka Forum Unity untuk melihat apakah error telah diatasi dalam versi yang lebih baru atau apakah solusi telah disediakan oleh Unity atau anggota komunitas.
  • Tinjau laporan ANR Google Play dan pastikan error tersebut belum diidentifikasi oleh Google. Google mengetahui beberapa ANR dan secara aktif berupaya memperbaikinya.

Library sistem

Library sistem biasanya jauh dari kontrol developer, tetapi tidak mewakili persentase ANR yang signifikan. Selain menghubungi developer library atau menambahkan log untuk mempersempit masalah, ANR library sistem sulit diatasi.

Alasan keluar

ApplicationExitInfo adalah Android API untuk memahami penyebab ANR. Jika game Anda menggunakan Unity 6 atau yang lebih baru, Anda dapat memanggil ApplicationExitInfo secara langsung. Untuk versi Unity yang lebih lama, Anda perlu menerapkan plugin sendiri untuk mengaktifkan panggilan ApplicationExitInfo dari Unity.

Crashlytics juga menggunakan ApplicationExitInfo; namun, penerapan Anda sendiri memberi Anda kontrol yang lebih baik dan memungkinkan Anda menyertakan informasi yang lebih relevan.