mcpField
I
ionic-local-notifications

ionic-local-notifications

github.com/erkamyaman开发1643 次安装1 周前更新
代码仓库

关于 ionic-local-notifications

这是一套面向 Ionic 应用的本地通知开发技能,使用 Capacitor Local Notifications 在设备端安排通知。内容涵盖权限时机、排程限制,并区分本地通知与后端推送。

主要功能

  1. 01权限与排程指导
  2. 02通知 ID 唯一性规则
  3. 03iOS 排程数量限制提示
  4. 04Android 13+ 权限行为说明
  5. 05提供周期通知与操作模式参考

适用场景

  1. 01在设备上安排每日提醒
  2. 02在新手引导后发送跟进提示
  3. 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。这两个插件彼此独立,也可以同时使用。

何时查阅

重要规则

  • ✅ 当用户选择启用使用通知的功能时,再请求权限,不要在应用启动时请求。
  • ✅ 始终为每条通知设置唯一的数字 id——相同的 id 会覆盖之前的通知。
  • ✅ 在 Android 13+ 上,首次调度通知时,操作系统会自动提示用户授予 POST_NOTIFICATIONS 权限。
  • ❌ 在 iOS 上,不要安排超过约 64 条同时生效的通知——操作系统会静默丢弃其余通知。
  • ❌ 不要依赖本地通知来确保准时送达——操作系统可能会出于电源管理而延迟通知。对于“必须送达”的通知,请使用推送通知。

库

npm install @capacitor/local-notifications
npx cap sync

评论

支持 Markdown