申请 iOS 推送证书并配置 APNs 群发推送教程
给 iOS App 做消息推送,需要先有一张 APNs 推送证书,再搭一套能管理设备 token、支持群发的推送通道------这一整套在「开心上架(AppUploader)」里是一个独立于 App Store Connect 的运营推送平台,分推送通道、设备库、发送、历史四个标签页。
第一步:签发 APNs 推送证书
打开「证书」页面:
- 点击「新建证书」,证书类型选择推送证书。
- 选择要绑定的 Bundle ID(若还没有,先去「Bundle ID」页面注册一个)。
- 填写证书名称和邮箱,设置
.p12保护密码(服务器不保存,请妥善保管)。 - 建议开启「云备份」,方便之后在推送页面直接取用,不用来回传文件。
- 提交后推送证书即签发完成。
推送证书是部署在推送服务器上、专门用于 APNs 通道的,并不用来给 App 本身签名编译,这一点和签名证书不同。
第二步:创建推送通道,拿到 App Key
打开「推送」页面的「推送通道」标签:
- 点击「新建通道」。
- 选择上一步签发的 APNs 推送证书。
- 输入该证书
.p12的导出密码(证书若已云备份,输入密码即可取出私钥)。 - 填写通道名称(比如"营销推送"),选择环境(生产 / 沙盒------开发调试期间通常用沙盒)。
- 提交后通道创建完成,会得到一个 App Key,在「接入代码」中能看到给开发同学的接入说明。
第三步:让 App 上报设备 token
按「设备接入说明」里的指引,让 App 开发同学在 Xcode 的 Signing & Capabilities 中添加 Push Notifications,把示例方法放进 AppDelegate,使 App 在拿到 APNs token 后调用上报接口。上报成功的设备会自动进入「设备库」标签页,可以按备注/token/标签搜索,也支持手动添加设备 token 或编辑标签。测试阶段选择手机所在的局域网地址,确保手机和本机处于同一 Wi-Fi。
第四步:编写并发送通知
在「发送」标签页:
- 选择要使用的推送通道。
- 填写标题、内容、声音(默认提示音/静音)、角标数字;需要更精细控制时可切换「高级模式」直接编辑原始 JSON Payload。
- 选择发送目标:全部设备 / 按标签 / 指定设备。
- 确认将发往的有效设备数量后,点击「立即发送」,完成后会显示成功/失败的设备数量。
第五步:查看投递结果
「历史」标签页记录每次发送的时间、内容、目标与结果,点击「详情」可以看到逐设备的投递报告(成功/失败/已投递及失败原因),也支持对某一条历史记录直接「重发」。
需要注意的一点
删除推送通道会连带删除该通道下的设备库和发送历史,且 App Key 立即失效,此操作不可撤销,如果只是想暂停推送,不要直接删除通道。
前往 https://appuploader.net 搭建你自己的 APNs 推送运营平台。