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 iOS jika belum melakukannya. Jika tidak memiliki aplikasi iOS, 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. Buka podfile yang Anda buat untuk project Firebase, lalu tambahkan pod FirebaseCrashlytics.

    Untuk mendapatkan pengalaman yang optimal dengan Crashlytics, sebaiknya aktifkan Google Analytics di project Firebase dan tambahkan pod Firebase untuk Google Analytics ke aplikasi Anda.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. Instal pod, lalu buka kembali file .xcworkspace Anda untuk melihat project di Xcode:

    pod install
    open your-project.xcworkspace
    
  3. Impor modul Firebase di UIApplicationDelegate Anda:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  4. Konfigurasikan instance bersama FirebaseApp, yang biasanya ada dalam metode application:didFinishLaunchingWithOptions: aplikasi Anda:

    Swift

    // Use the Firebase library to configure APIs.
    FirebaseApp.configure()
    

    Objective-C

    // Use the Firebase library to configure APIs.
    [FIRApp configure];
    

Langkah 3: Siapkan Xcode untuk otomatis mengupload file dSYM

Untuk menghasilkan laporan kerusakan yang dapat dibaca manusia, Crashlytics memerlukan file simbol debug (dSYM) project Anda. Langkah-langkah berikut menjelaskan cara mengonfigurasi Xcode agar otomatis menghasilkan, memproses, dan mengupload file dSYM setiap kali Anda mem-build aplikasi.

  1. Buka ruang kerja Xcode pada project Anda, lalu pilih file project-nya di navigator kiri.

  2. Dari daftar TARGETS, pilih target build utama Anda.

  3. Klik tab Build Settings lalu selesaikan langkah-langkah berikut sehingga Xcode menghasilkan dSYM untuk build Anda.

    1. Klik All, lalu cari debug information format.

    2. Setel Debug Information Format ke DWARF with dSYM File untuk semua jenis build.

  4. Klik tab Build Phases, lalu selesaikan langkah-langkah berikut sehingga Xcode dapat memproses dan mengupload file dSYM.

    1. Klik > New Run Script Phase.

      Pastikan fase Run Script baru ini adalah fase build terakhir project Anda; jika tidak, Crashlytics tidak akan dapat memproses dSYM dengan benar.

    2. Perluas bagian Run Script baru.

    3. Di kolom skrip (terletak di bawah label Shell), tambahkan skrip pengoperasian berikut.

      Skrip ini memproses file dSYM project dan menguploadnya ke Crashlytics.

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. Di bagian Input Files, tambahkan jalur untuk file berikut.

      • Tambahkan jalur ke file dSYM project

        Hal ini memungkinkan Crashlytics memproses dSYM untuk aplikasi besar dengan lebih cepat.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • Tambahkan jalur ke file Info.plist bawaan project Anda

        Hal ini memungkinkan Crashlytics mengaitkan versi aplikasi dengan dSYM.

        $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Untuk mendapatkan informasi selengkapnya tentang file dSYM dan Crashlytics (termasuk cara mengupload file dSYM secara manual), buka Mendapatkan laporan kerusakan yang di-deobfuscate.

Langkah 4: 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.


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