Notifications Plugin Capacitor

Utilizzo di @capgo/capacitor-notifications

Invia notifiche native iOS e Android da Capgo con ricerca utente, badge, tracciamento aperto/foreground, callback di background e controlli di aggiornamento Capgo silenziosi.

Il plugin è progettato per il flusso di notifiche Capgo. Capgo memorizza i metadati delle credenziali delle piattaforme e i dati di controllo delle campagne in Postgres, mentre lo stato attivo dei dispositivi e gli eventi di consegna sono scritti nel motore di analisi Cloudflare

Installa

Usa il Capgo CLI per una configurazione guidata:

npx @capgo/cli@latest notifications setup com.example.app

Installazione manuale:

npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync

Configura:

import { CapgoNotifications } from '@capgo/capacitor-notifications'

await CapgoNotifications.configure({
  appId: 'com.example.app',
  autoUpdater: true,
  updateInstallMode: 'next',
})

Registra un utente firmato:

Mint: identityProof con il tuo backend con POST /notifications/recipients/proofpoi registra il dispositivo dopo che il tuo login ha avuto successo.

await CapgoNotifications.register({
  externalId: 'customer-user-123',
  identityProof,
  tags: ['paid'],
  attributes: { plan: 'team' },
  consent: true,
})

Ascolta gli eventi:

await CapgoNotifications.addListener('notificationReceived', (notification) => {
  console.log('Received', notification)
})

await CapgoNotifications.addListener('notificationOpened', (event) => {
  console.log('Opened', event.notification.id)
})

await CapgoNotifications.addListener('backgroundNotification', async (event) => {
  try {
    console.log('Background payload', event.notification.data)
  } finally {
    await event.finish()
  }
})

Impostazione iOS

Abilita: Le notifiche push and Modalità di background > Notifiche remote in Xcode.

Invia notifiche remote da ios/App/App/AppDelegate.swift:

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    NotificationCenter.default.post(name: Notification.Name("CapgoNotificationsRemoteNotification"), object: userInfo)
    completionHandler(.newData)
}

Configurazione Android

Esegui npx cap sync androidConfigura le credenziali del platform Android in Capgo, richiedi la autorizzazione alle notifiche su Android 13+ e testa su un dispositivo o emulatore con Google Play services.

Elenco di controllo di debug

• Esegui npx @capgo/cli@latest notifications setup com.example.app dal cartello che contiene capacitor.config.*.
• Cerca il destinatario in Capgo tramite ID di cliente esterno.
• Verifica che il dispositivo abbia le piattaforme android o ios e viene concesso il permesso.
• Aggiungi ascoltatori temporanei per registrationChanged, notificationReceived, notificationOpened, e backgroundNotification.
• Invia una notifica di prova dal pannello di controllo.
• Verifica le statistiche per gli eventi in coda, inviati, ricevuti e aperti.
• Per verifiche di aggiornamento silenziose, assicurati @capgo/capacitor-updater è installato e autoUpdater è abilitato.

Riferimento completo

• Documentazione: /docs/plugins/notifications/
• Risoluzione Problemi: /docs/plugins/notifications/debugging/
• Fonte: https://github.com/Cap-go/capgo/tree/main/pacchetti/capacitor-notifications/

Continua con l'utilizzo di @capgo/capacitor-notifications

Se stai utilizzando Utilizza @capgo/capacitor-notifications per pianificare la messaggistica push nativa, connettilo con @capgo/capacitor-notifications per i dettagli di implementazione, Debugging per la risoluzione dei problemi, @capgo/capacitor-aggiornatore per controlli di aggiornamento silenziosi, e Directory dei plugin Capgo per altri plugin nativi.