Iniziare
Copia una richiesta di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-firebase-crashlytics`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/firebase-crashlytics/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installa
Sezione intitolata “Installa”Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsUsa poi il seguente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-firebase-crashlytics` plugin in my project.Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:
bun add @capgo/capacitor-firebase-crashlyticsbunx cap syncimport { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';API Panoramica
Sottosezione intitolata “API Panoramica”Forza la crash per testare l'implementazione.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.crash({} as CrashOptions);setCustomKey
Sezione intitolata “setCustomKey”Imposta una chiave e un valore personalizzati associati ai successivi rapporti fatali e non fatali.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setCustomKey({} as SetCustomKeyOptions);setUserId
Sezione intitolata “setUserId”Imposta un ID utente (identificatore) associato ai successivi rapporti fatali e non fatali.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setUserId({} as SetUserIdOptions);Aggiungi un messaggio di log personalizzato che viene inviato con i dati di crash per fornire più contesto sugli eventi che hanno portato al crash.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.log({} as LogOptions);setEnabled
Sottosezione intitolata “abilitato”Abilita/disabilita la raccolta automatica dei dati. Il valore non si applica fino alla prossima esecuzione dell'applicazione.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setEnabled({} as SetEnabledOptions);isEnabled
Sottosezione intitolata “abilitato”Restituisce se la raccolta automatica dei dati è abilitata.
Disponibile solo per iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.isEnabled();didCrashOnPreviousExecution
Sottosezione intitolata “si è verificato un crash durante l'esecuzione precedente”Restituisce se l'applicazione si è verificato un crash durante l'esecuzione precedente.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.didCrashOnPreviousExecution();sendUnsentReports
Sezione intitolata “sendUnsentReports”Carica tutti i rapporti non inviati a Crashlytics al prossimo avvio.
Quando l'acquisizione automatica dei dati è abilitata, Crashlytics carica automaticamente i rapporti all'avvio.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.sendUnsentReports();deleteUnsentReports
Sezione intitolata “deleteUnsentReports”Elimina tutti i rapporti non inviati sul dispositivo.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.deleteUnsentReports();recordException
Sezione intitolata “recordException”Registra un rapporto non fatale da inviare a Crashlytics.
Sono disponibili solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.recordException({} as RecordExceptionOptions);Riferimento di tipo
Sottosezione intitolata “Riferimento di tipo”CrashOptions
Sottosezione intitolata “CrashOptions”export interface CrashOptions { /** * @since 0.1.0 */ message: string;}SetCustomKeyOptions
Sottosezione intitolata “SetCustomKeyOptions”export type SetCustomKeyOptions = CustomKeyAndValue;SetUserIdOptions
Sottosezione intitolata “SetUserIdOptions”export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string;}LogOptions
Sottosezione intitolata “LogOptions”export interface LogOptions { /** * @since 0.1.0 */ message: string;}SetEnabledOptions
Sezione intitolata “Abilita le opzioni”export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
Sezione intitolata “Risultato abilitato”export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}DidCrashOnPreviousExecutionResult
Sezione intitolata “Risultato crash sul precedente esecuzione”export interface DidCrashOnPreviousExecutionResult { /** * @since 0.1.0 */ crashed: boolean;}RecordExceptionOptions
Sezione intitolata “Registra opzioni eccezione”export interface RecordExceptionOptions { /** * The message to record as a non-fatal exception. * * @since 0.1.0 */ message: string; /** * Error code within a specific error domain. * * **Attention:** This option is ignored on iOS if `stacktrace` is provided. * * Only available for iOS. * * @since 0.1.0 */ code?: number; /** * A string containing the error domain. * * **Attention:** This option is ignored on iOS if `stacktrace` is provided. * * Only available for iOS. * * @since 0.1.0 */ domain?: string; /** * An array of keys and the values to associate with the non fatal exception, * in addition to the app level custom keys. * * **Attention:** This option is ignored on iOS if `stacktrace` is provided. * * @since 7.1.0 */ keysAndValues?: CustomKeyAndValue[]; /** * A stacktrace generated by stacktrace.js. * * @since 1.1.0 */ stacktrace?: StackFrame[];}GetPluginVersionResult
Sezione intitolata “Risultato versione plugin”export interface GetPluginVersionResult { /** * The semantic version of this plugin. * * @since 8.0.2 */ version: string;}CustomKeyAndValue
Sezione intitolata “Chiave e valore personalizzati”export interface CustomKeyAndValue { /** * @since 7.1.0 */ key: string; /** * @since 7.1.0 */ value: string | number | boolean; /** * @since 7.1.0 */ type: 'string' | 'long' | 'double' | 'boolean' | 'int' | 'float';}StackFrame
Sottosezione intitolata “StackFrame”Sottosezione del Stacktrace generata da stacktrace.js.
export interface StackFrame { lineNumber?: number; fileName?: string; functionName?: string;}Fonte di Verità
Sottosezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin’s src/definitions.ts. Riavvia la sincronizzazione quando il pubblico API cambia in modo upstream.
Continua da qui: Iniziare
Sottosezione intitolata “Continua da qui: Iniziare”Se stai utilizzando Iniziare per pianificare il dashboard e le API operazioni, connettilo con API Overview per i dettagli di implementazione in API Overview Introduzione per i dettagli di implementazione in Introduzione API Chiavi per i dettagli di implementazione in API Chiavi Dispositivi per i dettagli di implementazione in Dispositivi, e Bundle per i dettagli di implementazione in Bundle