Salta al contenuto principale

Firebase Crashlytics Plugin Capacitor

plugin Capacitor per Firebase Crashlytics

Installa

bun add @capgo/capacitor-firebase-crashlytics bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-firebase-crashlytics
  • pnpm add @capgo/capacitor-firebase-crashlytics
  • yarn add @capgo/capacitor-firebase-crashlytics

Guida

Come usare Firebase Crashlytics in Capacitor

Utilizzo di @capgo/capacitor-firebase-crashlytics

Plugin Capacitor per Firebase Crashlytics.

Installa

bun add @capgo/capacitor-firebase-crashlytics
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

API in breve

Metodo Descrizione
crash Forza un crash per testare l'implementazione.
setCustomKey Imposta una chiave e un valore personalizzati associati ai successivi report di errori fatali e non fatali.
setUserId Imposta un ID utente (identificativo) associato ai successivi report di errori fatali e non fatali.
log Aggiunge un messaggio di log personalizzato inviato con i dati del crash, per avere più contesto sugli eventi che precedono un crash.
setEnabled Abilita/disabilita la raccolta automatica dei dati. Il valore non viene applicato fino al prossimo avvio dell'app.
isEnabled Restituisce se la raccolta automatica dei dati è abilitata o meno.
didCrashOnPreviousExecution Restituisce se l'app è andata in crash durante l'esecuzione precedente.
sendUnsentReports Carica i report non inviati su Crashlytics al prossimo avvio.
deleteUnsentReports Elimina i report non inviati dal dispositivo.
recordException Registra un report non fatale da inviare a Crashlytics.

Esempi

crash()

Forza un crash per testare l'implementazione.

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

await FirebaseCrashlytics.crash({ message: 'Hello from Capacitor' });

setCustomKey()

Imposta una chiave e un valore personalizzati associati ai successivi report di errori fatali e non fatali.

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

await FirebaseCrashlytics.setCustomKey({
  key: 'key-123',
  value: 'value',
  type: 'string',
});

setUserId()

Imposta un ID utente (identificativo) associato ai successivi report di errori fatali e non fatali.

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

await FirebaseCrashlytics.setUserId({ userId: 'user-id-123' });

log()

Aggiunge un messaggio di log personalizzato inviato con i dati del crash, per avere più contesto sugli eventi che precedono un crash.

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

await FirebaseCrashlytics.log({ message: 'Hello from Capacitor' });

setEnabled()

Abilita/disabilita la raccolta automatica dei dati. Il valore non viene applicato fino al prossimo avvio dell'app.

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

await FirebaseCrashlytics.setEnabled({ enabled: true });

isEnabled()

Restituisce se la raccolta automatica dei dati è abilitata o meno.

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';

const result = await FirebaseCrashlytics.isEnabled();
console.log(result);

La tabella sopra elenca i 10 metodi principali. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nella repository GitHub.

Riferimento completo

Continua da Using @capgo/capacitor-firebase-crashlytics

Se stai usando Utilizzo di @capgo/capacitor-firebase-crashlytics per pianificare il lavoro sui plugin nativi, collegalo a Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli sull'implementazione in Adding or Updating Plugins, Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Ionic Enterprise Plugin Alternatives, e Capgo Native Build per il workflow di prodotto in Capgo Native Builds.

FAQ

FAQ sul plugin Firebase Crashlytics

Come installo il plugin Firebase Crashlytics in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-crashlytics" (o "npm install @capgo/capacitor-firebase-crashlytics"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android rilevino il code nativo. Importalo da "@capgo/capacitor-firebase-crashlytics" nel code della tua app.

@capgo/capacitor-firebase-crashlytics funziona con React, Vue e Angular?

Sì. Firebase Crashlytics è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-firebase-crashlytics?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-firebase-crashlytics è gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-firebase/tree/main/packages/crashlytics e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che utilizza Firebase Crashlytics senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci le modifiche a Firebase Crashlytics senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo