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

Notifiche push ricche plugin Capacitor

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

Installazione

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 progresso, pulsanti di azione, pianificazione e livelli di interruzione iOS.

Installazione

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

Cosa espone il plugin

  • checkPermission - Controlla lo stato dei permessi delle notifiche locali.
  • requestPermission - Richiedi i permessi 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 immediatamente una notifica locale.
  • schedule - Pianifica una notifica locale per un momento successivo.
  • cancel - Cancella una notifica tramite il suo ID.
  • cancelAll - Cancella tutte le notifiche gestite da questo plugin.
  • getDisplayed - Elenca le notifiche visualizzate nel centro notifiche.
  • getPending - Elenca le notifiche pianificate non ancora mostrate.
  • getInitialNotification - Restituisce la notifica che ha aperto l'app, se presente.
  • setBadge - Imposta il badge count dell'icona 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 di utilizzo

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 sul plugin Rich Notifications

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

Esegui "bun add @capgo/capacitor-rich-notifications" (o "npm install @capgo/capacitor-rich-notifications"), poi esegui "bunx cap sync" in modo che i progetti iOS e Android carichino il code nativo. Importalo da "@capgo/capacitor-rich-notifications" nella tua app code.

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

Sì. Rich Notifications è 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 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 è free e open source?

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

Posso aggiornare code con le Rich Notifications 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 i live update di Capgo.

Distribuisci modifiche alle Rich Notifications senza attendere l'app review

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

Inizia con Capgo