Debug ANR

Menyelesaikan ANR di game Unity Anda adalah proses yang sistematis:

Mengintegrasikan layanan pelaporan

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

Layanan pelaporan yang berbeda memiliki cara yang berbeda untuk merekam 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 stack trace dalam format yang dapat dibaca manusia. Lihat Membuat simbolisasi error dan ANR Android untuk game Unity guna mengetahui informasi selengkapnya.

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 diperlukan untuk mengupload file simbol.

Di Windows atau macOS:

1. Buka folder simbol berdasarkan backend scripting 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

Jika rekaman aktivitas stack menunjukkan fungsi di library libil2cpp.so, error terjadi dalam 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 merupakan 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 oleh konverter IL2CPP (ditandai dengan warna oranye).

Periksa kode game Anda dengan melakukan hal berikut:

• Periksa project C# untuk menemukan kode yang mencurigakan. Biasanya, pengecualian yang tidak tertangani C# tidak menyebabkan ANR atau aplikasi mengalami error. Meski begitu, 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 pada perangkat tertentu.
• Ekspor game sebagai project Android Studio. Dengan akses lengkap ke kode sumber C# game yang dikonversi, Anda dapat menemukan fungsi yang menyebabkan ANR. Kode C++ terlihat sangat berbeda dari kode C# Anda, dan konversi kode jarang mengalami masalah. Jika Anda menemukan sesuatu, ajukan tiket dukungan ke Unity.
• Tinjau kode sumber game dan pastikan semua logika yang berjalan di callback OnApplicationFocus() dan OnApplicationPause() dibersihkan dengan tepat.
  • Mesin Unity memiliki waktu tunggu untuk menjeda eksekusinya; beban kerja yang berlebihan pada callback ini dapat menyebabkan ANR.
  • Tambahkan log atau breadcrumb ke bagian kode untuk meningkatkan analisis data Anda.
• Gunakan Unity Profiler untuk menyelidiki performa game. Membuat profil aplikasi juga dapat menjadi cara yang efektif untuk membantu mengidentifikasi hambatan yang mungkin menyebabkan ANR.
• Cara terbaik untuk mengidentifikasi operasi I/O yang lama di thread utama adalah dengan menggunakan mode ketat.
• Analisis histori Android Vitals atau 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 antar-rilis. Jika Anda menemukan sesuatu yang mencurigakan, coba setiap perubahan atau potensi perbaikan satu per satu.
• Periksa histori pelaporan ANR Google Play untuk perangkat dan versi Android yang paling banyak menerima ANR. Jika perangkat atau versi sudah usang, kemungkinan Anda dapat mengabaikannya dengan aman jika hal itu 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 dapat menyebabkan masalah, misalnya, finish dapat merusak jika tidak digunakan dengan benar. Lihat panduan developer Android untuk mempelajari lebih lanjut pengembangan Android.
• Setelah meninjau data dan mengekspor build game ke Android Studio, Anda akan berurusan dengan kode C dan C++, sehingga Anda dapat memanfaatkan sepenuhnya 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 dalam stack trace. Jika Anda menemukannya, lakukan langkah-langkah berikut:

• Pertama, telusuri saluran komunitas (Forum Unity, Diskusi Unity, Stackoverflow).
• Jika Anda tidak menemukan apa pun, ajukan bug untuk menyelesaikan masalah tersebut. Berikan rekaman aktivitas stack yang disimbolkan agar engineer mesin dapat lebih memahami dan menyelesaikan error tersebut.
• 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.

SDK pihak ketiga

• Pastikan semua library pihak ketiga sudah diupdate dan tidak memiliki laporan error atau ANR untuk Android versi terbaru.
• Buka Forum Unity untuk melihat apakah ada error yang telah diselesaikan dalam versi yang lebih baru atau apakah solusi telah diberikan oleh Unity atau anggota komunitas.
• Tinjau laporan ANR Google Play dan pastikan error belum diidentifikasi oleh Google. Google mengetahui beberapa ANR dan sedang 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 Unity versi lama, Anda harus 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.