Anleitung
Firebase Messaging in Capacitor nutzen
Verwendung von @capgo/capacitor-firebase-messaging
Capacitor Plugin für Firebase Cloud Messaging (FCM).
Installieren
bun add @capgo/capacitor-firebase-messaging
bunx cap sync
bunx cap sync kopiert das native code des Plugins in deine nativen Projekte. Führe es nach jedem Plugin-Upgrade erneut aus.
Importieren
import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';
API im Überblick
| Methode | Beschreibung |
|---|---|
checkPermissions |
Berechtigung für Push-Benachrichtigungen prüfen. |
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 meldet die App ab, um den Empfang von Push-Benachrichtigungen zu stoppen. Kann z. B. beim Logout des Nutzers aufgerufen werden. |
getDeliveredNotifications |
Ruft eine Liste der Benachrichtigungen ab, die im Benachrichtigungsbildschirm sichtbar sind. |
removeDeliveredNotifications |
Entfernt spezifische 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()
Fordert die Berechtigung für Push-Benachrichtigungen an.
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()
Registriere die App, um Push-Benachrichtigungen zu erhalten. Es wird ein FCM-Token zurückgegeben, mit dem Push-Nachrichten an diese Messaging-Instanz gesendet werden können.
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 meldet die App ab, damit keine Push-Benachrichtigungen mehr ankommen. Kann z. B. beim Logout eines Nutzers aufgerufen werden.
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 obige Tabelle listet die 13 Kernmethoden auf. Listener- und Versions-Helper sowie der vollständige Contract jeder Methode findest du in der GitHub-Repository.
Auf Events hören
addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder FirebaseMessaging.removeAllListeners() um alle Listener zu entfernen.
Vollständige Referenz
Weiterlesen nach der Nutzung von @capgo/capacitor-firebase-messaging
Wenn Sie ... verwenden Verwendung von @capgo/capacitor-firebase-messaging um die Arbeit an Native Plugins zu planen, verbinde es mit Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Adding or Updating Plugins, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin Alternatives und Capgo Native Builds für den Produkt-Workflow in Capgo Native Builds.