Salta al contenuto principale
@capgo/capacitor-firebase-messaging Comunicazione Open source

Firebase Messaging Plugin Capacitor

plugin Capacitor per Firebase Cloud Messaging (FCM)

Installa

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

Guida

Come usare Firebase Messaging in Capacitor

Utilizzo di @capgo/capacitor-firebase-messaging

Plugin Capacitor per Firebase Cloud Messaging (FCM).

Installa

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

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
checkPermissions Verifica il permesso di ricevere notifiche push.
requestPermissions Richiedi il permesso per ricevere le notifiche push.
isSupported Verifica se tutte le API richieste sono presenti.
getToken Registra l'app per ricevere notifiche push. Restituisce un token FCM che può essere usato per inviare messaggi push a quell'istanza di Messaging.
deleteToken Elimina il token FCM e annulla la registrazione dell'app per smettere di ricevere notifiche push. Può essere chiamato, ad esempio, quando un utente esegue il logout.
getDeliveredNotifications Ottieni l'elenco delle notifiche visibili nella schermata delle notifiche.
removeDeliveredNotifications Rimuovi notifiche specifiche dalla schermata delle notifiche.
removeAllDeliveredNotifications Rimuovi tutte le notifiche dalla schermata delle notifiche.
subscribeToTopic Si iscrive a un topic in background.
unsubscribeFromTopic Si disiscrive da un topic in background.
createChannel Crea un canale di notifica.
deleteChannel Elimina un canale di notifica.
listChannels Elenca i canali di notifica disponibili.

Esempi

checkPermissions()

Verifica il permesso di ricevere notifiche push.

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

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

requestPermissions()

Richiedi il permesso per ricevere le notifiche push.

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

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

isSupported()

Verifica se tutte le API richieste sono presenti.

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

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

getToken()

Registra l'app per ricevere notifiche push. Restituisce un token FCM che può essere usato per inviare messaggi push a quell'istanza di Messaging.

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

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

deleteToken()

Elimina il token FCM e annulla la registrazione dell'app per smettere di ricevere notifiche push. Può essere chiamato, ad esempio, quando un utente esegue il logout.

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

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

Ottieni l'elenco delle notifiche visibili nella schermata delle notifiche.

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

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

La tabella sopra elenca i 13 metodi core. I listener e gli helper di versione, insieme al contratto completo di ogni metodo, sono documentati in repository GitHub.

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o FirebaseMessaging.removeAllListeners() per rimuovere tutti i listener.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-firebase-messaging

Se stai usando Utilizzo di @capgo/capacitor-firebase-messaging per pianificare il lavoro sui plugin nativi, collegalo a Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli sull'implementazione in Adding or Updating Plugins, Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Ionic Enterprise Plugin Alternatives, e Capgo Native Build per il workflow di prodotto in Capgo Native Builds.

FAQ

FAQ sul plugin Firebase Messaging

Come installo il plugin Firebase Messaging in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-messaging" (o "npm install @capgo/capacitor-firebase-messaging"), poi lancia "bunx cap sync" per aggiornare i progetti iOS e Android con il code nativo. Importalo da "@capgo/capacitor-firebase-messaging" nel code della tua app.

@capgo/capacitor-firebase-messaging funziona con React, Vue e Angular?

Sì. Firebase Messaging è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che giri all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor è supportata da @capgo/capacitor-firebase-messaging?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-firebase-messaging è free e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-firebase/tree/main/packages/messaging e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Firebase Messaging senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche a Firebase Messaging senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo