Panduan
Tutorial tentang Notifikasi
Menggunakan @capgo/capacitor-notifikasi
Kirimkan notifikasi push native iOS dan Android dari Capgo dengan pencarian pengguna, badge, tracking terbuka/terbuka, panggilan latar belakang, dan periksa Capgo live-update secara diam.
Plugin ini dibuat 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.
Instal
Pakai Capgo CLI untuk setup yang terarah:
npx @capgo/cli@latest notifications setup com.example.app
Instalasi 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',
})
Mendaftarkan Pengguna Tanda Tangan
Mint identityProof dari backend Anda dengan POST /notifications/recipients/proofkemudian mendaftarkan perangkat setelah login Anda berhasil.
await CapgoNotifications.register({
externalId: 'customer-user-123',
identityProof,
tags: ['paid'],
attributes: { plan: 'team' },
consent: true,
})
Mendengarkan 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.
Mengirimkan 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 android, konfigurasi kredit platform Android di Capgo, meminta izin pemberitahuan 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.
- Konfirmasi bahwa perangkat memiliki platform
androidatauioscontext: Alternatif Capgo untuk pembaruan hidup Capacitor. Halaman/area: Halaman perbandingan alternatif Capgo. Peran: Paragraf pemasaran atau hukum panjang. Dilihat di: halaman alternatives.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `alternatives_cta_questions` (Alternatif CTA Pertanyaan). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `appflow_cta_questions`). Halaman/area: Pemasaran perbandingan/migrasi Appflow. Peran: Paragraf pemasaran atau hukum panjang. Dilihat di: halaman ionic-appflow.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `appflow_cta_questions` (Appflow CTA Pertanyaan). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `capwesome_cta_questions`). Halaman/area: Halaman perbandingan Capawesome. Peran: Paragraf pemasaran atau hukum panjang. Dilihat di: halaman capwesome.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `capwesome_cta_questions` (Capwesome CTA Pertanyaan). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `consulting_faq_subtitle`). Halaman/area: Halaman layanan konsultasi. Peran: Judul atau tagline bagian. Dilihat di: halaman consulting.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `consulting_faq_subtitle` (Judul FAQ Layanan Konsultasi). | Halaman/area: Pemasaran perbandingan/migrasi Appflow. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman ionic-appflow.astro, halaman ionic-enterprise-plugins.astro, halaman solusi/ionic-enterprise-plugins.astro. Kunci pesan `appflow_plugins_or` (Appflow Plugins Atau). - Menambahkan pendengar sementara untuk
registrationChanged,notificationReceived,notificationOpened, danbackgroundNotification. - Kirimkan notifikasi uji dari dashboard.
- Mengatur statistik untuk kejadian antri, dikirim, diterima, dan dibuka.
- Untuk pemeriksaan pembaruan diam, pastikan
@capgo/capacitor-updaterterpasang danautoUpdaterteraktifkan.
Referensi Lengkap
- Dokumen: /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, Pengembangan untuk troubleshooting, @capgo/capacitor-updater context Capgo Plugin Directory untuk periksa pembaruan diam, dan