苹果推送APNS

关注

原创最新推荐文章于 2026-03-09 00:29:32 发布 1k 阅读 AI 写同款· GEO 优化 ›

APNs 推送通知对接经验总结本文是一篇关于APNs推送通知对接的经验总结，涵盖了从生成推送证书、代码签名证书和描述文件，到构建和部署iOS应用、获取设备令牌、服务器端发送推送通知的完整流程。文中强调了私钥和证书的安全性、证书与代码签名证书的区别、客户端配置的重要性以及证书有效期的管理。同时，还提供了关于推送通知无法到达设备、证书更新和设备令牌变化处理的常见问题解答。作者在文档中分享了详细的步骤和注意事项，旨在帮助IT工程师顺利完成APNs推送通知的对接工作。阅读详情

开发状态服务器地址gateway.sandbox.push.apple.com 2195
产品状态服务器地址gateway.push.apple.com 2195

Development和Production两个版本对应的apnsdevice token是不同的，前者是develop的mobileprovision下获取的。后者是production的mobileprovision获取的。
Development和Production两个版本可以共用一个AppID（不推荐。共用时每次调试前都要删除设备上的app，重新打包生成。而且公用appid会经常抓狂，早上行，下午就不行了。所以不推荐），但是不能共用一个mobileprovision，所以要单独生成Distribution的证书供production版本使用。
注：Distribution的版本是无法在设备上debug调试的！
Development和Production两个版本的codesign是不同的，前者是iPhone Developer，后者是iPhone Distribution。注意不能搞错。

无论是Development Push SSLCertificate还是Production Push SSL Certificate都有过期时间的。Development Push SSLCertificate有效期大概四个月左右，而ProductionPush SSLCertificate的有效期是一年。需要注意在过期之前生成新的证书，以免影响使用。

opensslpkcs12 -clcerts -nokeys -out apns-dev-cert.pem -inapns-dev-cert.p12
opensslpkcs12 -nocerts -out apns-dev-key.pem -inapns-dev-cert.p12
openssl rsa-in apns-dev-key.pem -out apns-dev-key-noenc.pem
catapns-dev-cert.pem apns-dev-key-noenc.pem >apns-dev.pem

在Mac上生成 Apple推送通知SSL许可证：
1. 登录到 iPhone Developer ConnectionPortal 并点击 App IDs
2. 创建一个不使用通配符的 App ID 。通配符 ID不能用于推送通知服务。例如，我们的iPhone程序ID像这样： AB123346CD.com.serverdensity.iphone
3. 点击AppID旁的“Configure”，然后按下按钮生产推送通知许可证。根据“向导”指导的步骤生成一个签名并上传，最后下载生成的许可证。此步骤在 Apple文档中也有谈到。
4. 通过双击.cer文件将你的 aps_developer_identity.cer 引入Keychain中。
5. 在Mac上启动Keychain助手，然后在login keychain中选择 Certificates分类。你将看到一个可扩展选项“AppleDevelopment Push Services”
6. 扩展此选项然后右击“Apple Development Push Services” > Export“Apple Development Push Services ID123”。保存为 apns-dev-cert.p12文件。
7. 扩展“AppleDevelopment Push Services” 对“Private Key”做同样操作，保存为 apns-dev-key.p12文件。
8. 需要通过终端命令将这些文件转换为PEM格式：
openssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -inapns-dev-cert.p12
9. 转换得到key的pem：
openssl pkcs12 -nocerts -out apns-dev-key.pem -inapns-dev-cert.p12
10. 如果你想要移除密码，要么在导出/转换时不要设定或者执行：
openssl rsa -in apns-dev-key.pem -out apns-dev-key-noenc.pem
11. 最后，你需要将键和许可文件合成为apns-dev.pem文件，此文件在连接到APNS时需要使用：
cat apns-dev-cert.pem apns-dev-key-noenc.pem >apns-dev.pem

将此文件保存为一个易记的名字，你有可能以后会用到它。上述步骤同样适合于生成产品许可证。

检验证书是否正确的方法：

$ telnetgateway.sandbox.push.apple.com 2195

Trying 17.172.232.226…

Connected togateway.sandbox.push-apple.com.akadns.net.

Escape character is ‘^]’.

它将尝试发送一个规则的，不加密的连接到APNS服务。如果你看到上面的反馈，那说明你的MAC能够到达APNS。按下Ctrl+C关闭连接。如果得到一个错误信息，那么你需要确保你的防火墙允许2195端口。

然后再次连接，这次用我们的SSL证书和私钥来设置一个安全的连接：

$ openssls_client -connectgateway.sandbox.push.apple.com:2195

-cert PushChatCert.pem-key PushChatKey.pem

Enter pass phrase for PushChatKey.pem:

你会看到一个完整的输出，让你明白OpenSSL在后台做什么。如果连接是成功的，你可以键入一些字符。当你按下回车后，服务就会断开连接。如果在建立连接时有问题，OpenSSL将会给你一个错误消息，但是你不得不向上翻输出LOG，来找到它。

当然上面要测试prodution版本是否正确的话，把gateway.sandbox.push.apple.com换成gateway.push.apple.com就好。

客户端很好做，申请证书，复制代码，就行了。
服务器端，如果是php的，那必须使用.pem的证书，如果是java的，那必须使用.p12的证书。（很可能还需要双击证书进行安装！）
服务器端发出的json包是有大小限制的，最大256字节，包括自定义字典集。
aps中的alert字符串里是可以添加"\n"做换行的。
json包中除了alert,badge,sound之外，还是是可以自定值的。

额外的自定义值：
　　$payload['aps'] = array('alert' => 'This is thealert text', 'badge' => 1, 'sound' =>'default');
　　$payload['server'] = array('serverId' =>$serverId, 'name' => $name);
　　$output = json_encode($payload);
　　当用户按下“View”后，自定义server值将被传递到设备中的程序。JSON 值如下：
　　{
　　"aps" :

{ "alert" :
{
"action-loc-key" : "显示" ,
"body" : "This is the alert text"
},
"badge" : 1,
"sound" : "default" },
　　"server" : { "serverId" : 1, "name" : "Server name")
　　}
　　256字节的限制适用于整个payload，包括自定义字典集。

　　原生接口
　　在ServerDensity中，一旦产生了一条提示，将建立一个payload并插入队列中。因此有必要时我们可以同时发送多个payload。
　　Apple推荐使用这种方法，因为如果你在发送各payload时频繁连接和断开，APNS有可能会封锁你的IP。
　　如Apple 描述:
　　原生接口使用原生socket，具有二进制内容，采用数据流技术，不产生回馈。

高人的总结：
APPLE推送通知服务教程 PART-1
APPLE推送通知服务教程 PART-2
APPLE推送通知服务教程 PART-3
apns php版本：
https://code.google.com/p/apns-php/wiki/CertificateCreation

生成证书需要注意事项：
苹果开发者账号分好几种角色
Agent：代理人，拥有最高权限，可以访问iTunes Connect。
Admin：管理员，拥有管理成员、维护设备列表，维护APPID以及证书列表权限。
Member：普通成员，只读权限。

备注：3013.9.11经过测试，我发现前段时间苹果网站下线期间更新了证书生成机制。以前，利用钥匙串生成一个CSR文件，可以一直用。但是，现在每当你要生成证书，做generate的时候都需要提前重新生成一个CSR文件，否则你生成的证书都是无效的，假证书，尤其是PUSH的，服务端使用这种证书根本无法和APNS建立连接，这种诡异的问题超难跟踪的！希望看到这段话的人都能避免走弯路，不用谢了！

收录于