Saltare al contenuto principale
@capgo/capacitor-invio-messaggi-firebase Comunicazione Sorgente aperta

Firebase Messaging Plugin Capacitor

Capacitor plugin 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 utilizzare Firebase Messaging in Capacitor

Utilizza @capgo/capacitor-firebase-messaging

Capacitor plugin per Firebase Cloud Messaging (FCM).

Installa

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

bunx cap sync copia il plugin del nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo d'occhio

Metodo Descrizione
checkPermissions Controlla la possibilità di ricevere notifiche push.
requestPermissions Richiedi la possibilità di ricevere notifiche push.
isSupported Verifica se esistono tutte le API richieste.
getToken Registra l'app per ricevere notifiche push. Restituisce un token FCM che può essere utilizzato per inviare messaggi push a quel Messaging istanza.
deleteToken Elimina il token FCM e disiscrivi l'app per fermare le notifiche push. Può essere chiamato, ad esempio, quando un utente si disconnette.
getDeliveredNotifications Ottieni l'elenco delle notifiche visibili sulla schermata delle notifiche.
removeDeliveredNotifications Elimina specifiche notifiche dalla schermata delle notifiche.
removeAllDeliveredNotifications Elimina tutte le notifiche dalla schermata delle notifiche.
subscribeToTopic Sottoscrivi un argomento in background.
unsubscribeFromTopic Disiscrivi da un argomento in background.
createChannel Creare un canale di notifica.
deleteChannel Cancella un canale di notifica.
listChannels Elenco 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 di ricevere notifiche push.

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

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

isSupported()

Verifica se tutti gli API richiesti esistono.

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 utilizzato per inviare messaggi push a quel Messaging istanza.

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

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

deleteToken()

Cancella il token FCM e disiscrivi l'app per fermare di ricevere notifiche push. Può essere chiamato, ad esempio, quando un utente si disconnette.

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

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

Ottieni una lista di notifiche che sono visibili sulla 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 di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel GitHub repository.

Ascolta gli eventi

addListener ritorna un handle. Chiama handle.remove() quando la schermata viene smontata, o FirebaseMessaging.removeAllListeners() per cancellare ogni ascoltatore.

Riferimento completo

Continua con l'uso di @capgo/capacitor-firebase-messaging

Se stai utilizzando Utilizza @capgo/capacitor-firebase-messaging Per pianificare il lavoro dei plugin nativi, connettilo con Directory dei Plugin Capgo per il workflow del prodotto nella Capgo Directory dei Plugin Capacitor Plugins by Capgo per la dettagliata implementazione in Capacitor Plugin da Capgo Aggiornamento o Aggiunta di Plugin Per i dettagli di implementazione in Aggiornamento o Aggiunta di Plugin Alternativi Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternativi Plugin Enterprise Ionic, e Capgo Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native.

FAQ

Domande frequenti sul plugin di messaggistica Firebase

Come posso installare il plugin di messaggistica Firebase in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-messaging" (o "npm install @capgo/capacitor-firebase-messaging"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-firebase-messaging" nella tua app code.

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

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

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

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

È gratuito e open source @capgo/capacitor-firebase-messaging?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-firebase/tree/main/packages/messaging e il pacchetto è gratuito per l'installazione da npm. I segnalazioni di bug e pull request sono benvenuti.

Posso aggiornare code che utilizza Firebase Messaging senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il codice nativo code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite istantaneamente con gli aggiornamenti Capgo in tempo reale.

Invia le modifiche di Firebase Messaging senza dover attendere la revisione dell'app.

Una volta che il plugin è presente nel tuo store build, le Capgo aggiornamenti in tempo reale inviano le tue modifiche JavaScript, HTML e CSS ai utenti in pochi minuti.

Inizia con Capgo