Lompat ke konten utama

Firebase Crashlytics untuk Aplikasi Capacitor

Pelajari cara mengintegrasikan pelaporan kejadian crash waktu nyata ke dalam aplikasi mobile Anda dengan panduan langkah demi langkah untuk mengatur Crashlytics untuk iOS dan Android.

Martin Donadieu

Martin Donadieu

Spesialis Konten

Firebase Crashlytics untuk Aplikasi Capacitor

Firebase Crashlytics membantu Anda mengikuti kejadian crash aplikasi secara waktu nyata, memberikan laporan detail untuk memperbaiki masalah dengan cepat. Ini terintegrasi dengan Capacitor untuk aplikasi iOS dan Android. Berikut adalah hal-hal yang perlu Anda ketahui:

  • Mengapa Menggunakan Crashlytics?

    • Dapatkan peringatan kecelakaan waktu nyata.
    • Analisis laporan kecelakaan rinci dengan pengelompokan masalah otomatis.
    • Monitor kesalahan kritikal untuk menjaga aplikasi stabil.
  • Persyaratan Pengaturan:

    • Pasang Node.js (v16+), Capacitor (v4+), dan alat seperti Xcode 14+ dan Android Studio Electric Eel.
    • Unduh Firebase berkas konfigurasi (GoogleService-Info.plist untuk iOS, google-services.json untuk Android).
    • Perbarui berkas spesifik platform seperti Podfile (iOS) dan build.gradle (Android).
  • Langkah-Langkah Utama:

    • Pasang Crashlytics:

      npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
    • Inisialisasi Crashlytics di aplikasi Anda:

      import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
      await FirebaseCrashlytics.initialize();
  • Uji Konfigurasi Anda:

    • Aktifkan Tes:

      await FirebaseCrashlytics.crash();
  • Tips Tambahan: Gabungkan Crashlytics dengan Capgo untuk pembaruan langsung tanpa menunggu penundaan toko aplikasi.

Petunjuk ini memastikan aplikasi Anda bebas kesalahan dan ramah pengguna. Mulai dengan mengatur Crashlytics Firebase hari ini!

2021 Panduan Android: Firebase Crashlytics - crash … yang dapat disesuaikan

Firebase Crashlytics

Persyaratan Pengaturan

Sebelum memulai, pastikan Anda telah menyelesaikan langkah-langkah berikut:

Peralatan dan Akun yang Diperlukan

Anda perlu menginstal hal-hal berikut:

  • Node.js (v16 atau lebih tinggi) dan Capacitor (v4 atau lebih tinggi)
  • A Akun Firebase dengan proyek aktif
  • Xcode 14+ untuk pengembangan iOS
  • Android Studio Electric Eel atau versi yang lebih baru untuk pengembangan Android
  • Versi terbaru dari CocoaPods (diperlukan untuk iOS)

Konfigurasi File Platform

Untuk iOS:

  • Unduh file dari Firebase Console. GoogleService-Info.plist Perbarui
  • untuk mencakup dependensi Crashlytics. Podfile Tambahkan kunci privasi yang diperlukan ke file.
  • Untuk Android: Info.plist Ambil file dari Firebase Console.

Lakukan perubahan pada baik file proyek dan file aplikasi.

  • __CAPGO_KEEP_0__ google-services.json __CAPGO_KEEP_0__
  • __CAPGO_KEEP_0__ build.gradle __CAPGO_KEEP_0__
  • Perbarui AndroidManifest.xml untuk mencakup izin yang diperlukan.

Firebase Pengaturan Konsole Firebase

Dashboard Platform Firebase

Tetapkan Firebase dan aktifkan Crashlytics melalui langkah-langkah ini:

  1. Buat proyek Firebase dan aktifkan Crashlytics.

  2. Daftarkan aplikasi Anda di Konsole Firebase:

    • Gunakan ID Paket untuk iOS dan nama paket untuk Android.
    • Unduh file konfigurasi: GoogleService-Info.plist (iOS) dan google-services.json (Android).
  3. Integrasikan SDK Firebase ke dalam aplikasi Anda dengan menambahkan dependensi berikut:

    Untuk Android (tingkat aplikasi build.gradle):

    dependencies {
        implementation platform('com.google.firebase:firebase-bom:32.0.0')
        implementation 'com.google.firebase:firebase-crashlytics'
        implementation 'com.google.firebase:firebase-analytics'
    }

    Untuk iOS (Podfile):

    pod 'Firebase/Crashlytics'
    pod 'Firebase/Analytics'

Saat langkah-langkah ini selesai, Anda siap untuk melanjutkan ke bagian Penginstalan Plugin.

Langkah-Langkah Penginstalan

Pemasangan Plugin

Lalu, sinkronkan plugin dengan platform asli Anda dan lihat @capgo/capacitor-firebase-crashlytics halaman plugin untuk referensi API yang lengkap:

npm install @capgo/capacitor-firebase-crashlytics && npx cap sync

Then, initialize Crashlytics in your app. Add the following code to app.component.ts atau main.ts:

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();

Konfigurasi Platform

Tetapkan konfigurasi yang diperlukan untuk platform Android dan iOS.

Pengaturan Android

  1. Tambahkan plugin Crashlytics Gradle ke file-level aplikasi Anda: build.gradle file:

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Aktifkan pengumpulan kegagalan di AndroidManifest.xml:

    <meta-data
        android:name="firebase_crashlytics_collection_enabled"
        android:value="true" />

Setup iOS

  1. Konfigurasi Firebase di AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

Menguji Konfigurasi Anda

Pastikan Crashlytics berfungsi dengan menjalankan tes crash dan memeriksa Console Firebase:

  • Aktifkan tes crash dengan kunci kustom:

    await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'});
    await FirebaseCrashlytics.crash();
  • Opsional, identifikasi pengguna:

    await FirebaseCrashlytics.setUserId({userId: 'user123'});
  • Logkan event kustom:

    await FirebaseCrashlytics.log({message: 'Test crash triggered'});

Laporan, termasuk jejak stack, detail perangkat, dan kunci kustom, harus muncul di Console Firebase dalam waktu sekitar 5 menit.

Penting: Hapus panggilan crash sebelum merilis aplikasi Anda. Untuk menonaktifkan pengumpulan crash selama pengembangan, gunakan:

await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});

Petunjuk Pemantauan

Setelah Anda telah mengonfirmasi konfigurasi dengan tes crash, gunakan Console Firebase untuk mengikuti crash dan kesalahan nyata di aplikasi hidup Anda.

Laporan Kecelakaan

Anda dapat menemukan laporan kecelakaan di Firebase Console di bawah bagian Crashlytics. Berikut ini yang Anda lihat:

  • Pengguna Tanpa Kecelakaan: Persentase pengguna yang belum mengalami kecelakaan.
  • Stabilitas Masalah: Berapa sering kecelakaan terjadi.
  • Analisis Dampak: Jumlah pengguna yang terpengaruh.

Klik pada setiap masalah untuk menelusuri detail lebih lanjut seperti jejak stack, informasi perangkat (misalnya, versi OS, memory), kunci kustom, log, dan perjalanan pengguna yang mengarah ke kecelakaan.

Tips Pro: Aktifkan fitur

untuk mendapatkan pemberitahuan ketika tingkat kecelakaan tiba-tiba meningkat. Ini dapat membantu Anda menangani masalah sebelum mereka mempengaruhi banyak pengguna.

  • Prioritaskan Berdasarkan Dampak: Fokus pada crash yang paling banyak mempengaruhi pengguna atau terjadi di bagian kritis aplikasi Anda. Mengikuti tren dapat membantu Anda mengidentifikasi masalah yang mendesak.

  • Pilih Kunci Sendiri: Tambahkan konteks pada laporan crash dengan kunci yang dapat disesuaikan. Misalnya:

    await FirebaseCrashlytics.setCustomKey({
      key: 'current_view',
      value: 'payment_processing'
    });
  • Grupkan Masalah yang Mirip: Manfaatkan fitur grup otomatis masalah dari Firebase. Anda juga dapat menandai crash yang terkait dengan kunci yang konsisten dan menggunakan judul yang jelas dan deskriptif untuk memudahkan pengawasan.

Mengamankan Privasi Pengguna

Untuk memastikan kewajiban dan melindungi data pengguna, ikuti pedoman berikut:

  • Izin:

    • : Sebutkan laporan crash dalam kebijakan privasi Anda.
    • Dapatkan persetujuan pengguna untuk pengumpulan data di wilayah yang mengikuti regulasi GDPR.
    • Berikan pengguna opsi untuk menolak laporan crash.
  • Kontrol Pengumpulan Data:

    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true});
  • Penyimpanan Data:

    • Atur penghapusan data otomatis setelah 90 hari.
    • Hapus informasi sensitif dari laporan Anda.
    • Gunakan kunci kustom non-identifikasi untuk menjaga privasi pengguna saat debugging.

Capgo Integrasi

Capgo Dashboard Pembaruan Langsung

Tetapkan proses dari deteksi crash hingga pengiriman perbaikan dengan menggabungkan sistem pembaruan langsung Capgo dengan Crashlytics.

Tentang Capgo

Capgo adalah alat pembaruan langsung yang dirancang khusus untuk Capacitor aplikasi. Dengan lebih dari 1.900 aplikasi di produksi dan tingkat pembaruan 95% dalam waktu 24 jam, itu memastikan perbaikan cepat tanpa menunggu persetujuan toko aplikasi. [1].

Fitur utama termasuk:

  • Enkripsi akhir ke akhir untuk pembaruan yang aman
  • Rollback satu-klik ke versi sebelumnya
  • Distribusi berbasis saluran untuk rilis yang sasaran
  • Integrasi CI/CD yang halus
  • A 100% platform terbuka

Crashlytics dan Capgo Bersama-sama

Memanfaatkan Crashlytics dengan Capgo menciptakan alur kerja yang efisien untuk mengidentifikasi dan menyelesaikan masalah dengan cepat.

Berikut cara kerjanya:

  1. Pengenalan dan Tanggapan Kecelakaan
    Crashlytics mengidentifikasi kecelakaan, dan Capgo memungkinkan Anda untuk mengembangkan perbaikan secara instan tanpa harus menunggu persetujuan toko aplikasi.

  2. Pembaruan Terfokus

    • : Tes perbaikan dengan kelompok tertentu untuk memastikan bahwa mereka efektif.Rollout Langkah demi Langkah
    • : Deploy pembaruan secara bertahap untuk mengurangi risiko.Pembaruan Darurat
    • : Segera push patch kritis untuk menyelesaikan masalah yang sangat penting.Pengawasan dan Verifikasi
  3. __CAPGO_KEEP_0__
    Setelah mengaktifkan pembaruan dengan Capgo, gunakan Crashlytics untuk mengukur tingkat kegagalan aplikasi dan memastikan masalah telah teratasi.

Keamanan dan Aturan App Store

Capgo mematuhi kebijakan Apple dan Google sambil menyediakan fitur keamanan yang kuat:

  • 82% tingkat kesuksesan global dalam mengirimkan pembaruan [1]
  • Pengendalian versi otomatis untuk organisasi yang lebih baik
  • Kemampuan untuk mematuhi pedoman pembaruan hidup di App Store

Untuk integrasi yang lebih aman dengan Crashlytics:

  • Aktifkan pengukuran kesalahan di kedua sistem.
  • Gunakan alat monitoring Capgo bersama dengan laporan Crashlytics.
  • Tetapkan pengendalian versi untuk semua pembaruan.
  • Tetapkan log yang rinci dari pembaruan untuk keperluan audit.

Lanjutkan ke bagian Pengaturan Plugin untuk mengeksplorasi alat pembaruan hidup lainnya.

Pilihan Plugin

Memilih plugin pelaporan crash yang tepat dapat sangat mempengaruhi cara Anda mengidentifikasi dan memperbaiki kesalahan di aplikasi Anda.

Berikut adalah perbandingan cepat dari Crashlytics dengan alat-alat pelaporan kesalahan populer lainnya untuk Capacitor:

  • Sentry: Menawarkan tingkat gratis dengan rencana berbayar mulai dari $26/bulan. Mendukung lebih dari 30 platform dan menyediakan pemantauan kesalahan waktu nyata dengan konteks yang rinci.
  • Bugsnag: Mulai dari $47/bulan. Meliputi baik platform mobile maupun web, dengan fitur pengelompokan kesalahan otomatis dan pemantauan rilis.
  • Rollbar: Dibanderol mulai dari $31/bulan. Berfungsi di berbagai platform, dengan fitur seperti pemantauan pengembangan dan pemantauan orang.

Crashlytics sangat menarik bagi tim yang sudah menggunakan Firebase, terutama karena integrasinya yang halus dan tingkat gratis.

Ringkasan

Berikut adalah pandangan cepat tentang apa yang telah Anda capai dan apa yang akan datang selanjutnya:

Ringkasan Langkah Pengaturan

Anda telah menyelesaikan tiga langkah kunci untuk memulai:

  • Membuat proyek Firebase dan mendaftarkan aplikasi iOS/Android Anda.
  • Menginstal dan mengonfigurasi plugin Crashlytics.
  • Mengupdate file platform iOS dan Android yang diperlukan.

Mengapa Mengintegrasikan Alat-Alat Ini?

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and Berikut ini apa yang kombinasi ini tawarkan:Perbaikan Instan

  • : Mengirimkan pembaruan instan dan mengembalikan perubahan dengan hanya satu klik.Peluncuran yang Terpercaya
  • Penggunaan yang lebih stabil: Pastikan pembaruan dapat diterima luas dan disampaikan dengan lancar kepada pengguna.

Apa yang Saja Lakukan Selanjutnya?

  1. Nyalakan analitik kecelakaan rinci di Firebase Console.
  2. Tambahkan Capgo ke pipeline CI/CD Anda untuk pembaruan yang lebih terstruktur.
  3. Gunakan Capgo saluran untuk menguji dan merilis perbaikan secara bertahap.

Dengan Crashlytics dan Capgo dalam tempat, Anda sudah siap untuk menjaga aplikasi Anda berjalan lancar dan terus meningkatkan waktu.

Lanjutkan dari Firebase Crashlytics untuk Aplikasi Capacitor

Jika Anda menggunakan Firebase Crashlytics untuk Aplikasi Capacitor untuk merencanakan kerja plugin native, hubungkannya dengan Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic, dan Capgo Build Nativ untuk alur kerja produk di Capgo Build Nativ.

Pembaruan Langsung untuk Aplikasi Capacitor

Ketika bug layer web masih aktif, kirimkan perbaikan melalui Capgo daripada menunggu hari-hari untuk persetujuan toko aplikasi. Pengguna mendapatkan pembaruan di latar belakang sementara perubahan native tetap dalam jalur ulasan normal.

Mulai Sekarang

Terbaru dari Blog Kami

Capgo memberikan Anda wawasan terbaik yang Anda butuhkan untuk menciptakan aplikasi mobile yang profesional.