Firebase Crashlytics per Capacitor Applicazioni Mobili

Firebase Crashlytics aiuta a tracciare i crash degli app in tempo reale, fornendo dettagliati rapporti per risolvere gli issue velocemente. Si integra in modo trasparente con Capacitor per entrambe le app iOS e Android. Ecco cosa devi sapere:

• Perché Usare Crashlytics?

  • Ottenere avvisi di crash in tempo reale.
  • Analizzare dettagliati rapporti di crash con gruppo automatico degli issue.
  • Monitorare gli 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 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();

• Consiglio 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-frendly. Inizia configurando Firebase Crashlytics oggi stesso!

Guida 2021 Android: Firebase Crashlytics - crash …

Requisiti di configurazione

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

Software e account richiesti

Avrà 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 della piattaforma

Per iOS:

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

Per Android:

• Ottenere il google-services.json file dal Console di Firebase.
• Apportare modifiche a entrambi i file di livello di progetto e di app. build.gradle Aggiornare il
• per includere i permessi richiesti. AndroidManifest.xml Console di Firebase

Setup di Console di Firebase Pannello di controllo della piattaforma Firebase

Creare un progetto di Firebase

1. e abilitare Crashlytics. __CAPGO_KEEP_0__

2. Registra le tue app nella Console di Firebase:

   • Usa l' 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 nella tua app aggiungendo queste dipendenze:

   For Android (app-level 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'
   }

   For 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

Prima, installa il plugin e sincralo con Capacitor:

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

Poi, inizializza Crashlytics nell'applicazione. Aggiungi i seguenti 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

1. Aggiungi il plugin Crashlytics al file di livello dell'applicazione: 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" />

Configurazione iOS

1. Configura Firebase in AppDelegate.swift:

   import Firebase
   FirebaseApp.configure()

Verifica la configurazione eseguendo un test:

Verifica che Crashlytics funzioni correttamente eseguendo un crash di test e controllando il Console di Firebase:

• Lancia un crash di test 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 rapporti, compresi i tracciati di stack, i dettagli del dispositivo e le chiavi personalizzate, dovrebbero apparire nella Console di Firebase entro circa 5 minuti.

Importante: Rimuovi 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 tua configurazione con un crash di test, utilizza il Firebase Console per tracciare i crash reali e gli errori nel tuo 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à dell'issue: Quante volte i crash stanno avvenendo.
• 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), le chiavi personalizzate, i log e la navigazione dell'utente che ha portato al crash.

Prodotto consigliato: Abilita la funzione di "avvisi di velocità" per essere informato quando le tassi di crash aumentano improvvisamente. Ciò può aiutarti a risolvere i problemi prima che si ripercuotano su molti utenti.

Consigli per la gestione degli errori

• Priorità per l'impatto: Concentrati sui crash che interessano il maggior numero di utenti o si verificano in parti critiche del tuo 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 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 la conformità e tutelare i dati degli utenti, segui queste linee guida:

• Autorizzazioni:

  • Menziona la segnalazione degli errori nella tua politica sulla privacy.
  • Ottenere il consenso degli utenti per la raccolta dei dati nelle regioni con regolamentazioni GDPR.
  • Fornire agli utenti l'opzione di disattivare la segnalazione degli errori.

• Controlli sulla Raccolta dei Dati:

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

• Ritentimento dei Dati:

  • Impostare la cancellazione automatica dei dati dopo 90 giorni.
  • Rimuovere informazioni sensibili dai tuoi rapporti.
  • Utilizzare chiavi personalizzate non identificabili per mantenere la privacy degli utenti durante la fase di debug.

Capgo Integrazione

Semplificare il processo dalla detezione degli errori alla distribuzione della correzione, 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 app. Con oltre 1.900 app in produzione e un tasso di aggiornamento del 95% entro 24 ore, assicura riparazioni rapide senza le lungaggini delle approvazioni delle librerie di app [1].

Le caratteristiche chiave includono:

• 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à
• A piattaforma completamente open-source

Crashlytics e Capgo insieme

L'utilizzo di Crashlytics con Capgo crea un flusso di lavoro efficiente per l'identificazione e la risoluzione dei problemi in modo rapido.

Ecco come funziona:

1. Rilevamento e Risposta di Crash
   Crashlytics rileva un crash e Capgo consente di distribuire le correzioni istantaneamente senza dover attendere l'approvazione delle app store.

2. Aggiornamenti mirati

   • Test di Beta: Testare le correzioni con un gruppo specifico per assicurarsi che siano efficaci.
   • Rilascio graduale: Distribuire gli aggiornamenti in modo graduale per ridurre i rischi.
   • Eccedenza di Emergenza: Inviare rapidamente patch critici per risolvere problemi urgenti.

3. Monitoraggio e Verifica
   Dopo aver distribuito gli aggiornamenti con Capgo, utilizzare Crashlytics per tracciare le percentuali di crash e confermare che il problema è stato risolto.

Sicurezza e Regole per l'App 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 per l'aggiornamento live dell'app store

Per l'integrazione sicura con Crashlytics:

• Abilitare il tracciamento degli errori in entrambi i sistemi.
• Utilizzare gli strumenti di monitoraggio di Capgo accanto ai rapporti di Crashlytics.
• Mantieni il controllo delle versioni per tutte le aggiornamenti.
• Conserva dettagliati registri degli aggiornamenti per scopi di auditing.

Continua alla sezione delle Opzioni del Plugin per esplorare altre strumenti di aggiornamento in tempo reale.

Opzioni del Plugin

La scelta del plugin di reporting degli errori può avere un impatto significativo 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 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 un 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'occhiata veloce a ciò che hai realizzato e a ciò che verrà next:

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?

Associando Crashlytics di Firebase con Capgo ottieni un potente sistema per il tracciamento degli errori e la gestione degli aggiornamenti. Ecco cosa offre questa combinazione: update management

• Soluzioni veloci: Invia aggiornamenti istantanei e annulla le modifiche con un solo clic.
• Rollout affidabile: Assicurati che gli aggiornamenti siano ampiamente adottati e consegnati in modo liscio agli utenti.

Cosa è successo dopo?

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 fix 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 Applicazioni per pianificare il lavoro dei plugin nativi, 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 i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin, Alternative dei Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative dei Plugin Enterprise Ionic, e Capgo Costruzioni Native per il workflow del prodotto in Capgo Costruzioni native.