Zum Hauptinhalt springen

Firebase Performance Capacitor Plugin

Capacitor Plugin für Firebase Performance Monitoring

Installieren

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

Anleitung

Firebase Performance in Capacitor nutzen

@capgo/capacitor-firebase-performance verwenden

Capacitor Plugin für Firebase Performance Monitoring.

Installieren

bun add @capgo/capacitor-firebase-performance
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 { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

API auf einen Blick

Methode Beschreibung
startTrace Startet einen Trace.
stopTrace Stoppt einen Trace.
incrementMetric Erhöht die Metrik mit dem angegebenen Namen für den ausgewählten Trace atomar um den incrementBy Wert.
setEnabled Aktiviert oder deaktiviert das Performance-Monitoring. Die Änderung wird beim nächsten App-Start übernommen.
isEnabled Legt fest, ob das Performance-Monitoring aktiviert oder deaktiviert ist.
putAttribute Setzt ein benutzerdefiniertes Attribut eines Traces auf einen bestimmten Wert.
getAttribute Gibt den Wert eines benutzerdefinierten Attributs eines Traces zurück.
getAttributes Ruft alle benutzerdefinierten Attribute eines Traces inklusive ihrer Werte ab.
removeAttribute Entfernt ein benutzerdefiniertes Attribut anhand seines Namens aus einem Trace.
putMetric Setzt den Wert einer benutzerdefinierten Metrik.
getMetric Get the value of a custom metric by name.
record Zeichnet einen Trace mit Namen und Optionen auf.

Beispiele

startTrace()

Startet einen Trace.

import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

await FirebasePerformance.startTrace({ traceName: 'trace' });

stopTrace()

Stoppt einen Trace.

import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

await FirebasePerformance.stopTrace({ traceName: 'trace' });

incrementMetric()

Erhöht die Metrik mit dem angegebenen Namen für den ausgewählten Trace atomar um den incrementBy Wert.

import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

await FirebasePerformance.incrementMetric({
  traceName: 'trace',
  metricName: 'metric',
});

setEnabled()

Aktiviert oder deaktiviert das Performance-Monitoring. Die Änderung wird beim nächsten App-Start übernommen.

import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

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

isEnabled()

Legt fest, ob das Performance-Monitoring aktiviert oder deaktiviert ist.

import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

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

putAttribute()

Setzt ein benutzerdefiniertes Attribut eines Traces auf einen bestimmten Wert.

import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';

await FirebasePerformance.putAttribute({
  traceName: 'trace',
  attribute: "experiment",
  value: "A",
});

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

Vollständige Referenz

Weiter mit „@capgo/capacitor-firebase-performance verwenden“

Wenn du es nutzt @capgo/capacitor-firebase-performance verwenden 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 Performance Plugin FAQ

Wie installiere ich das Firebase Performance Plugin in einer Capacitor App?

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

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

Ja. Firebase Performance 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-performance 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-performance kostenlos und Open Source?

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

Kann ich code mit Firebase Performance 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.

Änderungen an Firebase Performance ohne App-Review deployen

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