Firebase Crashlytics per le app Capacitor

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é Utilizzare Crashlytics?
- Ottenere avvisi di crash in tempo reale.
- Analizzare dettagliati rapporti di crash con gruppo automatico di issue.
- Monitorare 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 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 prova:
```
await FirebaseCrashlytics.crash();
```
Consiglio Bonus: Combina Crashlytics con Capgo per aggiornamenti in tempo reale senza ritardi degli store app.

Questa guida assicura che la tua app sia crash-free e utente-friendly. Inizia a configurare Firebase Crashlytics oggi stesso!

Guida 2021 per Android: Firebase Crashlytics - crash … personalizzati

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

__CAPGO_KEEP_0__

Ottenere il file dal Console di Firebase. google-services.json Modificare sia i file a livello di progetto che a livello di app.
Aggiornare il build.gradle per includere i permessi richiesti.
Firebase AndroidManifest.xml Configurazione del Console di Firebase

Pannello di controllo della piattaforma Firebase Configura Firebase e abilita Crashlytics seguendo questi passaggi:

Crea un progetto di Firebase

e abilita Crashlytics.

Obtain the file from the Firebase Console. Make changes to both the project-level and app-level files.
Registra le tue app nel 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).

Integra i SDK di Firebase nelle tue 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

In primo luogo, installa il plugin e sincralo con Capacitor:

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

Poi, inizializza Crashlytics nell'app. 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

Aggiungi il plugin Crashlytics Gradle al tuo 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'

Abilita la raccolta degli crash in: AndroidManifest.xml:

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

Configurazione iOS

Configura Firebase in: AppDelegate.swift:
```
import Firebase
FirebaseApp.configure()
```

Verifica la tua configurazione eseguendo:

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 report, compresi i tracce 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 configurazione con un crash di test, 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 nella Console di Firebase nella sezione Crashlytics. Ecco cosa vedrai:

Utenti senza crash: La percentuale di utenti che non hanno subito crash.
Stabilità dell'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 del 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 "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 dell'app. La tracciatura delle tendenze può aiutarti a identificare le questioni 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 descrittivi chiari per una tracciatura più facile.

Protezione della 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 debug.

Capgo Integrazione

Capgo Dashboard di Aggiornamento in Tempo Reale

Semplificare il processo dalla detezione degli errori al deployment 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 ritardi delle approvazioni delle librerie di app [1].

Le principali caratteristiche includono:

Crittografia end-to-end per aggiornamenti sicuri
Ritorno automatico a versioni precedenti con un solo clic
Distribuzione basata su canali per rilasci mirati
Integrazione CI/CD senza soluzione di continuità
A piattaforma open-source del 100%

Crashlytics e Capgo insieme

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

Ecco come funziona:

Detezione e Risposta degli Crash
Crashlytics identifica un crash e Capgo consente di distribuire le correzioni immediatamente senza dover attendere l'approvazione delle app store.
Aggiornamenti mirati
- Test di beta: Testare le correzioni con un gruppo specifico per assicurarsi che siano efficaci.
- Distribuzione graduale: Distribuire gli aggiornamenti in modo graduale per ridurre i rischi.
- Risoluzione di Emergenza: Inviare velocemente patch critiche per risolvere problemi urgenti.
Monitoraggio e Verifica
Dopo aver distribuito gli aggiornamenti con Capgo, utilizzare Crashlytics per tracciare le percentuali di crash e confermare che il problema è risolto.

Sicurezza e Regole per le 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 in tempo reale delle app store

Per l'integrazione sicura con Crashlytics:

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

Continua alla sezione Opzioni Plugin per esplorare altri strumenti di aggiornamento in tempo reale.

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

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 a $26/mese. Supporta oltre 30 piattaforme e fornisce un monitoraggio degli errori in tempo reale con contesto dettagliato.
Bugsnag: Inizia a $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 i team che già utilizzano Firebase, grazie alla sua integrazione liscia e a un livello gratuito.

Riepilogo

Ecco un'occhiata rapida a ciò che hai realizzato e a ciò che ti aspetta:

Riepilogo dei passaggi 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 ottieni un sistema potente per il tracciamento degli errori e la gestione degli aggiornamenti. Ecco cosa offre questa combinazione:gestione degli aggiornamenti

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

Cosa è successo dopo?

Abilita analisi dettagliate degli errori nel Console di Firebase.
Aggiungi Capgo alla tua pipeline CI/CD per aggiornamenti semplificati.
Usa Capgo canali per testare e rilasciare i ripari passo dopo passo.

Con Crashlytics e Capgo in uso, sei pronto per 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 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, Aggiunta o Aggiornamento dei Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento dei 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.