Firebase Crashlytics untuk Aplikasi Capacitor

Firebase Crashlytics membantu Anda melacak kejadian crash aplikasi secara waktu nyata, menyediakan 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 kejadian crash waktu nyata.
- Analisis laporan kejadian crash yang 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 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();

Tes Konfigurasi Anda:
- Aktifkan Crash Test:
```
await FirebaseCrashlytics.crash();
```
Tips Tambahan: Gabungkan Crashlytics dengan Capgo untuk pembaruan langsung tanpa menunggu proses App Store.

Petunjuk ini memastikan aplikasi Anda bebas crash 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:

Perangkat Lunak 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 Update file __CAPGO_KEEP_0__ Anda untuk mencakup dependensi Crashlytics.
Tambahkan kunci privasi yang diperlukan ke file __CAPGO_KEEP_0__ Anda. Podfile Untuk Android:
Ambil file __CAPGO_KEEP_0__ dari Firebase Console. Info.plist Lakukan perubahan pada baik file __CAPGO_KEEP_1__ maupun file __CAPGO_KEEP_2__.

Lakukan perubahan pada baik file __CAPGO_KEEP_1__ maupun file __CAPGO_KEEP_2__.

Lakukan perubahan pada baik file __CAPGO_KEEP_1__ maupun file __CAPGO_KEEP_2__. google-services.json Lakukan perubahan pada baik file __CAPGO_KEEP_1__ maupun file __CAPGO_KEEP_2__.
Lakukan perubahan pada baik file __CAPGO_KEEP_1__ maupun file __CAPGO_KEEP_2__. build.gradle Lakukan perubahan pada baik file __CAPGO_KEEP_1__ maupun file __CAPGO_KEEP_2__.
Perbarui AndroidManifest.xml __CAPGO_KEEP_0__ untuk mencakup izin yang diperlukan.

Firebase Pengaturan Console Firebase

Dashboard Firebase Platform

Tetapkan Firebase dan aktifkan Crashlytics melalui langkah-langkah ini:

Buat proyek Firebase dan aktifkan Crashlytics.
Daftarkan aplikasi Anda di Console Firebase:
- Gunakan ID Bundle untuk iOS dan __CAPGO_KEEP_0__ untuk Android.
- Unduh file konfigurasi: GoogleService-Info.plist (iOS) dan google-services.json (Android).

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

Pertama, instal plugin dan sinkronisasikan dengan Capacitor:

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

Kemudian, 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

Tetapkan konfigurasi yang diperlukan untuk platform Android dan iOS.

Pengaturan Android

Tambahkan plugin Crashlytics Gradle ke file build.gradle file:

buildscript { 
    dependencies { 
        classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
    } 
}
apply plugin: 'com.google.firebase.crashlytics'

Aktifkan pengumpulan crash di AndroidManifest.xml:

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

Pengaturan iOS

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 melacak crash dan kesalahan yang sebenarnya di aplikasi hidup Anda.

Membaca Laporan Crash

Anda dapat menemukan laporan kecelakaan di Firebase Console di bawah bagian Crashlytics.

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 menyebabkan kecelakaan.

Tips Pro: Aktifkan fitur

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

Tips Manajemen Kesalahan: Fokus pada kegagalan 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 ke laporan kegagalan dengan menggunakan kunci custom. Misalnya:

await FirebaseCrashlytics.setCustomKey({
  key: 'current_view',
  value: 'payment_processing'
});

Grupkan Masalah yang Mirip: Manfaatkan grup otomatis masalah dari Firebase. Anda juga dapat menandai kegagalan terkait dengan kunci custom 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 kegagalan dalam kebijakan privasi Anda.
- Dapatkan persetujuan pengguna untuk pengumpulan data di wilayah dengan regulasi GDPR.
- Berikan pengguna opsi untuk keluar dari laporan kegagalan.

Kontrol Pengumpulan Data:

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

Penghapusan Data:
- Atur penghapusan data otomatis setelah 90 hari.
- Bersihkan informasi sensitif dari laporan Anda.
- Gunakan kunci kustom tidak dapat diidentifikasi untuk menjaga privasi pengguna saat debugging.

Capgo Integrasi

Capgo Dashboard Pembaruan Langsung

Sederhanakan 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 aplikasiDengan lebih dari 1.900 aplikasi di produksi dan tingkat pembaruan 95% dalam 24 jam, itu memastikan perbaikan cepat tanpa menunggu persetujuan toko aplikasi [1].

Fitur-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 sumber terbuka

Crashlytics dan Capgo Bersamaan

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

Berikut cara kerjanya:

Deteksi dan Tanggapan Kecelakaan
Crashlytics mengidentifikasi kecelakaan, dan Capgo memungkinkan Anda untuk mengaktifkan perbaikan secara langsung tanpa menunggu persetujuan toko aplikasi.
Pembaruan Terfokus
- Pengujian Beta: Uji perbaikan dengan kelompok tertentu untuk memastikan bahwa mereka efektif.
- Pembaruan Langkah demi Langkah: Deploy pembaruan secara bertahap untuk mengurangi risiko.
- Perbaikan Darurat: Segera push patch kritis untuk menyelesaikan masalah darurat.
Pantauan dan Verifikasi
Setelah mengaktifkan pembaruan dengan Capgo, gunakan Crashlytics untuk melacak tingkat kecelakaan dan memastikan bahwa masalah telah teratasi.

Aturan Aplikasi Toko

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

82% tingkat kesuksesan global untuk mengirimkan pembaruan [1]
Kontrol versi otomatis untuk organisasi yang lebih baik
Kemampuan untuk mematuhi pedoman pembaruan hidup di toko aplikasi

Untuk integrasi yang lebih aman dengan Crashlytics:

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

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

Pengaturan Plugin

Pilih plugin pelaporan kecelakaan 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 dan web, dengan fitur pengelompokan otomatis kesalahan dan pelacakan rilis.
Rollbar: Dihargai dari $31/bulan. Berfungsi di beberapa platform, dengan fitur seperti pelacakan pengembangan 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:

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?

Menggabungkan Firebase Crashlytics dengan Capgo memberikan Anda sistem yang kuat untuk mengidentifikasi dan mengelola kesalahan. Berikut ini apa yang ditawarkan kombinasi ini:

Perbaikan cepat: Mengirimkan pembaruan instan dan mengembalikan perubahan dengan hanya satu klik.
Peluncuran yang dapat diandalkan: Menjamin pembaruan diterima secara luas dan disampaikan kepada pengguna dengan lancar.

Apa Saja Selanjutnya?

Aktifkan analisis kecelakaan rinci di Firebase Console.
Tambahkan Capgo ke pipeline CI/CD Anda untuk pembaruan yang lebih terstruktur.
Gunakan Capgo saluran untuk menguji dan merilis perbaikan langkah demi langkah.

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