Aller au contenu principal
@capgo/capacitor-firebase-messaging Communication Open source

Firebase Messaging Plugin Capacitor

Plugin Capacitor pour Firebase Cloud Messaging (FCM)

Installer

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

Guide

Comment utiliser Firebase Messaging dans Capacitor

Utiliser @capgo/capacitor-firebase-messaging

Plugin Capacitor pour Firebase Cloud Messaging (FCM).

Installer

bun add @capgo/capacitor-firebase-messaging
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
checkPermissions Vérifier la permission de recevoir des notifications push.
requestPermissions Demander la permission de recevoir des notifications push.
isSupported Vérifie si toutes les API requises existent.
getToken Enregistrer l'app pour recevoir des notifications push. Retourne un token FCM utilisable pour envoyer des messages push à cette instance Messaging.
deleteToken Supprimer le token FCM et désenregistrer l'app pour arrêter de recevoir des notifications push. Peut être appelé, par exemple, lors de la déconnexion d'un utilisateur.
getDeliveredNotifications Récupérer la liste des notifications visibles sur l'écran de notifications.
removeDeliveredNotifications Supprimez des notifications spécifiques de l'écran des notifications.
removeAllDeliveredNotifications Supprimez toutes les notifications de l'écran des notifications.
subscribeToTopic S'abonne à un topic en arrière-plan.
unsubscribeFromTopic Se désabonne d'un topic en arrière-plan.
createChannel Créer un canal de notification.
deleteChannel Supprimer un canal de notification.
listChannels Lister les canaux de notification disponibles.

Exemples

checkPermissions()

Vérifier la permission de recevoir des notifications push.

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

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

requestPermissions()

Demander la permission de recevoir des notifications push.

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

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

isSupported()

Vérifie si toutes les API requises existent.

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

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

getToken()

Enregistrer l'app pour recevoir des notifications push. Retourne un token FCM utilisable pour envoyer des messages push à cette instance Messaging.

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

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

deleteToken()

Supprimer le token FCM et désenregistrer l'app pour arrêter de recevoir des notifications push. Peut être appelé, par exemple, lors de la déconnexion d'un utilisateur.

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

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

Récupérer la liste des notifications visibles sur l'écran de notifications.

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

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

Le tableau ci-dessus liste les 13 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou FirebaseMessaging.removeAllListeners() pour supprimer tous les listeners.

Référence complète

Continuez avec l'utilisation de @capgo/capacitor-firebase-messaging

Si vous utilisez Utiliser @capgo/capacitor-firebase-messaging pour planifier le travail sur les plugins natifs, connectez-l’à Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, et Capgo Native Build pour le workflow produit dans Capgo Native Builds.

FAQ

FAQ du plugin Firebase Messaging

Comment installer le plugin Firebase Messaging dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-firebase-messaging" (ou "npm install @capgo/capacitor-firebase-messaging"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-firebase-messaging" dans votre code.

Est-ce que @capgo/capacitor-firebase-messaging fonctionne avec React, Vue et Angular ?

Oui. Firebase Messaging est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-firebase-messaging ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-firebase-messaging est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-firebase/tree/main/packages/messaging et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Firebase Messaging sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Firebase Messaging sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo