ガイド
通知のチュートリアル
@capgo/capacitor-notificationsを使用
Capgoで、ユーザーロック、バッジ、フォアグラウンド/オープン追跡、バックグラウンドコールバック、静的Capgoライブアップデートチェックから、ネイティブiOSおよびAndroidプッシュ通知を送信します。
プラグインはCapgo通知パイプラインに作成されています。CapgoはPostgresにプラットフォーム認証情報メタデータとキャンペーンコントロールデータを、Cloudflare Analytics Engineにアクティブデバイス状態と配信イベントを保存します。
インストール
このパッケージは現在プライベートプレビュー中です。Capgoがnpmアカウントのパッケージアクセスを有効にしないと、インストールが機能しません。
Capgo CLIを使用して、ガイデッドセットアップを行います:
npx @capgo/cli@latest notifications setup com.example.app
手動インストール:
npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync
設定
import { CapgoNotifications } from '@capgo/capacitor-notifications'
await CapgoNotifications.configure({
appId: 'com.example.app',
autoUpdater: true,
updateInstallMode: 'next',
})
署名ユーザーを登録
トークンを生成 identityProof バックエンドから POST /notifications/recipients/proof, その後、デバイスを登録するには、自身のログインが成功するまで待つ必要があります。
await CapgoNotifications.register({
externalId: 'customer-user-123',
identityProof,
tags: ['paid'],
attributes: { plan: 'team' },
consent: true,
})
イベントを待ち受ける
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()
}
})
iOS設定
有効 プッシュ通知 および バックグラウンドモード > Remote notifications Xcodeで
リモート通知を前方に送信する 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)
}
Androidセットアップ
実行 npx cap sync androidAndroidプラットフォームの資格情報をCapgoに設定し、Android 13以降で通知許可を要求し、Google Playサービスを搭載したデバイスまたはエミュレータでテストする
デバッグチェックリスト
- 実行
npx @capgo/cli@latest notifications setup com.example.app__CAPGO_KEEP_0__内のフォルダからcapacitor.config.*. - Capgo内で顧客IDを外部で検索する
- デバイスがプラットフォームを確認し、または
android許可が付与されていることを確認するios一時的なリスナーを追加する - Android 13以降の場合、通知許可を要求する
registrationChanged,notificationReceived,notificationOpened、とbackgroundNotification. - ダッシュボードからテスト通知を送信してください。
- キュー、送信、受信、開封イベントの統計を確認してください。
- 静的更新チェックの場合、
@capgo/capacitor-updaterインストールされているかどうかを確認してください。autoUpdater有効になっているかどうかを確認してください。
フルリファレンス
- ドキュメント: /docs/plugins/notifications/
- デバッグ: /docs/plugins/notifications/debugging/
- ソース: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
Using @capgo/capacitor-notificationsから続けてください。
あなたが @capgo/capacitor-notifications を使用している場合、 @capgo/capacitor-notifications と接続して @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications の実装詳細を確認する @capgo/capacitor-updater トラブルシューティング用 @Capgo/__CAPGO_KEEP_1__-updater 静的更新チェック用