Petunjuk
Tutorial tentang Notifikasi
Menggunakan @capgo/capacitor-notifikasi
Kirim notifikasi push native iOS dan Android dari Capgo dengan pencarian pengguna, tombol notifikasi, pengawasan latar depan/buka, panggilan balik latar, dan periksa update Capgo hidup secara diam.
Plugin ini dibangun untuk aliran notifikasi Capgo. Capgo menyimpan metadata kredential platform dan data kontrol kampanye di Postgres, sementara status perangkat aktif dan event pengiriman ditulis ke Cloudflare Engine Analitik.
Pasang
Paket ini saat ini dalam pratinjau pribadi. Capgo harus mengaktifkan akses paket untuk akun npm Anda sebelum instalasi berfungsi.
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 Pengguna Terotentikasi
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,
})
Tangani 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 Modus Latar Belakang > Pemberitahuan Jarak Jauh di Xcode.
Mengirimkan notifikasi remote 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 android, konfigurasi kredit platform Android di Capgo, meminta izin notifikasi di Android 13+, dan tes di perangkat atau emulator dengan layanan Google Play.
Daftar Periksa Pengembangan
- Jalankan
npx @capgo/cli@latest notifications setup com.example.appdari folder yang berisicapacitor.config.*. - Cari penerima di Capgo dengan ID pelanggan eksternal.
- Pastikan perangkat memiliki platform
androidatauiosdan izin telah diberikan. - Tambahkan pemantau sementara untuk
registrationChanged,notificationReceived,notificationOpeneddanbackgroundNotification. - Kirim notifikasi uji dari dashboard.
- Cek statistik untuk kejadian antrian, dikirim, diterima, dan dibuka.
- Untuk verifikasi pembaruan diam, pastikan
@capgo/capacitor-updaterterpasang danautoUpdaterteraktifkan.
Referensi Lengkap
- Docs: /docs/plugins/notifications/
- Pengembangan: /docs/plugins/notifications/debugging/
- Sumber: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
Teruskan dari Menggunakan @capgo/capacitor-notifications
Jika Anda menggunakan Menggunakan @capgo/capacitor-notifications untuk merencanakan pesan push asli, hubungkannya dengan @capgo/capacitor-notifications untuk detail implementasi, Debugging untuk troubleshooting, @capgo/capacitor-updater untuk periksa update diam, dan Capgo Direktori Plugin untuk plugin asli lainnya.