Inizia
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.
Installazione
Finestra del terminalebun add @capgo/capacitor-firebase-crashlyticsbunx cap syncimport { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';API Panoramica
Sezione intitolata “API Panoramica”Forza un 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 a ulteriori 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 a ulteriori 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 per gli eventi che hanno portato a un crash.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.log({} as LogOptions);setEnabled
Sezione intitolata “setEnabled”Abilita/disabilita la raccolta automatica dei dati.
Il valore non si applica fino alla prossima esecuzione dell'app.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setEnabled({} as SetEnabledOptions);isEnabled
Sezione intitolata “isEnabled”Restituisce se la raccolta dati automatica è abilitata o meno.
Disponibile solo per iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.isEnabled();didCrashOnPreviousExecution
Sezione intitolata “didCrashOnPreviousExecution”Restituisce se l'applicazione è crashata 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 la raccolta dati automatica è 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.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.recordException({} as RecordExceptionOptions);Riferimento di tipo
Sezione intitolata “Riferimento di tipo”CrashOptions
Sezione intitolata “Opzioni di crash”export interface CrashOptions { /** * @since 0.1.0 */ message: string;}SetCustomKeyOptions
Sezione intitolata “SetCustomKeyOptions”export type SetCustomKeyOptions = CustomKeyAndValue;SetUserIdOptions
Sezione intitolata “SetUserIdOptions”export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string;}LogOptions
Sezione intitolata “LogOptions”export interface LogOptions { /** * @since 0.1.0 */ message: string;}SetEnabledOptions
Sezione intitolata “SetEnabledOptions”export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
Sezione intitolata “IsEnabledResult”export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}DidCrashOnPreviousExecutionResult
Sezione intitolata “DidCrashOnPreviousExecutionResult”export interface DidCrashOnPreviousExecutionResult { /** * @since 0.1.0 */ crashed: boolean;}RecordExceptionOptions
Sezione intitolata “RecordExceptionOptions”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 “GetPluginVersionResult”export interface GetPluginVersionResult { /** * The semantic version of this plugin. * * @since 8.0.2 */ version: string;}CustomKeyAndValue
Sezione intitolata “CustomKeyAndValue”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
Sezione intitolata “StackFrame”Sottinsieme della Stacktrace generata da stacktrace.js.
export interface StackFrame { lineNumber?: number; fileName?: string; functionName?: string;}Fonte di Verità
Sezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin src/definitions.tsRiesegui nuovamente la sincronizzazione quando le informazioni pubbliche API cambiano in fase di sviluppo.