Memulai Firebase Crashlytics

Panduan memulai ini menjelaskan cara menyiapkan Firebase Crashlytics untuk membantu Anda mendapatkan laporan kerusakan yang komprehensif di Firebase console.

ios

android

unity [beta]

Sebelum memulai

ios

Agar dapat menggunakan Crashlytics, Anda harus mendaftarkan aplikasi iOS Anda dan mengonfigurasinya untuk menggunakan Firebase.

  • Jika aplikasi iOS Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasikan untuk Firebase.

  • Jika tidak memiliki aplikasi iOS, Anda dapat mendownload aplikasi contoh.

Perlu diperhatikan bahwa menambahkan Firebase ke aplikasi iOS Anda melibatkan tugas di Firebase console dan di project Xcode yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Xcode).

android

Agar dapat menggunakan Crashlytics, Anda harus mendaftarkan aplikasi Android Anda dan mengonfigurasinya untuk menggunakan Firebase.

  • Jika aplikasi Android Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasikan untuk Firebase.

  • Jika tidak memiliki aplikasi Android, Anda dapat mendownload aplikasi contoh.

Perlu diperhatikan bahwa menambahkan Firebase ke aplikasi Android Anda melibatkan tugas di Firebase console dan di project Android yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Android).

unity [beta]

Agar dapat menggunakan Crashlytics, Anda harus mendaftarkan project Unity Anda dan mengonfigurasinya untuk menggunakan Firebase.

  • Jika project Unity Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasikan untuk Firebase.

  • Jika belum memiliki project Unity, Anda dapat mendownload aplikasi contoh.

Perlu diperhatikan bahwa menambahkan Firebase ke project Unity Anda melibatkan tugas di Firebase console dan di project Unity yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Unity).

Langkah 1: Siapkan Crashlytics di Firebase console

  1. Klik Crashlytics di panel navigasi kiri Firebase console.

  2. Jika project Firebase Anda memiliki beberapa aplikasi yang terdaftar di dalamnya, pilih aplikasi yang baru saja ditambahkan dari menu drop-down di samping Crashlytics di panel bagian atas konsol.

  3. Klik Siapkan Crashlytics.

  4. Pilih Aplikasi ini baru di Crashlytics (belum memiliki versi SDK apa pun).

Langkah 2: Tambahkan Crashlytics SDK

ios

Untuk memulai, tambahkan file framework Crashlytics SDK ke ruang kerja Xcode pada project Anda. Untuk sebagian besar project, cara termudah untuk melakukannya adalah dengan menambahkan CocoaPods pada Crashlytics. Namun, jika project Anda tidak dapat mendukung CocoaPods, Anda juga dapat menambahkan file tersebut secara manual.

android

  1. Pada build.gradle tingkat project, update google-services Anda ke versi 3.1.2 atau yang lebih baru, kemudian tambahkan repositori dan dependensi Crashlytics:

    buildscript {
        repositories {
            // ...
    
            // Add repository
            maven {
               url 'https://maven.fabric.io/public'
            }
        }
        dependencies {
            // ...
    
            // Check for v3.1.2 or higher
            classpath 'com.google.gms.google-services:4.2.0'
    
            // Add dependency
            classpath 'io.fabric.tools:gradle:1.26.1'
        }
    }
    
    allprojects { // ... repositories { // ... // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }

  2. Pada build.gradle tingkat aplikasi, update firebase-core Anda ke versi v11.4.2 atau yang lebih baru, kemudian tambahkan dependensi Crashlytics:

    apply plugin: 'com.android.application'
    apply plugin: 'io.fabric'
    
    dependencies { // ... // Check for v11.4.2 or higher implementation 'com.google.firebase:firebase-core:16.0.8' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.9.9' }

Setelah Anda menambahkan SDK ke aplikasi, Crashlytics akan otomatis mulai mendeteksi dan mengumpulkan laporan kerusakan.

unity [beta]

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

    Firebase Unity SDK tidak khusus platform.

  2. Pada project Unity yang terbuka, buka Aset > Impor Paket > Paket Kustom.

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

    Anda juga dapat mengimpor layanan Firebase lain yang didukung.

  4. Di jendela Import Unity Package, klik Import.

Langkah 3: Inisialisasi Crashlytics

ios

Framework yang Anda tambahkan mencakup skrip jalankan yang akan melakukan inisialisasi Crashlytics. Tambahkan skrip tersebut ke fase build project Anda:

  1. Buka project di Xcode, lalu pilih file project-nya di Navigator.

  2. Pilih target build utama Anda dari menu drop-down Select a project or target.

  3. Buka tab Build Phases target.

  4. Klik + Add a new build phase, lalu pilih New Run Script Phase.

  5. Tambahkan baris berikut ke kotak teks Type a script:

    Penginstalan CocoaPods
    "${PODS_ROOT}/Fabric/run"
    Penginstalan manual
    "${PROJECT_DIR}/Fabric.framework/run"

  6. Khusus Xcode 10: Tambahkan lokasi Info.plist bawaan aplikasi Anda ke kolom Input Files pada Build Phase:

    $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Setelah Anda menambahkan SDK ke aplikasi, Crashlytics akan otomatis mulai mendeteksi dan mengumpulkan laporan kerusakan.

android

Untuk aplikasi Android, hook dalam file AndroidManifest.xml akan menginisialisasi Firebase SDK secara otomatis.

unity [beta]

  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 Inspektur untuk object baru.

    3. Pilih skrip CrashlyticsInit Anda untuk menambahkannya ke object 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;
    
                      // WARNING: Do not call Crashlytics APIs from asynchronous tasks;
                      // they are not currently supported.
    
                      // 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()
          // ...
      }

Setelah SDK ditambahkan dan diinisialisasi, Crashlytics akan otomatis mulai mendeteksi dan mengumpulkan laporan kerusakan.

Langkah 4: Buat atau jalankan project Anda

ios

Jalankan aplikasi untuk mengirimkan verifikasi ke Firebase bahwa Anda telah berhasil mengintegrasikan Firebase.

Log perangkat Anda akan menampilkan verifikasi Firebase bahwa inisialisasi telah selesai.

android

Jalankan aplikasi untuk mengirimkan verifikasi ke Firebase bahwa Anda telah berhasil mengintegrasikan Firebase.

Log perangkat Anda akan menampilkan verifikasi Firebase bahwa inisialisasi telah selesai. Jika menjalankan aplikasi pada emulator yang memiliki akses jaringan, Firebase console akan memberi tahu bahwa koneksi aplikasi Anda telah selesai.

unity [beta]

Setelah mengekspor project ke iOS atau Android, verifikasi bahwa project tersebut diekspor dengan benar.

Jika sepertinya ada file yang hilang setelah membandingkan project Anda dengan contoh konfigurasi ekspor di bawah ini, buka Unity Editor, kemudian jalankan Resolver Layanan Google Play.

iOS

Android

Menjalankan resolver (opsional)

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.

iOS

Resolver iOS berjalan secara otomatis dan memanfaatkan Cocoapods untuk menempatkan dependensi iOS di direktori Pods yang diekspor.

  • Untuk mendownload Cocoapods ke mesin Anda:

    • Buka Aset > Resolver Layanan Play > Resolver iOS > Instal Cocoapods
  • Untuk mengaktifkan atau menonaktifkan pembuatan podfiles (opsional):

    • Buka Aset > Resolver Layanan Play > Resolver iOS > Setelan

Android

Resolver Android berjalan secara otomatis dan memanfaatkan gradle untuk menempatkan dependensi Android di Assets/Plugins/Android.

  • Untuk menjalankan resolver secara manual:

    • Buka Aset > Resolver Layanan Play > Resolver Android > Selesaikan
  • Untuk mengaktifkan atau menonaktifkan resolusi otomatis (diaktifkan secara default):

    • Buka Aset > Resolver Layanan Play > Resolver Android > Setelan

Menonton video tutorial

iOS

Untuk mendapatkan panduan terperinci tentang cara memulai Crashlytics, tonton video tutorial berikut:

Anda dapat menemukan lebih banyak video di channel YouTube Firebase.

Android

Untuk mendapatkan panduan terperinci tentang cara memulai Crashlytics, tonton video tutorial berikut:

Anda dapat menemukan lebih banyak video di channel YouTube Firebase.

Langkah berikutnya

  • Menguji implementasi Anda—Uji penyiapan Crashlytics Anda dengan memaksakan error untuk menghasilkan laporan kerusakan di Firebase console.

  • Menyesuaikan laporan kerusakan—Crashlytics otomatis mulai mengumpulkan laporan kerusakan begitu Anda menambahkan SDK. Namun, Anda juga dapat menyesuaikan penyiapan dengan menambahkan pelaporan keikutsertaan, log, kunci, dan bahkan pelacakan error tidak fatal.

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.