Anleitung
Tutorial zu Benachrichtigungen
Mit @capgo/capacitor-Benachrichtigungen native iOS- und Android-Benachrichtigungen senden
Mit Capgo native iOS- und Android-Benachrichtigungen senden, einschließlich Benutzerlookup, Badges, Vordergrund-/Offen-Tracking, Hintergrundaufrufe und stille Capgo Live-Update-Überprüfungen
Das Plugin ist für den 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
Verwenden Sie den 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',
})
Registrieren Sie einen signierten Benutzer
Mint identityProof aus 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,
})
Hören Sie auf Ereignisse
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
Enable Push-Benachrichtigungen und Hintergrundmodi > Remote-Benachrichtigungen in Xcode.
Senden Sie Remote-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 androidKonfigurieren Sie die Android-Plattformkredenziale in Capgo, fordern Sie die Benachrichtigungsrechte auf Android 13+ an und testen Sie auf einem Gerät oder einem Emulator mit Google Play-Diensten.
Fehlersuche-Checkliste
- Ausführen
npx @capgo/cli@latest notifications setup com.example.appaus dem Ordner, der enthältcapacitor.config.*. - Suchen Sie den Empfänger in Capgo nach externer Kunden-ID.
- Bestätigen Sie, dass das Gerät die Plattform
androidoderiosBestätigen Sie, dass die Berechtigung erteilt wurde. - Hinzufügen Sie temporäre Listener für
registrationChanged,notificationReceived,notificationOpenedundbackgroundNotification. - Ein 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-updaterobautoUpdaterinstalliert ist und
aktiviert ist.
- Vollständige Referenz
- Dokumentation: /docs/plugins/notifications/
- Fehlersuche: /docs/plugins/notifications/debugging/ https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
https://capgo.com/Cap-go/capacitor/tree/main/packages/__CAPGO_KEEP_2__-notifications/
Fortsetzen Sie mit der Verwendung von @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications. Wenn Sie die Benachrichtigung verwenden Mit @capgo/capacitor-Benachrichtigungen um native Push-Nachrichten zu 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.