SuperAPI AI 工具集

push-notifications

测试与质量

查看项目

更新于 10-15 21:12

技能介绍

用途:在 iOS/macOS 应用中实现、审查或调试本地与远程通知,基于 UserNotifications 框架和 APNs。覆盖权限流程、设备令牌注册、载荷结构、前台处理、通知操作、分组与富通知。目标为 iOS 26+ 与 Swift 6.3,除特别说明外向后兼容 iOS 16。

主要能力:权限请求与状态检查(含 provisional、critical alerts);APNs 令牌注册与上传;本地通知的内容、触发器(时间间隔、日历、地理位置)与调度管理;远程通知标准载荷、静默/后台推送、mutable-content 富通知与本地化;UNUserNotificationCenterDelegate 前台展示与点击处理;通知操作与类别(文本输入、破坏性、需认证等);通过 threadIdentifier 分组。

使用方式:在启动时配置 delegate 与类别;在需要可见通知的上下文中请求授权;需要设备令牌时调用 registerForRemoteNotifications(),不要以授权状态为前置条件。每次 didRegisterForRemoteNotificationsWithDeviceToken 回调都应重新上传令牌,不要本地缓存作为唯一依据,也不要假设令牌长度。静默推送需 content-available: 1,配合 apns-push-type: background 与 apns-priority: 5,并开启 Remote notifications 后台模式。富通知需 mutable-content: 1 加 alert 载荷,服务扩展的每条路径(含失败与超时)都必须恰好调用一次内容处理器。

适用场景:提醒、计时器、位置提醒、聊天消息、富媒体通知、可交互通知等。

限制:静默推送为低优先级、受节流、不保证送达,不应频繁发送或依赖其即时性;模拟器不会向 APNs 注册,但可用 .apns 文件或 simctl push 模拟投递;关键警报需 Apple 特殊授权;相邻领域应分开处理,如 Live Activity 内容状态属于 activitykit,VoIP 推送属于 callkit,App Clip 临时通知属于 app-clips,静默推送后的长时后台任务属于 background-processing。