iOS 推送怎么配置,APNs 推送证书、设备库与群发

4 阅读2分钟

推送

配置 APNs 推送证书并创建推送通道,获取 App Key 供你的 App 上报设备 token;支持设备库管理、按通道群发消息,并查看每次推送的发送结果与历史记录。这是一套独立于 App Store Connect 的运营推送平台,分四个标签页:推送通道、设备库、发送、历史。

推送通道

打开 appuploader 绑定一张已签发的 APNs 推送证书,得到一个 App Key,供你的 App 上报设备 token:

  1. 点击「新建通道」。
  2. 选择一张推送证书(若列表为空,需先在「证书」页面签发一张 APNs 推送证书)。
  3. 输入该证书 .p12 的导出密码——证书若在云端有备份,输入密码即可取出私钥;仅本地保存 .p12 文件时同样需要密码。
  4. 填写通道名称(如「营销推送」),选择环境(生产 / 沙盒)。
  5. 提交后通道创建完成,可在「接入代码」中查看给开发同学的接入说明。

删除通道时请注意:该通道下的设备库和发送历史会一并删除,且 App Key 立即失效,此操作不可撤销。

设备库

管理已上报的设备 token:

  • 支持按备注 / token / 标签搜索。
  • 可以「手动添加」设备——填写设备 Token(支持带空格或尖括号,会自动清理)、备注、标签。
  • 可以编辑设备的标签(用逗号分隔多个标签),或将设备从设备库移除。
  • 列表展示状态(有效/失效)与最近上报时间。

发送

打开 appuploader 选择通道后即可编写通知:

  1. 填写标题、内容、声音(默认提示音/静音)、角标数字;或切换「高级模式」直接编辑原始 JSON Payload。
  2. 选择发送目标:全部设备 / 按标签 / 指定设备。
  3. 系统会提示将发往多少台有效设备,确认无误后点击「立即发送」。
  4. 发送完成后会显示成功/失败的设备数量。

历史与投递报告

「历史」标签页记录每次发送的时间、内容、目标与结果(成功/失败数量),点击「详情」可查看逐设备的投递报告(成功/失败/已投递及失败原因),也可以「重发」某一条历史记录。

设备接入说明

「设备接入说明」提供上报接口地址和 iOS 示例代码:开发同学需要在 Xcode 的 Signing & Capabilities 中添加 Push Notifications,并把示例方法放入 AppDelegate,让 App 在拿到 APNs token 后调用上报接口,设备即自动进入「设备库」。测试时可选择手机所在的局域网地址,确保手机与本机处于同一 Wi-Fi。