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

Firebase Crashlytics in Capacitor nutzen

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 einen benutzerdefinierten Key und Value für nachfolgende fatal und non-fatal Reports.
setUserId Setzt eine User ID (Identifier) für nachfolgende fatal und non-fatal Reports.
log Fügt eine benutzerdefinierte Log-Message hinzu, die mit den Crash-Daten gesendet wird, um mehr Kontext zu den Ereignissen vor dem Crash zu erhalten.
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.
didCrashOnPreviousExecution Gibt zurück, ob die App während der letzten Ausführung 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 einen benutzerdefinierten Key und Value, der mit folgenden 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 (Identifier), die mit folgenden 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-Message hinzu, die mit deinen Crash-Daten gesendet wird, um mehr Kontext zu den Ereignissen vor einem Crash zu erhalten.

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 Version-Helper sowie der vollständige Contract jeder Methode sind hier dokumentiert: GitHub Repository.

Vollständige Referenz

Weiter mit der Nutzung von @capgo/capacitor-firebase-crashlytics

Wenn du es nutzt Nutzung 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 und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App aus "@capgo/capacitor-firebase-crashlytics" via code.

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 reinem JavaScript.

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

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 code Source ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-firebase/tree/main/packages/crashlytics einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code nutzen, das Firebase Crashlytics verwendet, und Updates ohne App Store Review einspielen?

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 deployen, ohne auf den App-Review 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