Getting Started
Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complète pour ce 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.
Installer
Section intitulée « Installer »Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsEnsuite, utilisez la prompt suivante :
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-firebase-crashlytics` plugin in my project.Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :
bun add @capgo/capacitor-firebase-crashlyticsbunx cap syncImporter
Section intitulée « Importer »import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';API Vue d'ensemble
Section intitulée « API Vue d'ensemble »Force un crash pour tester la mise en œuvre.
Disponible uniquement pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.crash({} as CrashOptions);setCustomKey
Sous-section intitulée « setCustomKey »Définit une clé et une valeur personnalisées associées aux rapports mortels et non mortels ultérieurs.
Disponible uniquement pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setCustomKey({} as SetCustomKeyOptions);setUserId
Sous-section intitulée « setUserId »Définit un ID d'utilisateur (identifiant) associé aux rapports mortels et non mortels ultérieurs.
Disponible uniquement pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setUserId({} as SetUserIdOptions);Ajoute un message de journal personnalisé qui est envoyé avec vos données de crash pour vous donner plus de contexte sur les événements qui ont conduit à une erreur.
Seulement disponible pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.log({} as LogOptions);setEnabled
Sous-section intitulée « setEnabled »Active ou désactive la collecte automatique de données. La valeur n'est pas prise en compte jusqu'à la prochaine exécution de l'application.
Seulement disponible pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setEnabled({} as SetEnabledOptions);isEnabled
Sous-section intitulée « isEnabled »Retourne si la collecte automatique de données est activée ou non.
Seulement disponible pour iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.isEnabled();didCrashOnPreviousExecution
Sous-section intitulée « didCrashOnPreviousExecution »Retourne si l'application a planté lors de l'exécution précédente.
Seulement disponible pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.didCrashOnPreviousExecution();sendUnsentReports
Section intitulée « envoyer les rapports non envoyés »Envoie tous les rapports non envoyés à Crashlytics au prochain démarrage.
Lorsque la collecte de données automatique est activée, Crashlytics envoie automatiquement les rapports au démarrage.
Seulement disponible pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.sendUnsentReports();deleteUnsentReports
Section intitulée « supprimer les rapports non envoyés »Supprime tous les rapports non envoyés sur le dispositif.
Seulement disponible pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.deleteUnsentReports();recordException
Section intitulée « enregistrer l’exception »Enregistre un rapport non fatal pour l'envoyer à Crashlytics.
Disponible uniquement pour Android et iOS.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.recordException({} as RecordExceptionOptions);Référence de type
Sous-section intitulée « Référence de type »CrashOptions
Sous-section intitulée « CrashOptions »export interface CrashOptions { /** * @since 0.1.0 */ message: string;}SetCustomKeyOptions
Sous-section intitulée « Options de SetCustomKey »export type SetCustomKeyOptions = CustomKeyAndValue;SetUserIdOptions
Sous-section intitulée « Options de SetUserId »export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string;}export interface LogOptions { /** * @since 0.1.0 */ message: string;}SetEnabledOptions
Section intitulée « Activer les options »export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}DidCrashOnPreviousExecutionResult
Section intitulée « Résultat de la mise en œuvre de la détection de la panne précédente »export interface DidCrashOnPreviousExecutionResult { /** * @since 0.1.0 */ crashed: boolean;}RecordExceptionOptions
Section intitulée « Options de saisie de l'exception »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
Section intitulée « Résultat de la récupération de la version du plugin »export interface GetPluginVersionResult { /** * The semantic version of this plugin. * * @since 8.0.2 */ version: string;}CustomKeyAndValue
Section intitulée « Clé et valeur personnalisées »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
Section intitulée « StackFrame »Sous-ensemble de la Stacktrace généré par stacktrace.js.
export interface StackFrame { lineNumber?: number; fileName?: string; functionName?: string;}Source De Vérité
Section intitulée « Source De Vérité »Cette page est générée à partir du plugin’s src/definitions.tsRe-run la synchronisation lorsque la publication API change en amont.
Continuez de la page d'accueil « Getting Started »
Section intitulée « Continuez de la page d'accueil « Getting Started » »Si vous utilisez Page d'accueil « Getting Started » pour planifier le tableau de bord et les API opérations, connectez-l’avec API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, API Clés pour les détails d'implémentation dans API Clés, Appareils pour les détails d'implémentation dans Appareils, et Ensembles pour les détails d'implémentation dans Ensembles.