Zum Hauptinhalt springen
@capgo/capacitor-firebase-messaging Kommunikation Open Source

Firebase Messaging Capacitor Plugin

Capacitor Plugin für Firebase Cloud Messaging (FCM)

Installieren

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

Anleitung

Firebase Messaging in Capacitor nutzen

@capgo/capacitor-firebase-messaging verwenden

Capacitor-Plugin für Firebase Cloud Messaging (FCM).

Installieren

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

API auf einen Blick

Methode Beschreibung
checkPermissions Prüft die Berechtigung für Push-Benachrichtigungen.
requestPermissions Berechtigung für Push-Benachrichtigungen anfordern.
isSupported Prüft, ob alle erforderlichen APIs vorhanden sind.
getToken Registriert die App für Push-Benachrichtigungen. Gibt einen FCM-Token zurück, der zum Senden von Push-Nachrichten an diese Messaging-Instanz genutzt werden kann.
deleteToken Löscht den FCM-Token und hebt die Registrierung der App auf, damit keine Push-Benachrichtigungen mehr empfangen werden. Kann z. B. aufgerufen werden, wenn sich ein Nutzer abmeldet.
getDeliveredNotifications Ruft eine Liste der Benachrichtigungen ab, die auf dem Benachrichtigungsbildschirm sichtbar sind.
removeDeliveredNotifications Entfernt bestimmte Benachrichtigungen aus dem Benachrichtigungsbildschirm.
removeAllDeliveredNotifications Entfernt alle Benachrichtigungen aus dem Benachrichtigungsbildschirm.
subscribeToTopic Abonniert ein Topic im Hintergrund.
unsubscribeFromTopic Meldet sich im Hintergrund von einem Topic ab.
createChannel Erstellt einen Notification Channel.
deleteChannel Löscht einen Notification Channel.
listChannels Listet die verfügbaren Notification Channels auf.

Beispiele

checkPermissions()

Prüft die Berechtigung für Push-Benachrichtigungen.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.checkPermissions();
console.log(result);

requestPermissions()

Berechtigung für Push-Benachrichtigungen anfordern.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.requestPermissions();
console.log(result);

isSupported()

Prüft, ob alle erforderlichen APIs vorhanden sind.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.isSupported();
console.log(result);

getToken()

Registriert die App für Push-Benachrichtigungen. Gibt einen FCM-Token zurück, der zum Senden von Push-Nachrichten an diese Messaging-Instanz genutzt werden kann.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.getToken();
// The result holds sensitive values: use it without logging it.

deleteToken()

Löscht den FCM-Token und hebt die Registrierung der App auf, damit keine Push-Benachrichtigungen mehr empfangen werden. Kann z. B. aufgerufen werden, wenn sich ein Nutzer abmeldet.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

Ruft eine Liste der Benachrichtigungen ab, die auf dem Benachrichtigungsbildschirm sichtbar sind.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.getDeliveredNotifications();
console.log(result);

Die Tabelle oben listet die 13 Kernmethoden auf. Listener- und Version-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.

Events abonnieren

addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder FirebaseMessaging.removeAllListeners() auf, um alle Listener zu entfernen.

Vollständige Referenz

Weiter geht's mit Using @capgo/capacitor-firebase-messaging

Wenn du es nutzt @capgo/capacitor-firebase-messaging 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 Messaging Plugin FAQ

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

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

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

Ja. Firebase Messaging ist ein Capacitor-Paket 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 unterstützt @capgo/capacitor-firebase-messaging?

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-messaging kostenlos und Open Source?

Ja. Der code ist öffentlich auf GitHub einsehbar unter https://github.com/Cap-go/capacitor-firebase/tree/main/packages/messaging und das Paket lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code aktualisieren, die Firebase Messaging nutzen, ohne App-Store-Review?

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-Messaging-Änderungen ausrollen, ohne auf 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