@capgo/capacitor-notificationsのチュートリアル

Capgoで、ユーザーロックアップ、バッジ、フォアグラウンド/オープン追跡、バックグラウンドコールバック、そしてサイレントCapgoライブアップデートチェックを使用して、ネイティブiOSとAndroidのプッシュ通知を送信します。

プラグインはCapgoの通知パイプラインに作成されています。Capgoはプラットフォーム認証情報のメタデータとキャンペーンコントロールデータをPostgresに格納し、Cloudflareアナリティクスエンジンにアクティブデバイスの状態と配信イベントを書き込みます。

インストール

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',
})

署名ユーザーを登録

Mint 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__ 内の受信者を外部顧客 ID で検索します。 capacitor.config.*.
Search the recipient in Capgo by external customer ID.
または android 許可が与えられます。 ios 一時リスナーを追加します
、 registrationChanged, notificationReceived, notificationOpened, and 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から続けてください。

Capacitor-notificationsを使用している場合 Using @capgo/capacitor-notifications native push メッセージングを計画し、 @capgo/capacitor-notifications 実装の詳細についてはデバッグトラブルシューティング @capgo/capacitor-updater 静的更新チェック、 Capgo Plugin Directory その他のネイティブプラグイン

通知

通知のチュートリアル