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.