Inizia
Copia un prompt 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 syncImporta
Sezione intitolata “Importa”import { 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
Sottosezione 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
Sottosezione 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
Sezione intitolata “setEnabled”Abilita/disabilita la raccolta automatica dei dati. Il valore non si applica fino alla prossima esecuzione dell'app.
Disponibile solo per Android e iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setEnabled({} as SetEnabledOptions);isEnabled
Sezione intitolata “isEnabled”Restituisce se la raccolta automatica dei dati è abilitata.
Disponibile solo per iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.isEnabled();didCrashOnPreviousExecution
Sezione intitolata “didCrashOnPreviousExecution”Restituisce se l'app è 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 qualsiasi rapporto non inviato 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 qualsiasi rapporto non inviato 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 “CrashOptions”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
Sottosezione intitolata “Abilita le opzioni”export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
Sottosezione intitolata “Risultato abilitato”export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}DidCrashOnPreviousExecutionResult
Sottosezione intitolata “Risultato crash sul precedente esecuzione”export interface DidCrashOnPreviousExecutionResult { /** * @since 0.1.0 */ crashed: boolean;}RecordExceptionOptions
Sottosezione intitolata “Registra le opzioni di 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
Sottosezione intitolata “Risultato della versione del plugin”export interface GetPluginVersionResult { /** * The semantic version of this plugin. * * @since 8.0.2 */ version: string;}CustomKeyAndValue
Sottosezione 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 generato 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 Panoramica per i dettagli di implementazione in API Panoramica 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.