Vai al contenuto principale

Crashlytics di Firebase per Applicazioni Capacitor

Scopri come integrare il reporting di crash in tempo reale nelle tue app mobili con una guida passo dopo passo per la configurazione di Crashlytics per iOS e Android.

Crashlytics di Firebase per Applicazioni Capacitor

Firebase Crashlytics Aiuta a monitorare i crash degli app in tempo reale, fornendo rapporti dettagliati 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 rapporti di crash dettagliati con gruppo automatico di issue.
    • Monitorare errori critici per mantenere stabili gli app.
  • Requisiti di configurazione:

    • Installa 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 della piattaforma come Podfile (iOS) e build.gradle (Android).
  • 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 degli store di app.

Questa guida assicura che la tua app sia priva di errori e utente-frendly. Inizia a configurare Firebase Crashlytics oggi stesso!

2021 Guida per Android: Firebase Crashlytics - crash …

Firebase Crashlytics

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 A
  • 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 __CAPGO_KEEP_0__ (richiesto per iOS)

File di configurazione del 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:

  • Ottieni il google-services.json file dal Console di Firebase.
  • Modifica entrambi i file di livello di progetto e di app. build.gradle files.
  • Aggiorna il AndroidManifest.xml per includere le autorizzazioni richieste.

Firebase Console di configurazione

Pannello di controllo del Firebase Platform

Configura Firebase e abilita Crashlytics seguendo questi passaggi:

  1. Creare un progetto Firebase e abilitare Crashlytics.

  2. Registra le tue app nel Console di Firebase:

    • Utilizza l'ID del bundle per iOS e il nome del pacchetto per Android. Scarica i file di configurazione: (iOS) e
    • (Android). GoogleService-Info.plist Integra gli SDK di Firebase google-services.json aggiungendo queste dipendenze:
  3. Per Android (livello dell'app) Per iOS (

    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'
    }

    livello dell'appPodfile):

    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 pagina del plugin per il riferimento completo: @capgo/capacitor-firebase-crashlytics plugin page for the full API reference:

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

Then, initialize Crashlytics in your app. Add the following code to app.component.ts Configura le configurazioni richieste per le piattaforme Android e iOS. main.ts:

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();

Configurazione Android

Aggiungi il plugin Crashlytics Gradle all'app-level

Configurazione iOS

  1. Aggiungi il plugin Crashlytics Xcode 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 errori in AndroidManifest.xml:

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

Impostazione iOS

  1. Configura Firebase in AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

Verifica la tua impostazione:

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();
  • Opzionalmente, identifica l'utente:

    await FirebaseCrashlytics.setUserId({userId: 'user123'});
  • Registra eventi personalizzati:

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

Le relazioni, 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 errore prima di rilasciare l'app. Per disabilitare la raccolta degli errori durante lo sviluppo, utilizza:

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

Guida di monitoraggio

Una volta confermata la tua configurazione con un test di crash, utilizza il Firebase Console per tracciare i veri crash e gli errori nel tuo'app live.

Leggere i rapporti di crash

Trovi 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 OS, 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 influiscano 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 della tua app. La tracciatura delle tendenze può aiutarti a identificare le questioni urgenti.

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

Proteggere la privacy degli utenti

: Assicurati di seguire queste linee guida per garantire il rispetto della normativa e proteggere i dati degli utenti.

  • Autorizzazioni:

    • : Menziona la gestione dei crash nella tua politica sulla privacy.
    • Ottenere il consenso dell'utente per la raccolta dei dati nelle regioni con le norme GDPR.
    • Offrire agli utenti l'opzione di disdire la segnalazione degli errori.
  • Controlli sulla Raccolta dei Dati:

    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true});
  • Ritentivo dei Dati:

    • Configurare la cancellazione automatica dei dati dopo 90 giorni.
    • Rimuovere le informazioni sensibili dai tuoi rapporti.
    • Usare chiavi personalizzate non identificabili per mantenere la privacy degli utenti durante la debug.

Capgo Integrazione

Capgo Dashboard di Aggiornamento in Tempo Reale

Semplificare 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 app. 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 case di distribuzione [1].

Le caratteristiche chiave includono:

  • La crittografia end-to-end per aggiornamenti sicuri
  • La possibilità di annullare con un clic alla versione precedente
  • La distribuzione basata sul canale per rilasci mirati
  • L'integrazione CI/CD senza soluzione di continuità
  • A piattaforma open-source del 100%

Crashlytics and Capgo Together

Using Crashlytics with Capgo creates an efficient workflow for identifying and resolving issues quickly.

Ecco come funziona:

  1. Rilevamento e Risposta degli Crash
    Crashlytics identifies a crash, and Capgo allows you to deploy fixes instantly without waiting for app store approval.

  2. Aggiornamenti mirati

    • Test betacontext: Pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta breve UI 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 pianificato
    • : Distribuire gli aggiornamenti in modo graduale per ridurre i rischi.: Spedisci velocemente patch critiche per risolvere problemi urgenti.
  3. Monitoraggio e Verifica
    Dopo aver distribuito gli aggiornamenti con Capgo, utilizza Crashlytics per tracciare le percentuali di crash e confermare che il problema è risolto.

Security e Regole per l'App Store

Capgo rispetta le politiche di Apple e Google mentre 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 dell'App Store

Per un'integrazione sicura con Crashlytics:

  • Abilita il tracciamento degli errori in entrambi i sistemi.
  • Utilizza gli strumenti di monitoraggio di Capgo insieme ai rapporti di Crashlytics.
  • Conserva il controllo di versione per tutti gli aggiornamenti.
  • Conserva dettagliati registri degli aggiornamenti per scopi di auditing.

Continua alla sezione Plugin Options per esplorare altre strumentazioni per aggiornamenti in tempo reale.

Plugin Options

Scegliendo 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 altri popolari strumenti di reporting degli errori per Capacitor:

  • Sentry: Offre un piano gratuito con piani a pagamento a partire da 26€/mese. Supporta oltre 30 piattaforme e fornisce monitoraggio degli errori in tempo reale con contesto dettagliato.
  • Bugsnag: Parte da 47€/mese. Copre sia piattaforme mobili che web, presentando 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 che già utilizzano Firebase, grazie alla sua integrazione liscia e a un piano gratuito.

Riepilogo

Ecco una rapida panoramica di ciò che hai realizzato e di cosa ti aspetta:

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 Queste Funzionalità?

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

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

Cosa è successo dopo?

  1. Attiva le analisi dettagliate degli errori nel Firebase Console.
  2. Aggiungi Capgo alla tua pipeline CI/CD per aggiornamenti semplificati.
  3. Usa Capgo canali 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 App Capacitor

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 Sostituti dei Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Sostituti dei Plugin Enterprise Ionic, e Capgo Costruzioni Native per il flusso di lavoro del prodotto in Capgo Costruzioni Native.

Aggiornamenti in tempo reale per le app Capacitor

Quando un bug nel layer web è attivo, invia la correzione attraverso Capgo invece di attendere giorni per l'approvazione della store. Gli utenti ricevono l'aggiornamento in background mentre le modifiche native rimangono nel normale percorso di revisione.

Sostegno umano da parte di Martin

Inizia subito

Ultimi articoli dal nostro Blog

Capgo ti offre le migliori informazioni che ti servono per creare un'app mobile davvero professionale.