Panduan
Tutorial tentang Pemberitahuan
Menggunakan @capgo/capacitor-pemberitahuan
Kirim pemberitahuan push native iOS dan Android dari Capgo dengan pencarian pengguna, tombol notifikasi, tracking terbuka/terbuka, panggilan balik latar belakang, dan periksa Capgo live-update secara diam.
Plugin ini dibuat untuk aliran pemberitahuan Capgo. Capgo menyimpan metadata kredential platform dan data kontrol kampanye di Postgres, sedangkan status perangkat aktif dan event pengiriman ditulis ke Cloudflare Engine Analitik.
Instal
Gunakan Capgo CLI untuk pengaturan yang terstruktur:
npx @capgo/cli@latest notifications setup com.example.app
Pasang secara 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',
})
Pendaftaran Pengguna Tertandatangan
Mint identityProof dari backend Anda dengan POST /notifications/recipients/proof, kemudian daftarkan perangkat setelah login Anda berhasil.
await CapgoNotifications.register({
externalId: 'customer-user-123',
identityProof,
tags: ['paid'],
attributes: { plan: 'team' },
consent: true,
})
Dengarkan 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 context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Pesan kunci `push_notifications` (Pemberitahuan Push). dan context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Pesan kunci `and` (Dan).
Mode Latar Belakang > Pemberitahuan Jarak Jauh 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 androidKonfigurasi kreditur platform Android di Capgo, minta izin notifikasi pada Android 13+, dan tes di perangkat atau emulator dengan layanan Google Play.
Daftar Periksa Debugging
- Jalankan
npx @capgo/cli@latest notifications setup com.example.appdari folder yang berisicapacitor.config.*. - Cari penerima di Capgo dengan ID pelanggan eksternal.
- Konfirmasi perangkat memiliki platform
androidatauiosKonfirmasi perangkat memiliki platform - dan izin diberikan.
registrationChanged,notificationReceived,notificationOpenedTetapkan pemangku jawab sementara untukbackgroundNotification. - Mengirimkan notifikasi uji dari dashboard.
- Mengcek statistik untuk kejadian antrian, dikirim, diterima, dan dibuka.
- Untuk pemeriksaan pembaruan diam, pastikan
@capgo/capacitor-updaterterpasang danautoUpdateraktif.
Referensi Lengkap
- Dokumen: /docs/plugins/notifications/
- Pengembangan: /docs/plugins/notifications/debugging/
- Sumber: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
Menggunakan @capgo/capacitor-notifications, lanjutkan.
Jika Anda menggunakan Gunakan @capgo/capacitor-notifications untuk merencanakan pesan push asli, hubungkannya dengan @capgo/capacitor-notifications untuk detail implementasi, Pengaturan Debug untuk troubleshooting, @capgo/capacitor-updater untuk periksa update diam, dan Capgo Direktori Plugin untuk plugin asli lainnya.