__CAPGO_KEEP_1__ pengaturan, contoh, dan FAQ.
@capgo/capacitor-notifications API Perangkat Sumber Terbuka

Notifikasi Plugin Capacitor

Kirim notifikasi push native iOS dan Android dari Capgo dengan pencarian pengguna, badge, statistik, dan pengecekan pembaruan diam

Pasang

bun add @capgo/capacitor-notifications bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-notifications
  • pnpm add @capgo/capacitor-notifications
  • yarn add @capgo/capacitor-notifications

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.app dari folder yang mengandung capacitor.config.*.
  • Cari penerima di Capgo dengan ID pelanggan eksternal.
  • Pastikan perangkat memiliki platform android atau ios Untuk pembaruan diam, pastikan
  • telah terinstal dan registrationChanged, notificationReceived, notificationOpened, and backgroundNotification.
  • Kirim notifikasi uji dari dashboard.
  • Periksa statistik untuk kejadian yang antri, dikirim, diterima, dan dibuka.
  • Untuk pembaruan diam, pastikan @capgo/capacitor-updater telah terinstal dan autoUpdater telah diaktifkan.

Referensi Lengkap

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

FAQ

FAQ Plugin Pemberitahuan

Bagaimana cara menginstal plugin Pemberitahuan di sebuah aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-notifications" (atau "npm install @capgo/capacitor-notifications"), kemudian jalankan "bunx cap sync" agar proyek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-notifications" di aplikasi code.

Apakah @capgo/capacitor-notifications berfungsi dengan React, Vue, dan Angular?

Ya. Pemberitahuan adalah paket Capacitor, sehingga berfungsi dengan semua framework web yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-notifications?

Capgo plugin mengikuti Capacitor versi utama: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menampilkan versi yang masih mendukung.

Apakah @capgo/capacitor-notifications gratis dan terbuka sumber?

Ya. Sumber code tersedia secara publik di GitHub di https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/ dan paket tersebut dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya dapat memperbarui code yang menggunakan Notifications tanpa melalui tinjauan App Store?

Pemasangan atau pengupgrade plugin mengubah code native, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat dikirimkan secara langsung dengan Capgo live updates.

Kirim Perubahan Notifikasi tanpa Menunggu Ulasan Aplikasi

Saat plugin sudah ada di toko aplikasi Anda, Capgo pembaruan live membagikan perubahan JavaScript, HTML, dan CSS Anda kepada pengguna dalam menit-menit.

Mulai dengan Capgo