Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Memulai Firebase Crashlytics

Panduan memulai ini menjelaskan cara menyiapkan Firebase Crashlytics di aplikasi Anda dengan Firebase Crashlytics SDK, agar Anda bisa mendapatkan laporan kerusakan yang komprehensif di Firebase console.

Penyiapan Crashlytics memerlukan tugas, baik di Firebase console maupun IDE Anda (seperti menambahkan file konfigurasi Firebase dan Crashlytics SDK). Untuk menyelesaikan penyiapan, Anda harus memaksa error pengujian untuk mengirim laporan kerusakan pertama ke Firebase.

Sebelum memulai

  1. Tambahkan Firebase ke project Unity, jika Anda belum melakukannya. Jika belum memiliki project Unity, Anda dapat mendownload aplikasi contoh.

  2. Direkomendasikan: Untuk mendapatkan fitur seperti pengguna bebas error, log breadcrumb, dan notifikasi kecepatan, Anda harus mengaktifkan Google Analytics di project Firebase.

    • Jika project Firebase yang ada belum mengaktifkan Google Analytics, Anda dapat melakukannya dari tab Integrasi di > Setelan project di Firebase console.

    • Saat membuat project Firebase baru, aktifkan Google Analytics selama alur kerja pembuatan project.

Langkah 1: Aktifkan Crashlytics di Firebase console

  1. Buka dasbor Crashlytics di Firebase console.

  2. Pastikan aplikasi Anda dipilih dari dropdown di samping Crashlytics di bagian atas halaman.

  3. Klik Aktifkan Crashlytics.

Langkah 2: Tambahkan Firebase Crashlytics SDK ke aplikasi

  1. Download Firebase Unity SDK, lalu ekstrak SDK di tempat yang mudah diakses.

    Firebase Unity SDK tidak dikhususkan untuk platform tertentu.

  2. Pada project Unity yang terbuka, buka Assets > Import Package > Custom Package.

  3. Dari SDK yang telah diekstrak, pilih untuk mengimpor Crashlytics SDK (FirebaseCrashlytics.unitypackage).

    Anda juga dapat mengimpor produk Firebase lain yang didukung.

  4. Di jendela Import Unity Package, klik Import.

Langkah 3: Inisialisasi Crashlytics

  1. Buat skrip C# baru, lalu tambahkan ke GameObject di scene.

    1. Buka scene pertama Anda, lalu buat GameObject kosong bernama CrashlyticsInitializer.

    2. Klik Tambahkan Komponen di Pemeriksa untuk objek baru.

    3. Pilih skrip CrashlyticsInit Anda untuk menambahkannya ke objek CrashlyticsInitializer.

  2. Inisialisasi Crashlytics dalam metode Start skrip:

    using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    
    // Import Firebase
    using Firebase;
    
    public class CrashlyticsInit : MonoBehaviour {
        // Use this for initialization
        void Start () {
            // Initialize Firebase
            Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                var dependencyStatus = task.Result;
                if (dependencyStatus == Firebase.DependencyStatus.Available)
                {
                    // Create and hold a reference to your FirebaseApp,
                    // where app is a Firebase.FirebaseApp property of your application class.
                    // Crashlytics will use the DefaultInstance, as well;
                    // this ensures that Crashlytics is initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // Set a flag here for indicating that your project is ready to use Firebase.
                }
                else
                {
                    UnityEngine.Debug.LogError(System.String.Format(
                      "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                    // Firebase Unity SDK is not safe to use here.
                }
            });
        }
    
      // Update is called once per frame
      void Update()
        // ...
    }

Langkah 4: Jalankan project

  1. Ekspor project Anda ke iOS atau Android.

  2. Setelah ekspor selesai, pastikan bahwa project diekspor dengan benar dengan membandingkan project yang diekspor dan contoh konfigurasi ekspor di bawah.

    Jika sepertinya ada file yang hilang setelah membandingkan project, buka Unity Editor, lalu jalankan Resolver Layanan Google Play (temukan petunjuknya di bawah).

    iOS

    Android

Jalankan resolver jika file hilang setelah ekspor (jika diperlukan)

Resolver Layanan Google Play memastikan bahwa project Unity Anda memiliki dependensi yang sesuai untuk mengekspor aplikasi Anda ke iOS atau Android. Untuk informasi lebih lanjut tentang resolver, baca README untuk Unity Jar Resolver.

Langkah 5: Paksa error pengujian untuk menyelesaikan penyiapan

Untuk menyelesaikan penyiapan Crashlytics dan melihat data awal di dasbor Crashlytics pada Firebase console, Anda harus memaksa error pengujian.

  1. Dari jendela Hierarki, buat objek baru:

    1. Klik kanan dan pilih Buat Kosong untuk menambahkan GameObject kosong baru ke scene dalam game Anda.

    2. Beri nama objek baru CrashlyticsTester.

    3. Pastikan objek CrashlyticsTester dipilih sebelum melanjutkan.

  2. Di tab Pemeriksa, tambahkan skrip baru yang akan menyebabkan error pengujian selama beberapa detik setelah Anda menjalankan aplikasi:

    1. Klik Tambahkan Komponen.

    2. Pilih Skrip Baru di bagian bawah daftar komponen.

    3. Namai skrip baru ini CrashlyticsTester juga, lalu tambahkan konten berikut ke skrip:

      using System;
      using UnityEngine;
      
      public class CrashlyticsTester : MonoBehaviour {
      
          int updatesBeforeException;
      
          // Use this for initialization
          void Start () {
            updatesBeforeException = 0;
          }
      
          // Update is called once per frame
          void Update()
          {
              // Call the exception-throwing method here so that it's run
              // every frame update
              throwExceptionEvery60Updates();
          }
      
          // A method that tests your Crashlytics implementation by throwing an
          // exception every 60 frame updates. You should see non-fatal errors in the
          // Firebase console a few minutes after running your app with this method.
          void throwExceptionEvery60Updates()
          {
              if (updatesBeforeException > 0)
              {
                  updatesBeforeException--;
              }
              else
              {
                  // Set the counter to 60 updates
                  updatesBeforeException = 60;
      
                  // Throw an exception to test your Crashlytics implementation
                  throw new System.Exception("test exception please ignore");
              }
          }
      }
      
  3. Build dan jalankan aplikasi Anda:

    1. Buka File > Setelan Build, lalu pilih Android atau iOS dari daftar platform.

    2. Klik Build dan Jalankan aplikasi Anda untuk iOS atau Android.

  4. Setelah aplikasi Anda berjalan, pantau log perangkat dan tunggu hingga pengecualian dipicu dari CrashlyticsTester.

    • iOS: Lihat log di panel bawah Xcode.

    • Android: Lihat log dengan menjalankan perintah berikut di terminal: adb logcat.

  5. Saat Anda melihat pengecualian di log perangkat, mulai ulang aplikasi agar dapat mengirim laporan kerusakan ke Firebase.

  6. Buka dasbor Crashlytics Firebase console untuk melihat error pengujian Anda.

    Jika Anda sudah me-refresh konsol dan masih tidak melihat error pengujian setelah lima menit, aktifkan logging debug untuk melihat apakah aplikasi Anda mengirim laporan kerusakan atau tidak.


Dan selesai! Crashlytics kini akan memantau aplikasi Anda untuk menemukan error, dan Anda dapat melihat serta menyelidiki laporan kerusakan dan statistik error di dasbor Crashlytics.

Langkah berikutnya