Mendapatkan laporan error yang dapat dibaca di dasbor Crashlytics

iOS+ (platform Apple)

Untuk aplikasi platform Apple yang menggunakan Crashlytics Unity SDK 8.2.0+, plugin Firebase Unity Editor secara otomatis mengonfigurasi project Xcode untuk mengupload simbol. Download versi terbaru.

Android

Untuk aplikasi Android, Crashlytics Unity SDK 8.6.1+ secara otomatis menyertakan laporan error NDK, yang memungkinkan Crashlytics melaporkan error IL2CPP Unity di Android secara otomatis. Namun, guna melihat stack trace tersimbolisasi untuk error library native di dasbor Crashlytics, Anda harus mengupload informasi simbol pada waktu build menggunakan Firebase CLI.

1. Pastikan Anda menggunakan Crashlytics Unity SDK v8.6.1 atau versi yang lebih baru. Download versi terbaru.

2. Siapkan lingkungan dan project Anda untuk upload simbol:

   1. Ikuti petunjuk untuk menginstal Firebase CLI.

      Jika Anda sudah menginstal CLI, pastikan untuk mengupdate ke versi terbarunya.

   2. (hanya untuk aplikasi yang menggunakan Android API level 30+) Update template AndroidManifest.xml aplikasi Anda untuk menonaktifkan Pemberian Tag Pointer:

      1. Centang kotak untuk Android Player Settings > Publishing Settings > Build > Custom Main Manifest.

      2. Buka template manifes yang berada di Assets/Plugins/Android/AndroidManifest.xml.

      3. (hanya untuk aplikasi yang menggunakan versi SDK sebelum 8.8.0) Tambahkan atribut berikut ke tag aplikasi: <application android:allowNativeHeapPointerTagging="false" ... />

3. Build project Anda dan upload simbol.

   Selesaikan langkah-langkah ini setiap kali Anda membuat build rilis atau build apa pun yang ingin Anda lihat pelacakan tumpukan tersimbolisasinya di Firebase console.

   1. Dari dialog Build Settings, lakukan salah satu langkah berikut:

      • Ekspor ke project Android Studio untuk membangun project Anda; atau

      • Bangun APK langsung dari Unity Editor.
        Sebelum membangun, pastikan kotak centang untuk Create symbols.zip dicentang pada dialog Build Settings.

   2. Setelah build selesai, buat file simbol yang kompatibel dengan Crashlytics dan upload ke server Firebase dengan menjalankan perintah Firebase CLI berikut:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: ID Aplikasi Android Firebase Anda (bukan nama paket)
        Contoh ID Aplikasi Android Firebase: 1:567383003300:android:17104a2ced0c9b9b

        Perlu menemukan ID Aplikasi Firebase Anda?

        Berikut dua cara untuk menemukan ID Aplikasi Firebase:

        • Di file google-services.json, ID Aplikasi Anda adalah nilai mobilesdk_app_id; atau

        • Di Firebase console, buka Project settings. Scroll ke bawah ke kartu Your apps, lalu klik Aplikasi Firebase yang diinginkan untuk menemukan ID Aplikasi-nya.

      • PATH/TO/SYMBOLS: Jalur ke file simbol yang dihasilkan oleh CLI

        • Mengekspor ke project Android Studio — PATH/TO/SYMBOLS adalah direktori unityLibrary/symbols, yang dibuat dalam root project yang diekspor setelah Anda membangun aplikasi melalui Gradle atau Android Studio.

        • Membangun APK langsung dari dalam Unity — PATH/TO/SYMBOLS adalah jalur file simbol terkompresi yang dihasilkan di direktori root project saat build Anda selesai (misalnya: myproject/myapp-1.0-v100.symbols.zip).

      Lihat opsi lanjutan untuk menggunakan perintah Firebase CLI dalam pembuatan dan upload file simbol

      Flag	Deskripsi
      --generator=csym	Menggunakan generator file simbol cSYM lama, bukan generator Breakpad default Tidak direkomendasikan untuk digunakan. Sebaiknya gunakan generator file simbol Breakpad default.
      --generator=breakpad	Menggunakan generator file simbol Breakpad Perhatikan bahwa default untuk pembuatan file simbol adalah Breakpad. Hanya gunakan flag ini jika Anda telah menambahkan symbolGenerator { csym() } dalam konfigurasi build dan ingin menggantinya untuk menggunakan Breakpad.
      --dry-run	Membuat file simbol tetapi tidak menguploadnya Flag ini berguna jika Anda ingin memeriksa konten file yang dikirim.
      --debug	Menyediakan informasi proses debug tambahan