Langkapi ke konten utama

Firebase Crashlytics untuk Aplikasi Capacitor

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

 Martin Donadieu

Martin Donadieu

Penulis Konten

 Firebase Crashlytics untuk Aplikasi Capacitor

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

  • Mengapa Menggunakan Crashlytics?

    • Dapatkan peringatan kejadian crash waktu nyata.
    • Analisis laporan kejadian detail dengan pengelompokan masalah otomatis.
    • Pantau kesalahan kritis untuk menjaga aplikasi stabil.
  • Persyaratan Pengaturan:

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

    • Mulai Crashlytics di aplikasi Anda:

      npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
    • Uji Coba Konfigurasi Anda:

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

    • Tips Tambahan:

      await FirebaseCrashlytics.crash();
  • Combinasikan Crashlytics dengan __CAPGO_KEEP_0__ untuk pembaruan langsung tanpa penundaan toko aplikasi. Capgo __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

2021 Panduan Android: Firebase Crashlytics - crash … yang diatur sendiri

Firebase Crashlytics

Persyaratan Pengaturan

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

Perangkat Lunak dan Akun yang Diperlukan

Anda perlu menginstal hal-hal berikut:

  • Node.js (v16 atau lebih tinggi) dan Capacitor 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 Console Firebase. GoogleService-Info.plist Perbarui
  • untuk mencakup dependensi Crashlytics. Podfile Tambahkan kunci privasi yang diperlukan ke file
  • Untuk Android: Info.plist Olehkan file

Perbarui baik file tingkat proyek maupun file tingkat aplikasi.

  • untuk mencakup dependensi Crashlytics. google-services.json Tambahkan kunci privasi yang diperlukan ke file
  • Perbarui baik file tingkat proyek maupun file tingkat aplikasi. build.gradle Perbarui baik file tingkat proyek maupun file tingkat aplikasi.
  • Perbarui AndroidManifest.xml untuk mencakup izin yang diperlukan.

Firebase Pengaturan Konsole

Dashboard Platform Firebase

Set up Firebase dan aktifkan Crashlytics melalui langkah-langkah ini:

  1. Buat proyek Firebase dan aktifkan Crashlytics.

  2. Mendaftarkan aplikasi anda di Konsole Firebase:

    • Menggunakan 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-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'

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

Langkah-Langkah Penginstalan

Pemasangan Plugin

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

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

Lalu, inisialisasi Crashlytics di aplikasi Anda. Tambahkan kode berikut code ke app.component.ts atau main.ts:

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

Konfigurasi Platform

Konfigurasi yang diperlukan untuk platform Android dan iOS.

Pengaturan Android

  1. Tambahkan plugin Gradle Crashlytics ke file aplikasi Anda: build.gradle aktifkan pengumpulan kegagalan di

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Pengaturan iOS AndroidManifest.xml:

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

Konfigurasi iOS

  1. Konfigurasi Firebase di AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

Pengujian Konfigurasi Anda

Pastikan Crashlytics berfungsi dengan menguji crash uji dan memeriksa Console Firebase:

  • Trigger crash uji dengan kunci custom:

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

    await FirebaseCrashlytics.setUserId({userId: 'user123'});
  • Log event custom:

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

Laporan, termasuk jejak stack, detail perangkat, dan kunci custom, 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});

Panduan Monitoring

Saat Anda telah memastikan konfigurasi dengan crash uji, gunakan Console Firebase untuk melacak crash dan kesalahan nyata di aplikasi hidup Anda.

Laporan Kesalahan yang Dibaca

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

  • Pengguna yang Tidak Mengalami Kesalahan: Persentase pengguna yang belum mengalami kesalahan.
  • Stabilitas Masalah: Berapa sering kesalahan terjadi.
  • Analisis Dampak: Jumlah pengguna yang terpengaruh.

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

Trik Pro: Aktifkan fitur

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

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

  • Gunakan Kunci Custom: Tambahkan konteks pada laporan kecelakaan dengan kunci custom. Misalnya:

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

Melindungi Privasi Pengguna

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

  • Izin:

    • : Sebutkan laporan kecelakaan dalam kebijakan privasi Anda.
    • Minta izin pengguna untuk pengumpulan data di wilayah yang mengikuti regulasi GDPR.
    • Berikan pengguna opsi untuk keluar dari laporan kecelakaan.
  • Pengumpulan Data Kontrol:

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

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

Capgo Pengintegrasian

Dashboard Antarmuka Live Update Capgo

Alirkan proses dari deteksi crash ke pengiriman perbaikan dengan menggabungkan sistem update live Capgo dengan Crashlytics.

Tentang Capgo

Capgo adalah alat update live 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 menunda-nunda persetujuan toko aplikasi. [1].

Fitur utama termasuk:

  • Enkripsi ujung ke ujung untuk pembaruan yang aman
  • Rollback satu-klik ke versi sebelumnya
  • Distribusi berdasarkan saluran untuk rilis yang sasaran
  • Integrasi CI/CD yang halus
  • Sistem terbuka 100% Crashlytics dan __CAPGO_KEEP_0__ Bersamaan

Crashlytics and Capgo Together

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

Mengapa demikian:

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

  2. Pembaruan Terfokus

    • Pengujian Betacontext: Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: header situs, halaman solusi/pengujian-beta.astro. Kunci pesan `solutions_beta_testing` (Pengujian Beta Solusi).
    • : Uji perbaikan dengan kelompok tertentu untuk memastikan bahwa mereka efektif.Pembaruan Staged
    • : Deploy pembaruan secara bertahap untuk mengurangi risiko.Pembaruan Darurat
  3. : Segera push patch kritis untuk menyelesaikan masalah darurat.
    Setelah mengaktifkan pembaruan dengan Capgo, gunakan Crashlytics untuk mengukur tingkat kegagalan aplikasi dan memastikan masalah telah teratasi.

Keamanan dan Aturan Toko Aplikasi

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
  • Pengaturan kompatibilitas dengan pedoman pembaruan aplikasi toko hidup

Untuk integrasi yang lebih aman dengan Crashlytics:

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

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

Opsi Plugin

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

Berikut adalah perbandingan cepat Crashlytics dengan 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 pelacakan rilis.
  • Rollbar: Dihargai dari $31/bulan. Berfungsi di berbagai platform, dengan fitur seperti pelacakan pengiriman dan pelacakan 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

Kamu telah menyelesaikan tiga langkah kunci untuk memulai:

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

Mengapa Mengintegrasikan Alat-Alat Ini?

Menggabungkan Crashlytics Firebase dengan Capgo memberikanmu sistem yang kuat untuk pemantauan kesalahan dan pengelolaan pembaruan. Berikut ini apa yang ditawarkan kombinasi ini:Pembaruan Instan

  • : Kirim pembaruan instan dan kembali ke perubahan dengan hanya satu klik.Rollout yang Terpercaya
  • Quick fixesPastikan pembaruan dapat diterima luas dan disampaikan dengan lancar kepada pengguna.

Apakah yang akan datang?

  1. Nyalakan analisis kecelakaan rinci di Firebase Console.
  2. Tambahkan Capgo ke pipeline CI/CD Anda untuk pembaruan yang lebih terstruktur.
  3. Pilih 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.

Teruskan dari Firebase Crashlytics untuk Aplikasi Capacitor

Jika Anda menggunakan Firebase Crashlytics untuk Aplikasi Capacitor untuk merencanakan kerja plugin native, hubungkannya dengan Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, 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 Pembangunan Nativ untuk alur kerja produk di Capgo Pembangunan 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 review normal.

Dukungan Manusia dari Martin

Mulai Sekarang

Terbaru dari Blog Kami

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