Debug ANR

Menyelesaikan ANR dalam game Unity adalah proses yang sistematis:

Mengintegrasikan layanan pelaporan

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

Layanan pelaporan yang berbeda memiliki cara yang berbeda untuk mencatat ANR. Menyertakan 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 memiliki 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 menunjukkan ID build yang tidak ada, tetapi simbol build masih ada di penyimpanan mesin build, Anda dapat memeriksa ID build simbol tersebut, lalu menguploadnya ke layanan pelaporan. Jika tidak, build baru diperlukan untuk mengupload file simbol.

Di Windows atau macOS:

1. Buka folder simbol berdasarkan backend pembuatan skrip (lihat Resolusi:)
   1. Gunakan perintah berikut (di Windows, gunakan dilakukan 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 pelacakan tumpukan menampilkan 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 (disorot biru), yang merupakan nama yang ditentukan dalam file Assembly Definition. Logger adalah nama class (disorot merah) dalam skrip C#, diikuti dengan nama fungsi (disorot hijau). Terakhir adalah nama lengkap yang dihasilkan oleh pengonversi IL2CPP (disorot dengan warna oranye).

Periksa kode game Anda dengan melakukan hal berikut:

• Periksa project C# untuk menemukan kode yang mencurigakan. Biasanya, pengecualian C# yang tidak tertangani tidak menyebabkan ANR atau error aplikasi. Meski begitu, pastikan kode berjalan dengan baik 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 pada game, Anda dapat menemukan fungsi yang menyebabkan ANR. Kode C++ terlihat sangat berbeda dari kode C#, dan konversi kode jarang mengalami masalah. Jika Anda menemukan sesuatu, ajukan tiket dukungan ke Unity.
• Tinjau kode sumber game dan pastikan bahwa setiap logika yang berjalan di callback OnApplicationFocus() dan OnApplicationPause() telah 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 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 terbaik 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 di histori kontrol versi dan bandingkan perubahan kode antar-rilis. Jika menemukan sesuatu yang mencurigakan, bereksperimenlah dengan setiap perubahan atau kemungkinan perbaiki satu per satu.
• Periksa histori pelaporan ANR Google Play untuk perangkat dan versi Android yang menerima ANR paling banyak. Jika perangkat atau versi sudah usang, mungkin Anda dapat mengabaikannya dengan aman jika hal ini tidak memengaruhi profit game. Pelajari data dengan cermat karena grup pengguna tertentu tidak akan dapat lagi memainkan game Anda. Untuk informasi selengkapnya, lihat Dasbor distribusi.
• Tinjau kode sumber game untuk memastikan Anda tidak memanggil kode apa pun yang dapat menyebabkan masalah, misalnya, finish dapat bersifat merusak 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 menangani kode C dan C++ sehingga 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 di pelacakan tumpukan. 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 tersebut. Berikan stack trace tersimbolisasi sehingga engineer mesin dapat lebih memahami dan mengatasi error.
• Periksa apakah Unity LTS terbaru telah membuat peningkatan terkait masalah Anda. Jika ya, upgrade game Anda untuk menggunakan versi tersebut. (Solusi ini hanya dapat dilakukan untuk 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 telah diupdate dan tidak memiliki laporan error atau ANR untuk versi Android terbaru.
• Buka Forum Unity untuk melihat apakah ada error yang telah diselesaikan dalam versi yang lebih baru atau apakah solusi telah disediakan oleh Unity atau anggota komunitas.
• Tinjau laporan ANR Google Play dan pastikan error belum teridentifikasi oleh Google. Google menyadari beberapa ANR dan 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 untuk diselesaikan.

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 mengimplementasikan plugin Anda sendiri untuk mengaktifkan panggilan ApplicationExitInfo dari Unity.

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