ionic-local-notifications について
Capacitor Local Notifications を使った Ionic アプリ向けのローカル通知実装スキルです。権限を求めるタイミングやスケジュール上の制約を説明し、バックエンドから送るプッシュ通知との違いも扱います。
主な機能
- 01権限とスケジュール設定の指針
- 02通知 ID の一意性ルール
- 03iOS の登録数制限に関する注意
- 04Android 13 以降の権限動作
- 05繰り返し通知とアクションの参考情報
活用シーン
- 01端末で毎日のリマインダーを予約
- 02オンボーディング後のフォローアップ通知
- 03休眠時や購入後の通知を設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ erkamyaman/ ionic-capacitor-skills --skill ionic-local-notificationsインストール後、Claude Code で/ionic-local-notificationsを入力して読み込まれたか確認します。
同梱ファイルreferences/patterns.mdreferences/setup-and-scheduling.md
詳細
ローカル通知
バックエンドではなく、デバイスによってスケジュールされ、発火する通知です。ユースケース:毎日のリマインダー、オンボーディング後のフォローアッププロンプト、購入後の通知、非アクティブ時のリマインダー。
サーバーから送信する通知(FCM/APNs)については、../ionic-shared/references/push-notifications.mdを参照してください。2つのプラグインは独立しており、併用できます。
参照するタイミング
- セットアップ、権限、スケジュール設定:setup-and-scheduling.md
- パターン(繰り返し、チャンネル、アクション処理):patterns.md
厳守事項
- ✅ 通知を使用する機能へのオプトイン時に権限をリクエストしてください。アプリの起動時にはリクエストしないでください。
- ✅ 通知ごとに一意の数値
idを必ず設定してください。同じidを指定すると、前の通知が上書きされます。 - ✅ Android 13以降では、最初にスケジュールを設定したときに、OSが
POST_NOTIFICATIONSの許可を自動的に求めます。 - ❌ iOSでは、同時にスケジュールする通知を約64件以上にしないでください。超過分はOSによって通知されずに破棄されます。
- ❌ 時刻厳守が必要な通知の配信に、ローカル通知を頼らないでください。電力管理のため、OSによって遅延することがあります。「必ず届けなければならない」場合はプッシュ通知を使用してください。
ライブラリ
npm install @capacitor/local-notifications
npx cap sync
コメント
Markdown 対応