Firebase Crashlytics for Capacitor Apps

Learn how to integrate real-time crash reporting into your mobile apps with a step-by-step guide on setting up Crashlytics for both iOS and Android. Scopri come integrare il reporting di crash in tempo reale nelle tue app mobili con una guida passo dopo passo per configurare Crashlytics per iOS e Android sia per iOS che per Android, Capacitor per applicazioni iOS e Android. Ecco cosa devi sapere:

• Perché Usare Crashlytics?

  • Ottieni avvisi di crash in tempo reale.
  • 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 Android Studio Electric Eel.
  • Scarica Firebase i file di configurazione (GoogleService-Info.plist per iOS, google-services.json per Android).
  • Aggiorna i file specifici per piattaforma come Podfile (iOS) e build.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 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: Crashlytics Firebase - crash … personalizzato …

Requisiti di configurazione

Prima di iniziare, assicurati di aver completato i seguenti passaggi:

Software e account richiesti

Avrai bisogno di installare i seguenti:

• Node.js (v16 o superiore) e Capacitor o versione (v4 o superiore)
• A un account di 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

Per iOS:

• Scarica il GoogleService-Info.plist file dal Console Firebase.
• Aggiorna il tuo Podfile per includere le dipendenze di Crashlytics.
• Aggiungi le chiavi di privacy necessarie al tuo Info.plist file.

Per Android:

• Otterra il google-services.json file dal Console Firebase.
• Effettua modifiche a entrambi i file build.gradle progetto e app-level.
• Aggiorna il AndroidManifest.xml __CAPGO_KEEP_0__ per includere le autorizzazioni richieste.

Firebase Configurazione del Console

Configura Firebase e abilita Crashlytics seguendo questi passaggi:

1. Crea un progetto Firebase e abilita Crashlytics.

2. Registra le tue app nel Console Firebase:

   • Utilizza il ID del bundle per iOS e il nome del pacchetto per Android.
   • Scarica i file di configurazione: GoogleService-Info.plist (iOS) e google-services.json (Android).

3. Integra gli SDK di Firebase nel tuo app 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 completate queste fasi, sei pronto a passare alla sezione dell'Installazione del Plugin.

Passaggi di Installazione

Installa il plugin

Poi sincronizza il plugin con le tue piattaforme native e vedi il @capgo/capacitor-firebase-crashlytics pagina del plugin per la documentazione completa del API:

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

Poi inizializza Crashlytics nell'app. Aggiungi i seguenti code alla 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

1. Aggiungi il plugin Crashlytics Gradle all'app-level build.gradle file:

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

2. Abilita la raccolta degli crash in AndroidManifest.xml:

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

Setup iOS

1. Configura Firebase in AppDelegate.swift:

   import Firebase
   FirebaseApp.configure()

Verifica il tuo setup

Verifica che Crashlytics funziona 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();

• Opzionalmente, identifica un utente:

  await FirebaseCrashlytics.setUserId({userId: 'user123'});

• Registra eventi personalizzati:

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

I report, compresi i tracciati di stack, i dettagli del dispositivo e le chiavi personalizzate, dovrebbero apparire nella 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 confermato il tuo setup con un test di crash, utilizza la Console di Firebase per tracciare i crash e gli errori reali nella tua app live.

Rapporto di Crisi

Puoi trovare i rapporti di crisi nel Console di Firebase sotto la sezione Crashlytics. Ecco cosa vedrai:

• Utenti senza crisi: La percentuale di utenti che non hanno subito crisi.
• Stabilità dell'issue: Quante volte le crisi stanno avvenendo.
• Analisi dell'impatto: Il numero di utenti interessati.

Clicca su qualsiasi issue per approfondire i dettagli come tracce di stack, informazioni sul dispositivo (ad esempio, versione del sistema operativo, memoria), chiavi personalizzate, log e il percorso dell'utente che ha portato alla crisi.

Pro consiglio: Abilita la funzione di

alerte di velocità

• 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 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 chiari e descrittivi per una tracciatura più facile.

Proteggere la Privacy degli Utenti

Per garantire il rispetto delle norme e tutelare i dati degli utenti, segui queste linee guida:

• Autorizzazioni:

  • Menziona la raccolta dei rapporti 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 dei rapporti di crash.

• Controlli di Raccolta Dati:

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

• Ritentione 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 di crash al deployment di correzioni, associando il sistema di aggiornamento in tempo reale di Capgo a Crashlytics.

Informazioni su Capgo

Capgo è uno strumento di aggiornamento in tempo reale progettato specificamente per Capacitor appWith oltre 1.900 app in produzione e un tasso di aggiornamento del 95% entro 24 ore, garantisce riparazioni rapide senza le ritardi delle approvazioni delle app store [1].

Le caratteristiche chiave includono:

• La crittografia end-to-end per aggiornamenti sicuri
• Ripristino automatico a versioni precedenti
• Distribuzione basata su canali per rilasci mirati
• Integrazione CI/CD senza soluzione di continuità
• Una piattaforma del 100% open-source

Crashlytics e Capgo Insieme

Usando Crashlytics con Capgo crea un workflow efficiente per identificare e risolvere problemi velocemente.

Ecco come funziona:

1. Rilevamento e Risposta di Crash
   Crashlytics rileva un crash e Capgo consente di distribuire riparazioni istantaneamente senza dover attendere l'approvazione della store.

2. Aggiornamenti Mirati

   • Test di BetaTestare riparazioni con un gruppo specifico per assicurarsi che siano efficaci.
   • Rilascio GradualeRilasciare aggiornamenti gradualmente per ridurre i rischi.
   • Soluzione di EmergenzaRilasciare patch critiche per risolvere problemi urgenti.

3. Monitoraggio e Verifica
   Dopo l'aggiornamento con Capgo, utilizzare Crashlytics per tracciare le tassi 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 l'invio 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 un'integrazione sicura con Crashlytics:

• Abilitare la tracciatura degli errori in entrambi i sistemi.
• Utilizzare gli strumenti di monitoraggio di Capgo insieme ai rapporti di Crashlytics.
• Mantieni il controllo di versione per tutti gli aggiornamenti.
• Tenere registri dettagliati degli aggiornamenti per scopi di auditing.

Continua alla sezione delle opzioni del Plugin per esplorare altre opzioni per gli aggiornamenti in tempo reale.

Opzioni Plugin

Scegliere il plugin di reporting degli errori giusto può avere un impatto significativo sul modo in cui identificare e risolvere gli errori nel tuo app.

Ecco una rapida comparazione di Crashlytics con altre popolari strumenti di reporting degli errori per Capacitor:

• Sentry: Offre un piano gratuito con piani a pagamento che iniziano da 26€/mese. Supporta oltre 30 piattaforme e fornisce il 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 una rapida occhiata a ciò che hai realizzato e a ciò che viene dopo:

Riepilogo dei passaggi di configurazione

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 di piattaforma iOS e Android necessari.

Perché Integrare Questi Strumenti?

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and Ecco cosa offre questa combinazione:Soluzioni veloci

• : Invia aggiornamenti istantanei e ripristina le modifiche con un solo clic.Esecuzioni affidabili
• Rilasci affidabili: Assicurati che gli aggiornamenti siano ampiamente adottati e consegnati in modo liscio agli utenti.

Cosa succede di nuovo?

1. Attiva le analisi dettagliate degli errori nel Console di Firebase.
2. Aggiungi Capgo al tuo pipeline CI/CD per aggiornamenti semplificati.
3. Usa Capgo canali per testare e rilasciare i ripari passo dopo passo.

Con Crashlytics e Capgo in uso, sei pronto a mantenere il tuo app in esecuzione in modo liscio e migliorarlo nel tempo.

Continua da Firebase Crashlytics per Capacitor App

Se stai utilizzando Firebase Crashlytics per Capacitor App per pianificare il lavoro dei plugin nativi, connettilo con Capgo Directory dei Plugin per il flusso di lavoro del prodotto nel Capgo Directory dei Plugin, Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, Aggiunta o Aggiornamento dei Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento dei Plugin, Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic, e Capgo Costruzione Nativa per il flusso di lavoro del prodotto in Capgo Costruzione Nativa.