Crashlytics di Firebase per app Capacitor

Martin Donadieu Content Marketer per Applicazioni __CAPGO_KEEP_0__ Apps Capacitor per applicazioni 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 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 prova:
```
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: Firebase Crashlytics - crash … personalizzato

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)
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 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 file del progetto e dell'applicazione.
Aggiorna l' AndroidManifest.xml per includere le autorizzazioni richieste.

Firebase Configurazione del Console

Pannello di controllo della piattaforma Firebase

Configura Firebase e abilita Crashlytics tramite questi passaggi:

Creare un progetto Firebase e abilitare Crashlytics.
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).

Integra gli 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 di installazione del Plugin.

Istruzioni 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

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'

__CAPGO_KEEP_0__ 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

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

Il rapporti, 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 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 Console di Firebase 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.

Suggerimento: 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. Tracciare le 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 automatico di problemi 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 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

Semplifica il processo dalla detezione degli errori alla distribuzione delle correzioni, 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 applicazioniCon 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
Il rollback a un clic verso versioni precedenti
La distribuzione basata sul canale per rilasci mirati
L'integrazione CI/CD senza soluzione di continuità
Un piattaforma del 100% open-source

Crashlytics e Capgo Insieme

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

Di seguito viene spiegato come funziona:

Rilevamento e Risposta degli Errori
Crashlytics identifica un errore e Capgo consente di distribuire soluzioni istantaneamente senza dover attendere l'approvazione della store.
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 messaggio `solutions_beta_testing` (Test Beta delle Soluzioni).
- : Testare le soluzioni con un gruppo specifico per assicurarsi che siano efficaci.Rilascio Stagionale
- : Distribuire gradualmente gli aggiornamenti per ridurre i rischi.Soluzione di Emergenza
: Inviare rapidamente patch critiche per risolvere problemi urgenti.
After averificare gli aggiornamenti con Capgo, utilizzare Crashlytics per tracciare 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 l'aggiornamento in tempo reale degli store

Per un'integrazione sicura con Crashlytics:

Abilitare la tracciatura degli errori in entrambi i sistemi.
Utilizzare gli strumenti di monitoraggio di Capgo accanto 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 delle Opzioni del Plugin per esplorare altre opzioni per l'aggiornamento 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.

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 un monitoraggio degli errori in tempo reale con contesto dettagliato.
Bugsnag: Parte 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:

Passaggi di configurazione in sintesi

Avete 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 aggiornamenti. Ecco cosa offre questa combinazione:

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

Che cosa è successo dopo?

Attiva le 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 funzione, sei pronto per mantenere il tuo app in esecuzione in modo liscio e migliorarlo nel tempo.

Continua da qui: Firebase Crashlytics per Capacitor App

Se stai utilizzando Firebase Crashlytics per Capacitor App per pianificare il lavoro dei plugin nativi, collegalo con Capgo Directory dei Plugin per il flusso di lavoro del prodotto nel 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.

Firebase Crashlytics for Capacitor Apps