Panduan
Cara Menggunakan Notifikasi di Capacitor
Gunakan @capgo/capacitor-notifications
Mengirimkan pemberitahuan push native iOS dan Android dari Capgo dengan pencarian pengguna, tombol, tracking terbuka/terbuka, panggilan balik latar belakang, dan periksa Capgo live-update secara diam.
Plugin ini dibangun untuk pipa pemberitahuan Capgo. Capgo menyimpan metadata kreditur platform dan data kontrol kampanye di Postgres, sementara status perangkat aktif dan kejadian pengiriman ditulis ke Cloudflare Analytics Engine.
Pasang
Gunakan Capgo CLI untuk setup yang terarah:
npx @capgo/cli@latest notifications setup com.example.app
Pasang manual:
npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync
Konfigurasi
import { CapgoNotifications } from '@capgo/capacitor-notifications'
await CapgoNotifications.configure({
appId: 'com.example.app',
autoUpdater: true,
updateInstallMode: 'next',
})
Daftar Aplikasi yang Dijamin
Mint identityProof di backend Anda dengan POST /notifications/recipients/proof, kemudian daftar perangkat setelah login Anda berhasil.
await CapgoNotifications.register({
externalId: 'customer-user-123',
identityProof,
tags: ['paid'],
attributes: { plan: 'team' },
consent: true,
})
Dengarkan Untuk Acara
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()
}
})
Pengaturan iOS
Aktifkan Pemberitahuan Push dan Mode Latar Belakang > Pemberitahuan Jarak Jauh di Xcode.
Tampilkan pemberitahuan jarak jauh dari 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)
}
Pengaturan Android
Jalankan npx cap sync androidBandelkan platform Android di Capgo, minta izin pemberitahuan di Android 13+, dan tes di perangkat atau emulator dengan Google Play services.
Daftar Periksa Debugging
- Jalankan
npx @capgo/cli@latest notifications setup com.example.appdari folder yang mengandungcapacitor.config.*. - Cari penerima di Capgo dengan ID pelanggan eksternal.
- Pastikan perangkat memiliki platform
androidatauiosUntuk pembaruan diam, pastikan - telah terinstal dan
registrationChanged,notificationReceived,notificationOpened, andbackgroundNotification. - Kirim notifikasi uji dari dashboard.
- Periksa statistik untuk kejadian yang antri, dikirim, diterima, dan dibuka.
- Untuk pembaruan diam, pastikan
@capgo/capacitor-updatertelah terinstal danautoUpdatertelah diaktifkan.
Referensi Lengkap
- Dokumen: /docs/plugins/notifications/
- Pengembangan: /docs/plugins/notifications/debugging/
- Sumber: https://github.com/Cap-go/capgo/tree/main/paket/capacitor-notifikasi/
Teruskan dari Menggunakan @capgo/capacitor-notifications
Jika Anda menggunakan Menggunakan @capgo/capacitor-notifications untuk merencanakan pesan push asli, hubungkannya dengan @capgo/capacitor-notifikasi untuk detail implementasi, Pengembangan untuk troubleshooting, @capgo/capacitor-pengupdate untuk periksa update diam. Capgo Plugin Directory __CAPGO_KEEP_0__ Direktori Plugin