Salta al contenuto principale
@capgo/capacitor-rich-notifications Comunicazione Open source

Notifiche avanzate Plugin Capacitor

Notifiche locali con canali Android, layout di avanzamento, pulsanti di azione, pianificazione e livelli di interruzione iOS

Installa

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

Guida

Come usare le Rich Notifications in Capacitor

Utilizzo di @capgo/capacitor-rich-notifications

Notifiche locali con canali Android, layout di avanzamento, pulsanti di azione, pianificazione e livelli di interruzione iOS.

Installa

bun add @capgo/capacitor-rich-notifications
bunx cap sync

Cosa espone questo plugin

  • checkPermission - Controlla lo stato dei permessi delle notifiche locali.
  • requestPermission - Richiedi il permesso per le notifiche locali.
  • createChannel - Crea un canale di notifica Android.
  • createChannelGroup - Crea un gruppo di canali Android.
  • deleteChannel - Elimina un canale di notifica Android.
  • display - Mostra subito una notifica locale.
  • schedule - Programma una notifica locale per più tardi.
  • cancel - Annulla una notifica tramite id.
  • cancelAll - Annulla tutte le notifiche gestite da questo plugin.
  • getDisplayed - Elenca le notifiche mostrate nella tendina o nel centro notifiche.
  • getPending - Elenca le notifiche programmate non ancora mostrate.
  • getInitialNotification - Restituisci la notifica che ha aperto l'app, se presente.
  • setBadge - Imposta il numero di badge dell'icona dell'app su iOS.
  • registerActions - Registra una categoria di azioni riutilizzabile.
  • getPluginVersion - Restituisce il marker di versione dell'implementazione della piattaforma.
  • addListener - Ascolta gli eventi di pressione e chiusura.

Esempio d'uso

requestPermission e display

import { RichNotifications } from '@capgo/capacitor-rich-notifications';

await RichNotifications.requestPermission();

await RichNotifications.createChannel({
  id: 'messages',
  name: 'Messages',
  importance: 'high',
});

await RichNotifications.display({
  title: 'Hello',
  body: 'Tap to open the app',
  channelId: 'messages',
});

schedule

import { RichNotifications } from '@capgo/capacitor-rich-notifications';

await RichNotifications.schedule({
  notification: {
    id: 'reminder-1',
    title: 'Reminder',
    body: 'Your appointment starts soon',
    channelId: 'messages',
  },
  trigger: { type: 'timestamp', timestamp: Date.now() + 60_000 },
});

Riferimento completo

FAQ

FAQ del plugin Rich Notifications

Come installo il plugin Rich Notifications in un'app Capacitor?

Esegui "bun add @capgo/capacitor-rich-notifications" (oppure "npm install @capgo/capacitor-rich-notifications"), poi esegui "bunx cap sync" così che i progetti iOS e Android includano il code nativo. Importalo da "@capgo/capacitor-rich-notifications" nel code della tua app.

@capgo/capacitor-rich-notifications funziona con React, Vue e Angular?

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

Quale versione di Capacitor supporta @capgo/capacitor-rich-notifications?

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-rich-notifications è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-rich-notifications/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Rich Notifications senza una 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 alle Rich Notifications senza attendere 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