Richtlinie
Benutzerhandbuch zu Benachrichtigungen
Mit @capgo/capacitor-benachrichtigungen native iOS- und Android-Benachrichtigungen senden
Die Erweiterung ist für den Capgo-Benachrichtigungs-Pipeline erstellt. Capgo speichert Plattform-Zugriffsmetadaten und Kampagnensteuerungsdaten in Postgres, während aktive Gerätestatus und Lieferungsereignisse in __CAPGO_KEEP_2__ Analytics Engine geschrieben werden.
The plugin is built for the Capgo notification pipeline. Capgo stores platform credential metadata and campaign control data in Postgres, while active device state and delivery events are written to Cloudflare Analytics Engine.
Verwenden Sie die __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ für eine geführte Einrichtung:
Use the Capgo CLI for a guided setup:
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 registrieren
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
Zulassen Benachrichtigungen über Push und Hintergrundmodi > Remotebenachrichtigungen in Xcode.
Fernübertragung von Benachrichtigungen 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 androidAusführen, konfigurieren Sie die Android-Plattformkredenziale in Capgo, stellen Sie die Benachrichtigungsrechte auf Android 13+ ein und testen Sie auf einem Gerät oder einem Emulator mit Google Play-Diensten.
Überprüfungscheckliste
- Ausführen
npx @capgo/cli@latest notifications setup com.example.appaus dem Ordner, der __CAPGO_KEEP_0__ enthältcapacitor.config.*. - Suchen Sie den Empfänger in Capgo nach externer Kunden-ID.
- Bestätigen Sie, dass das Gerät die Plattform
androidoderiosund die Genehmigung ist erteilt. - Hinzufügen von temporären Hörern für
registrationChanged,notificationReceived,notificationOpened, undbackgroundNotification. - Senden Sie einen Testbenachrichtigung von der Dashboard aus.
- Überprüfen Sie die Statistiken für die angesammelten, gesendeten, empfangenen und geöffneten Ereignisse.
- Für stille Aktualisierungsprüfungen, überprüfen Sie
@capgo/capacitor-updaterist installiert undautoUpdaterist aktiviert.
Vollständige Referenz
- Dokumentation: /docs/plugins/notifications/
- Debugging: /docs/plugins/notifications/debugging/
- Quelle: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
Weitermachen von @capgo/capacitor-Benachrichtigungen
Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen verwenden Verwenden Sie @capgo/capacitor-Benachrichtigungen Um native Push-Benachrichtigungen zu planen, verbinden Sie sie mit @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen @capgo/capacitor-notifications Fehlersuche für das Fehlersuchen @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Updater @capgo/capacitor-updater __CAPGO_KEEP_0__ Plugin-Verzeichnis Capgo Plugin Directory @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen