Vai direttamente al contenuto principale

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.

Crashlytics per Applicazioni Capacitor

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

2021 Guida Android: Crashlytics Firebase - crash … personalizzato

Crashlytics Firebase

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.plist Aggiorna il tuo
  • per includere le dipendenze di Crashlytics. Podfile Aggiungi le chiavi di privacy necessarie al tuo
  • file. Info.plist Per Android:

Ottieni il file dal Console di Firebase.

  • Effettua modifiche sia al file del progetto che al file dell'applicazione. google-services.json file from the Firebase Console.
  • Update your build.gradle to include Crashlytics dependencies.
  • Aggiorna il 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. Crea un progetto Firebase e abilita 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 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

  1. Aggiungi il plugin Gradle di Crashlytics al file: build.gradle Abilita la raccolta degli crash in

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. __CAPGO_KEEP_0__ 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 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

Capgo Dashboard di aggiornamento in tempo reale dell'interfaccia

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:

  1. 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.

  2. 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
  3. : 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?

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

Aggiornamenti in tempo reale per le App Capacitor

Quando un bug nel layer web è attivo, invia la correzione attraverso Capgo invece di aspettare 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.