Zum Hauptinhalt springen

Firebase Crashlytics Capacitor Plugin

Capacitor Plugin für Firebase Crashlytics

Installieren

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

Anleitung

So nutzt du Firebase Crashlytics in Capacitor

Verwendung von @capgo/capacitor-firebase-crashlytics

Capacitor-Plugin für Firebase Crashlytics.

Installieren

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

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
crash Erzwingt einen Crash, um die Implementierung zu testen.
setCustomKey Setzt ein benutzerdefiniertes Key-Value-Paar, das mit nachfolgenden fatalen und nicht-fatalen Reports verknüpft wird.
setUserId Setzt eine User-ID (Bezeichner), die mit nachfolgenden fatalen und nicht-fatalen Reports verknüpft wird.
log Fügt eine benutzerdefinierte Log-Nachricht hinzu, die mit deinen Crash-Daten gesendet wird, damit du mehr Kontext zu den Ereignissen hast, die zu einem Crash geführt haben.
setEnabled Aktiviert oder deaktiviert die automatische Datenerfassung. Der Wert wird erst beim nächsten App-Start wirksam.
isEnabled Gibt zurück, ob die automatische Datenerfassung aktiviert ist oder nicht.
didCrashOnPreviousExecution Gibt an, ob die App beim letzten Lauf abgestürzt ist.
sendUnsentReports Lädt beim nächsten Start alle nicht gesendeten Berichte an Crashlytics hoch.
deleteUnsentReports Löscht alle nicht gesendeten Berichte auf dem Gerät.
recordException Erfasst einen Non-Fatal-Bericht zum Senden an Crashlytics.

Beispiele

crash()

Erzwingt einen Crash, um die Implementierung zu testen.

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

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

setCustomKey()

Setzt ein benutzerdefiniertes Key-Value-Paar, das mit nachfolgenden fatalen und nicht-fatalen Reports verknüpft wird.

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

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

setUserId()

Setzt eine User-ID (Bezeichner), die mit nachfolgenden fatalen und nicht-fatalen Reports verknüpft wird.

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

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

log()

Fügt eine benutzerdefinierte Log-Nachricht hinzu, die mit deinen Crash-Daten gesendet wird, damit du mehr Kontext zu den Ereignissen hast, die zu einem Crash geführt haben.

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

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

setEnabled()

Aktiviert oder deaktiviert die automatische Datenerfassung. Der Wert wird erst beim nächsten App-Start wirksam.

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

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

isEnabled()

Gibt zurück, ob die automatische Datenerfassung aktiviert ist oder nicht.

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

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

Die obige Tabelle listet die 10 Kernmethoden auf. Listener- und Versions-Helper sowie der vollständige Contract jeder Methode sind dokumentiert in GitHub Repository.

Vollständige Referenz

Weiter mit „Using @capgo/capacitor-firebase-crashlytics“

Wenn du es nutzt Verwendung von @capgo/capacitor-firebase-crashlytics Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails unter „Plugins hinzufügen oder aktualisieren“, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen und Capgo Native Builds optimieren für den Produkt-Workflow in Capgo Native Builds.

FAQ

Firebase Crashlytics Plugin FAQ

Wie installiere ich das Firebase Crashlytics Plugin in einer Capacitor-App?

Führe „bun add @capgo/capacitor-firebase-crashlytics“ (oder „npm install @capgo/capacitor-firebase-crashlytics“) aus, danach „bunx cap sync“, damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus „@capgo/capacitor-firebase-crashlytics“.

Funktioniert @capgo/capacitor-firebase-crashlytics mit React, Vue und Angular?

Ja. Firebase Crashlytics ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und Vanilla JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-firebase-crashlytics?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-firebase-crashlytics kostenlos und Open Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-firebase/tree/main/packages/crashlytics verfügbar, und das Paket kann kostenlos von npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das Firebase Crashlytics verwendet, ohne App-Store-Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Firebase Crashlytics-Änderungen veröffentlichen, ohne auf die App-Prüfung zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo