Vai direttamente al contenuto principale

Firebase Crashlytics 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.

Firebase Crashlytics per Applicazioni Capacitor

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

2021 Guida Android: Firebase Crashlytics - crash … personalizzato

Firebase Crashlytics

Requisiti di configurazione

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

Software e account richiesti

Dovrai 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

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.
  • Effettua modifiche a entrambi i file del progetto e dell'applicazione. build.gradle __CAPGO_KEEP_0__
  • Aggiorna l' AndroidManifest.xml per includere le autorizzazioni richieste.

Firebase Configurazione del Console

Pannello di controllo della piattaforma Firebase

Configura Firebase e abilita Crashlytics seguendo questi passaggi:

  1. Creare un progetto Firebase e abilitare Crashlytics.

  2. 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) e google-services.json (Android).
  3. Integra gli SDK di Firebase nella tua 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 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 vedi il @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 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 Gradle di Crashlytics al tuo file di livello dell'app: build.gradle Abilita la raccolta degli errori in

    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 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 confermata la tua impostazione con un test di crash, utilizza la Console di Firebase per tracciare i veri crash e gli errori 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 errori: Quante volte si verificano i crash.
  • Analisi dell'impatto: Il numero di utenti colpiti.

Clicca su qualsiasi problema 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 il percorso 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 tutelare i dati degli utenti, segui queste linee guida:

  • Autorizzazioni:

    • : Menziona la raccolta dei dati di crash nella tua politica sulla privacy.
    • : Otteni il consenso degli utenti per la raccolta dei dati in regioni con regolamentazioni GDPR.
    • : Fornisci agli utenti l'opzione di disattivare la raccolta dei dati 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

Capgo Dashboard di Aggiornamento in Tempo Reale

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

Sul Capgo è un strumento di aggiornamento in tempo reale progettato specificamente per Sui 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 librerie di app [1].

Le caratteristiche chiave includono:

  • Crittografia end-to-end per aggiornamenti sicuri
  • Ripristino automatico verso versioni precedenti
  • Distribuzione basata sui canali per rilasci mirati
  • Integrazione CI/CD senza soluzione di continuità
  • Una piattaforma del 100% open-source Crashlytics e __CAPGO_KEEP_0__ insieme

Crashlytics and Capgo Together

Utilizzando Crashlytics con Capgo crea un workflow efficiente per l'identificazione e la risoluzione degli issue in modo rapido.

Ecco come funziona:

  1. Rilevamento e Risposta degli Crash
    Crashlytics identifica un crash e Capgo consente di distribuire le correzioni istantaneamente senza dover attendere l'approvazione della store.

  2. Aggiornamenti Mirati

    • Test Betacontext: Pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta breve o elemento di navigazione. Visualizzato in: intestazione del sito, pagina solutions/beta-testing.astro. Chiave di 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
  3. : Inviare rapidamente patch critiche per risolvere problemi urgenti.
    After l'installazione delle Capgo, utilizzare Crashlytics per monitorare le tassi di crash e confermare che l'errore è stato risolto.

Sicurezza e Regole per l'App Store

Capgo rispetta le politiche di Apple e Google, fornendo inoltre 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:

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

Continuare alla sezione Plugin Options per esplorare altre opzioni per gli aggiornamenti in tempo reale.

Opzioni del 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.

Here’s a quick comparison of Crashlytics with other popular error-reporting tools for 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: Inizia 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 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 Queste Funzionalità?

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and Aggiornamenti veloci: Puoi inviare aggiornamenti istantanei e annullare le modifiche con un solo clic.

  • Esecuzioni affidabiliAggiornamenti veloci
  • : Puoi inviare aggiornamenti istantanei e annullare le modifiche con un solo clic.: 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 alla tua pipeline CI/CD per aggiornamenti semplificati.
  3. Usa Capgo canali per testare e rilasciare i ripari passo dopo passo.

Con Crashlytics e Capgo in funzione, 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 la dettaglio di implementazione in Capacitor Plugin da Capgo, Aggiungere o Aggiornare i Plugin per la dettaglio 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.

Supporto umano da Martin

Inizia subito

Ultimi articoli dal nostro Blog

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