Mit @capgo/capacitor-Benachrichtigungen native iOS- und Android-Benachrichtigungen verwenden

Mit Capgo native iOS- und Android-Benachrichtigungen senden, die Benutzerlookup, Badges, Vordergrund/Offen-Tracking, Hintergrundrückruf und stille Capgo-Live-Update-Überprüfungen unterstützen.

Das Plugin ist für die Capgo-Benachrichtigungs-Pipeline entwickelt. Capgo speichert Plattform-Zugriffsmetadaten und Kampagnensteuerungsdaten in Postgres, während aktive Gerätestatus und Lieferungsereignisse in Cloudflare Analytics Engine geschrieben werden.

Installieren

Diese Paket befindet sich derzeit in privatem Vorschauzustand. Capgo muss Paketzugriff für Ihr npm-Konto aktivieren, bevor die Installation funktioniert.

Verwenden Sie das Capgo-CLI für eine geführte Einrichtung:

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

Manuelle Installation:

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

Konfigurieren

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

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

Ein registrierter Benutzer anmelden

Minten identityProof von Ihrem Backend mit POST /notifications/recipients/proof, dann registrieren Sie das Gerät nach Ihrem eigenen Login erfolgreich ist.

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

Für Ereignisse lauschen

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()
  }
})

iOS-Einrichtung

Aktivieren Push-Benachrichtigungen und Hintergrundmodi > Remote-Benachrichtigungen in Xcode.

Remotebenachrichtigungen von 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)
}

Android-Einrichtung

Ausführen npx cap sync androidKonfigurieren Sie die Android-Plattformkredenziale in Capgo, fordern Sie die Benachrichtigungs-Erlaubnis auf Android 13+ an und testen Sie auf einem Gerät oder einem Emulator mit Google Play-Diensten.

Überprüfungsliste für Debugging

Ausführen npx @capgo/cli@latest notifications setup com.example.app aus dem Ordner, der __CAPGO_KEEP_0__ enthält capacitor.config.*.
Suchen Sie den Empfänger in Capgo nach externer Kunden-ID.
Bestätigen Sie, dass das Gerät die Plattform- android oder ios und die Berechtigung erteilt wurde.
Fügen Sie temporäre Hörer für registrationChanged, notificationReceived, notificationOpenedund backgroundNotification.
Einen Testbenachrichtigung von der Dashboard senden.
Überprüfen Sie die Statistiken für die angesammelten, gesendeten, empfangenen und geöffneten Ereignisse.
Für stumme Aktualisierungsprüfungen überprüfen Sie @capgo/capacitor-updater installiert ist und autoUpdater aktiviert ist.

Vollständige Referenz

Dokumentation: /docs/plugins/notifications/
Debugging: /docs/plugins/notifications/debugging/
Quelle: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/

Fortsetzen Sie mit Using @capgo/capacitor-notifications

Wenn Sie Mit @capgo/capacitor-Benachrichtigungen native Push-Nachrichten planen, verbinden Sie es mit @capgo/capacitor-Benachrichtigungen für die Implementierungsdetails, Fehlersuche für die Fehlerbehebung, @capgo/capacitor-Updater für stille Aktualisierungsprüfungen und Capgo-Plugin-Verzeichnis für andere native Plugins.

Benachrichtigungen

Benutzeranleitung zu Benachrichtigungen