Firebase Crashlytics ti aiuta a tracciare i crash delle app in tempo reale, fornendo rapporti dettagliati per risolvere gli issue velocemente. Si integra in modo trasparente con Capacitor per entrambe le applicazioni iOS e Android. Ecco cosa devi sapere:
-
Perché Usare Crashlytics?
- Ottenere real-time crash alerts.
- Analizza dettagliati rapporti di crash con gruppo automatico di problemi.
- Monitora errori critici per mantenere stabili le app.
-
Requisiti di configurazione:
- Installa Node.js (v16+), Capacitor (v4+), e strumenti come Xcode 14+ e Studio di Android Eel elettrico.
- Scarica Firebase i file di configurazione (
GoogleService-Info.plistper iOS,google-services.jsonper Android). - Aggiorna i file specifici della piattaforma come
Podfile(iOS) ebuild.gradle(Android).
-
Passaggi chiave:
-
Installa Crashlytics:
npm install @capgo/capacitor-firebase-crashlytics && npx cap sync -
Inizializza Crashlytics nell'app:
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics'; await FirebaseCrashlytics.initialize();
-
-
Testa la tua configurazione:
-
Attiva un test di crash:
await FirebaseCrashlytics.crash();
-
-
Suggerimento Bonus: Combina Crashlytics con Capgo per aggiornamenti in tempo reale istantanei senza ritardi dell'App Store.
Questa guida assicura che la tua app sia crash-free e utente-friendly. Inizia a configurare Firebase Crashlytics oggi stesso!
Guida Android 2021: Firebase Crashlytics - crash …

Requisiti di configurazione
Prima di iniziare, assicurati di aver completato i seguenti passaggi:
Software e account richiesti
Hai bisogno di installare i seguenti:
- Node.js (v16 o superiore) e Capacitor (v4 o superiore)
- Un account Firebase con un progetto attivo
- Xcode 14+ per lo sviluppo di iOS
- Android Studio Electric Eel o una versione più recente per lo sviluppo di Android
- La versione più recente di CocoaPods (richiesto per iOS)
File di configurazione del piattaforma
Per iOS:
- Scarica il
GoogleService-Info.plistfile dal Console di Firebase. - Aggiorna il
PodfileIncludere le dipendenze di Crashlytics. - Aggiungere le chiavi di privacy necessarie al tuo
Info.plistfile.
Per Android:
- Ottenere il
google-services.jsonfile dal Console Firebase. - Effettuare modifiche a entrambi i file
build.gradledel progetto e dell'applicazione. - Aggiornare il
AndroidManifest.xmlper includere le autorizzazioni richieste.
Console di Firebase Configurazione Console di Firebase

Configura Firebase e abilita Crashlytics seguendo questi passaggi:
-
Crea un progetto di Firebase e abilita Crashlytics.
-
Registra le tue app nel Console di Firebase:
- Utilizza il ID bundle per iOS e il nome pacchetto per Android.
- Scarica i file di configurazione:
GoogleService-Info.plist(iOS) egoogle-services.json(Android).
-
Integra gli SDK Firebase aggiungendo queste dipendenze:
Per Android (livello dell'app
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' }Per iOS (
Podfile):pod 'Firebase/Crashlytics' pod 'Firebase/Analytics'
Una volta completati questi passaggi, sei pronto a passare alla sezione dell'installazione del plugin.
Passaggi di installazione
Installazione del plugin
Poi sincronizza il plugin con le tue piattaforme native e consulta la @capgo/capacitor-firebase-crashlytics pagina del plugin per la documentazione completa di API:
npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
Infine, inizializza Crashlytics nell'applicazione. Aggiungi il seguente code a app.component.ts o main.ts:
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();
Configurazione della piattaforma
Configura le configurazioni richieste per le piattaforme Android e iOS.
Configurazione Android
-
Aggiungi il plugin Gradle di Crashlytics all'app-level
build.gradlefile:buildscript { dependencies { classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' } } apply plugin: 'com.google.firebase.crashlytics' -
Abilita la raccolta degli crash in
AndroidManifest.xml:<meta-data android:name="firebase_crashlytics_collection_enabled" android:value="true" />
Configurazione iOS
-
Configura Firebase in
AppDelegate.swift:import Firebase FirebaseApp.configure()
Test della configurazione
Verifica che Crashlytics funzioni correttamente eseguendo un test crash e controllando il Console di Firebase:
-
Attiva un test di crash con una chiave personalizzata:
await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'}); await FirebaseCrashlytics.crash(); -
Opzionalmente, identifica l'utente:
await FirebaseCrashlytics.setUserId({userId: 'user123'}); -
Registra eventi personalizzati:
await FirebaseCrashlytics.log({message: 'Test crash triggered'});
I rapporti, compresi i tracce di stack, i dettagli del dispositivo e le chiavi personalizzate, dovrebbero apparire nel Console di Firebase entro circa 5 minuti.
Importante: Elimina le chiamate di crash prima di rilasciare la tua app. Per disabilitare la raccolta di crash durante lo sviluppo, utilizza:
await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
Guida di Monitoraggio
Una volta confermata la configurazione con un test di crash, utilizza la Console di Firebase per tracciare i crash e gli errori reali nella tua app in esecuzione.
Leggi i Rapporti di Crash
Puoi trovare i rapporti di crash nella Console di Firebase nella sezione Crashlytics. Ecco cosa vedrai:
- Utenti senza crash: La percentuale di utenti che non hanno subito crash.
- Stabilità degli issue: Quante volte si verificano gli errori.
- Analisi dell'impatto: Il numero di utenti interessati.
Clicca su qualsiasi issue per approfondire i dettagli come le tracce di stack, le informazioni sul dispositivo (ad esempio, versione del sistema operativo, memoria), chiavi personalizzate, log e il percorso dell'utente che ha portato allo crash.
Pro consiglio: Abilita la funzione di “avvisi di velocità” per essere notificato quando le tassi di crash aumentano improvvisamente. Ciò può aiutarti a risolvere i problemi prima che si ripercuotano su molti utenti.
Suggerimenti per la gestione degli errori
-
Priorità per l'impatto: Concentrati sugli errori che interessano più utenti o si verificano in parti critiche della tua app. La tracciatura delle tendenze può aiutarti a identificare le questioni urgenti.
-
Usa chiavi personalizzate: Aggiungi contesto ai tuoi rapporti di crash con chiavi personalizzate. Ad esempio:
await FirebaseCrashlytics.setCustomKey({ key: 'current_view', value: 'payment_processing' }); -
Gruppa Problemi Simili: Sfrutta l'automatico raggruppamento dei problemi di Firebase. Puoi anche etichettare i crash correlati con chiavi personalizzate coerenti e utilizzare titoli descrittivi chiari per una tracciatura più facile.
Protezione della Privacy Utente
Per garantire il rispetto delle norme e tutelare i dati degli utenti, segui queste linee guida:
-
Autorizzazioni:
- Menziona la segnalazione dei crash nella tua politica sulla privacy.
- Otteni il consenso degli utenti per la raccolta dei dati nelle regioni con regolamentazioni GDPR.
- Fornisci agli utenti l'opzione di opt-out dalla segnalazione dei crash.
-
Controlli sulla Raccolta dei Dati:
await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false}); await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true}); -
Ritiro dei Dati:
- Configura la cancellazione automatica dei dati dopo 90 giorni.
- Pulisci le informazioni sensibili dai tuoi rapporti.
- Usare chiavi personalizzate non identificabili per mantenere la privacy degli utenti durante la debuggazione.
Capgo Integrazione

Semplificare il processo dalla detezione degli errori alla distribuzione della correzione congiungendo il sistema di aggiornamento in tempo reale di Capgo con Crashlytics.
Informazioni su Capgo
Capgo è uno strumento di aggiornamento in tempo reale progettato specificamente per le app Capacitor. Con oltre 1.900 app in produzione e un tasso di aggiornamento del 95% entro 24 ore, assicura correzioni rapide senza le ritardi delle approvazioni delle app store [1].
Le caratteristiche principali includono:
- Crittografia end-to-end per aggiornamenti sicuri
- Rollback un clic versi crime precedenti
- Distribuzione basata su canali per rilasci mirati
- Integrazione CI/CD senza soluzione di continuità
- A Piattaforma del 100% open-source
Crashlytics e Capgo Insieme
L'uso di Crashlytics con Capgo crea un flusso di lavoro efficiente per l'identificazione e la risoluzione dei problemi in modo rapido.
Ecco come funziona:
-
Detezione e Risposta di Crash
Crashlytics identifica un crash e Capgo consente di distribuire correzioni istantaneamente senza dover attendere l'approvazione della store per l'app. -
Aggiornamenti mirati
- Test di beta: Testare le correzioni con un gruppo specifico per assicurarsi che siano efficaci.
- Rollout graduale: Distribuire gradualmente gli aggiornamenti per ridurre i rischi.
- Rimedi di emergenza: Inviare rapidamente patch critiche per risolvere problemi urgenti.
-
Monitoraggio e verifica
: Dopo aver distribuito gli aggiornamenti con Capgo, utilizzare Crashlytics per tracciare le percentuali di crash e confermare che il problema sia risolto.
Regole di sicurezza e Store
Capgo rispetta le politiche di Apple e Google mentre fornisce funzionalità di sicurezza solide:
- 82% di successo globale per la consegna degli aggiornamenti [1]
- Controllo di versione automatico per una migliore organizzazione
- Conformità con le linee guida di aggiornamento live degli store di app
Per un'integrazione sicura con Crashlytics:
- Abilita la tracciatura degli errori in entrambi i sistemi.
- Utilizza gli strumenti di monitoraggio di Capgo accanto ai rapporti di Crashlytics.
- Mantieni il controllo di versione per tutte le aggiornamenti.
- Conserva registrazioni dettagliate degli aggiornamenti per fini di auditing.
Continua alla sezione delle Opzioni del Plugin per esplorare altri strumenti di aggiornamento live.
Opzioni del Plugin
Scegliendo il plugin di reporting degli errori giusto può avere un grande impatto sul modo in cui identifichi e correggi gli errori nel tuo app.
Ecco una rapida comparazione di Crashlytics con altri popolari strumenti di reporting degli errori per Capacitor:
- Sentry: Offre un livello gratuito con piani a pagamento a partire da 26€/mese. Supporta oltre 30 piattaforme e fornisce la monitoraggio degli errori in tempo reale con contesto dettagliato.
- Bugsnag: Inizia a 47€/mese. Copre sia le piattaforme mobili che web, con raggruppamento automatico degli errori e tracciamento delle rilasci.
- Rollbar: Pricato da 31€/mese. Funziona su più piattaforme, con funzionalità come tracciamento delle rilasci e tracciamento delle persone.
Crashlytics è particolarmente attraente per le squadre già utilizzanti Firebase, grazie alla sua integrazione liscia e a un livello gratuito.
Summary
Ecco un rapido sguardo a ciò che hai realizzato e a ciò che ti aspetta:
Setup Steps Recap
Hai completato tre passaggi chiave per iniziare:
- Creato un progetto Firebase e registrato le tue app iOS/Android.
- Installato e configurato il plugin Crashlytics.
- Aggiornato i file delle piattaforme iOS e Android necessari.
Perché Integrare Questi Strumenti?
L'associazione di Firebase Crashlytics con Capgo offre un sistema potente per il tracciamento degli errori e la gestione degli aggiornamenti. aggiornamento. Ecco cosa offre questa combinazione:
- Soluzioni rapide: Invia aggiornamenti istantanei e annulla le modifiche con un solo clic.
- Esecuzioni affidabili: Assicurati che gli aggiornamenti siano ampiamente adottati e che siano consegnati ai utenti in modo liscio.
Cosa Succede di Successivo?
- Attiva le analisi dettagliate degli errori nel Console di Firebase.
- Aggiungi Capgo al tuo pipeline CI/CD per aggiornamenti semplificati.
- Usa canali Capgo per testare e rilasciare le correzioni passo dopo passo.
Con Crashlytics e Capgo in funzione, sei pronto per mantenere il tuo app in esecuzione in modo fluido e migliorarlo nel tempo.
Continua da Firebase Crashlytics per Capacitor App
Se stai utilizzando Firebase Crashlytics per Capacitor App per pianificare il lavoro di plugin nativo, connettilo con Capgo Directory dei Plugin per il flusso di lavoro del prodotto in Capgo Directory dei Plugin, Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, Aggiungere o Aggiornare Plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin, Alternative Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative Plugin Enterprise Ionic, e Capgo Costruzione Nativa per il flusso di lavoro del prodotto in Capgo Costruzione Nativa.