Crashlytics ti aiuta a tracciare i crash delle app in tempo reale, fornendo rapporti dettagliati per risolvere i problemi velocemente. Si integra in modo trasparente con Capacitor per applicazioni iOS e Android. Ecco cosa devi sapere:
-
Perché utilizzare Crashlytics?
- Ottenere avvisi di crash in tempo reale.
- Analizzare dettagliati rapporti di crash con gruppo automatico di problemi.
- Monitorare errori critici per mantenere stabili le app.
-
Requisiti di configurazione:
- Installare Node.js (v16+), Capacitor (v4+), e strumenti come Xcode 14+ e Android Studio Electric Eel.
- Scarica Firebase i file di configurazione (
GoogleService-Info.plistper iOS,google-services.jsonper Android). - Aggiorna i file specifici per piattaforma come
PodfileiOS ebuild.gradleAndroid.
-
Passaggi chiave:
-
Installa Crashlytics:
npm install @capgo/capacitor-firebase-crashlytics && npx cap sync -
Inizia Crashlytics nel tuo app:
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics'; await FirebaseCrashlytics.initialize();
-
-
Testa la tua configurazione:
-
Attiva un crash di test:
await FirebaseCrashlytics.crash();
-
-
Consiglio aggiuntivo: Combina Crashlytics con Capgo per aggiornamenti in tempo reale senza ritardi dell'App Store.
Questa guida assicura che la tua app sia crash-free e utente-felice. Inizia a configurare Firebase Crashlytics oggi!
2021 Guida Android: Crashlytics Firebase - crash … personalizzato

Requisiti di configurazione
Prima di immergersi, assicurati di aver completato i seguenti passaggi:
Software e account richiesti
Avrai bisogno di installare i seguenti:
- Node.js (v16 o superiore) e Capacitor (v4 o superiore)
- A 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 della piattaforma
__CAPGO_KEEP_0__
Per iOS:
- Scarica il file dal Console di Firebase.
GoogleService-Info.plistAggiorna il tuo - per includere le dipendenze di Crashlytics.
PodfileAggiungi le chiavi di privacy necessarie al tuo - file.
Info.plistPer Android:
Ottieni il file dal Console di Firebase.
- Effettua modifiche sia al file del progetto che al file dell'applicazione.
google-services.jsonfile from the Firebase Console. - Update your
build.gradleto include Crashlytics dependencies. - Aggiorna il
AndroidManifest.xmlper includere le autorizzazioni richieste.
Firebase Configurazione del Console

Configura Firebase e abilita Crashlytics seguendo questi passaggi:
-
Crea un progetto Firebase e abilita Crashlytics.
-
Registra le tue app nel Console Firebase:
- Usa l' ID del bundle per iOS e il nome del pacchetto per Android.
- Scarica i file di configurazione:
GoogleService-Info.plist(iOS) egoogle-services.json(Android).
-
Integra gli SDK di Firebase nelle tue applicazioni 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.
Istruzioni di installazione
Installazione del plugin
Poi sincronizza il plugin con le piattaforme native e vedi il @capgo/capacitor-firebase-crashlytics plugin pagina per la documentazione completa di API:
npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
Poi inizializza Crashlytics nell'app. Aggiungi i seguenti code: 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 al file:
build.gradleAbilita la raccolta degli crash inbuildscript { dependencies { classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' } } apply plugin: 'com.google.firebase.crashlytics' -
__CAPGO_KEEP_0__
AndroidManifest.xml:<meta-data android:name="firebase_crashlytics_collection_enabled" android:value="true" />
Configurazione iOS
-
Configura Firebase in
AppDelegate.swift:import Firebase FirebaseApp.configure()
Verifica la tua configurazione
Verifica che Crashlytics funzioni correttamente eseguendo un test di 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(); -
Facoltativamente, identifica un utente:
await FirebaseCrashlytics.setUserId({userId: 'user123'}); -
Registra eventi personalizzati:
await FirebaseCrashlytics.log({message: 'Test crash triggered'});
I rapporti, compresi i tracciati 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 alla monitoraggio
Una volta confermata la tua configurazione con un test di crash, utilizza il Console di Firebase per tracciare i crash e gli errori reali nella tua app live.
Leggere i rapporti di crash
Puoi trovare i rapporti di crash nel Firebase Console nella sezione Crashlytics. Ecco cosa vedrai:
- Utenti senza crash: Il percentuale di utenti che non hanno subito crash.
- Stabilità degli issue: Quante volte si verificano i crash.
- Analisi dell'impatto: Il numero di utenti colpiti.
Clicca su qualsiasi issue per approfondire i dettagli come le tracce di stack, le informazioni sul dispositivo (ad esempio, versione del sistema operativo, memoria), le chiavi personalizzate, i log e la navigazione dell'utente che ha portato al crash.
Pro consiglio: Abilita la funzione di
per essere notificato quando i tassi di crash aumentano improvvisamente. Ciò può aiutarti a risolvere i problemi prima che colpiscano molti utenti.
-
Prioritizza per Impatto: Concentrati sui crash che colpiscono il maggior numero di utenti o si verificano in parti critiche della tua app. La tracciatura delle tendenze può aiutarti a identificare problemi 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 il gruppo di problemi automatico di Firebase. Puoi anche etichettare crash correlati con chiavi personalizzate coerenti e utilizzare titoli descrittivi chiari per una tracciatura più facile.
Proteggere la Privacy degli Utenti
: Per garantire il rispetto delle norme e proteggere i dati degli utenti, segui queste linee guida:
-
Autorizzazioni:
- : Menziona la raccolta di 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 disattivare la raccolta di crash.
-
Controlli di raccolta dati:
await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false}); await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true}); -
Ritenzione dei dati:
- Configura la cancellazione automatica dei dati dopo 90 giorni.
- Elimina le informazioni sensibili dai tuoi rapporti.
- Utilizza chiavi personalizzate non identificabili per mantenere la privacy degli utenti durante la debug.
Capgo Integrazione

Semplifica il processo dalla detezione degli errori alla distribuzione della correzione associando il sistema di aggiornamento in tempo reale di Capgo a Crashlytics.
Sul Capgo
Capgo è uno strumento di aggiornamento in tempo reale progettato specificamente per Capacitor applicazioni. Con oltre 1.900 app in produzione e un tasso di aggiornamento del 95% entro 24 ore, assicura riparazioni rapide senza le ritardi delle approvazioni delle app store [1].
Le caratteristiche chiave includono:
- Crittografia end-to-end per aggiornamenti sicuri
- Ripristino automatico alle versioni precedenti
- Distribuzione basata sui canali per rilasci mirati
- Integrazione CI/CD senza soluzione di continuità
- Una piattaforma open-source al 100% Crashlytics e __CAPGO_KEEP_0__ Insieme
Crashlytics and Capgo Together
Utilizzando Crashlytics con Capgo crea un flusso di lavoro efficiente per l'identificazione e la risoluzione delle problematiche in modo rapido.
Ecco come funziona:
-
Rilevamento e Risposta degli Crash
Crashlytics rileva un crash e Capgo consente di distribuire le correzioni istantaneamente senza dover attendere l'approvazione delle app store. -
Aggiornamenti Mirati
- Test Betacontext: Pagina/Area: Pagina di marketing delle soluzioni di Capgo. Ruolo: Etichetta breve o elemento di navigazione. Visualizzato in: intestazione del sito, pagina solutions/beta-testing.astro. Chiave messaggio `solutions_beta_testing` (Test Beta delle Soluzioni).
- : Testare le correzioni con un gruppo specifico per assicurarsi che siano efficaci.Rollout Stagionale
- : Distribuire gradualmente gli aggiornamenti per ridurre i rischi.Correzione di Emergenza
-
: Inviare rapidamente patch critiche per risolvere problemi urgenti.
After averificare gli aggiornamenti con Capgo, utilizza Crashlytics per tracciare le percentuali di crash e confermare che l'errore è stato risolto.
Regole di sicurezza e App Store
Capgo rispetta le politiche di Apple e Google e fornisce funzionalità di sicurezza robuste:
- 82% di successo globale per la consegna degli aggiornamenti [1]
- Controllo di versione automatico per una migliore organizzazione
- Conformità con le linee guida per gli aggiornamenti in tempo reale degli store di app
Per l'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 tutti gli aggiornamenti.
- Conserva dettagliati registri degli aggiornamenti per scopi di auditing.
Continua alla sezione delle opzioni del Plugin per esplorare altre opzioni per gli aggiornamenti in tempo reale.
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.
Here’s a quick comparison of Crashlytics with other popular error-reporting tools for Capacitor:
- Sentry: Offre un piano gratuito con piani a pagamento che iniziano da 26€/mese. Supporta oltre 30 piattaforme e fornisce un monitoraggio degli errori in tempo reale con contesto dettagliato.
- Bugsnag: Inizia da 47€/mese. Copre sia piattaforme mobili che web, presentando il raggruppamento automatico degli errori e la tracciatura delle rilasci.
- Rollbar: Pricato da 31€/mese. Funziona su più piattaforme, con funzionalità come la tracciatura dei rilasci e la tracciatura delle persone.
Crashlytics è particolarmente attraente per le squadre che già utilizzano Firebase, grazie alla sua integrazione liscia e a un piano gratuito.
Riepilogo
: Ecco un rapido sguardo a ciò che hai realizzato e a ciò che viene successivamente:
Riepilogo delle fasi di configurazione
Hai completato tre passaggi chiave per iniziare:
- Hai creato un progetto Firebase e registrato le tue app iOS/Android.
- Hai installato e configurato il plugin Crashlytics.
- Hai aggiornato i file di piattaforma iOS e Android necessari.
Perché Integrare Questi Strumenti?
Associando Firebase Crashlytics con Capgo hai a disposizione un potente sistema per il tracking degli errori e la gestione degli aggiornamenti. aggiornamentiEcco cosa offre questa combinazione:
- Soluzioni rapide: Puoi distribuire aggiornamenti istantanei e ripristinare le modifiche con un solo clic.
- Rilasci affidabili: Assicurati che gli aggiornamenti siano ampiamente adottati e vengano consegnati in modo liscio agli utenti.
Cosa Succederà Successivamente?
- Attiva le analisi dettagliate degli errori nel Console di Firebase.
- Aggiungi Capgo alla tua pipeline CI/CD per aggiornamenti semplificati.
- Usa Capgo canali per testare e rilasciare i rimedi passo dopo passo.
Con Crashlytics e Capgo in funzione, sei pronto a mantenere il tuo app in esecuzione in modo fluido e migliorarlo nel tempo.
Continua da Firebase Crashlytics per App Capacitor
Se stai utilizzando Firebase Crashlytics per App Capacitor per pianificare il lavoro dei plugin nativi, connettilo con Direttorio Plugin Capgo per il workflow del prodotto nel Direttorio Plugin Capgo 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 Sostituti di Plugin Enterprise Ionic per il workflow del prodotto in Sostituti di Plugin Enterprise Ionic, e Capgo Costruzioni Native per il workflow del prodotto in Capgo Costruzioni Native.