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. Bangun project Anda dan upload simbol.

    Selesaikan langkah-langkah ini setiap kali Anda membuat build rilis atau build apa pun yang ingin Anda lihat stack trace 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

      • 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