极光推送iOS SDK教程

iOS SDK 调试指南

iOS 调试思维导图





2

确认证书

请到“应用详情页面”确认证书可用性：





3

开发环境测试

在对  JPush iOS 开发环境进行测试前，请确保 3 个统一：

App 是开发环境打包（开发证书 Development）

上传了开发证书并验证通过

Portal 上的应用设置为开发环境

发布环境测试

在对  JPush iOS 生产环境进行测试前，请确保 3 个统一：

App 是 ad-hoc 打包或者App Store 版本（发布证书 Production）

上传了发布证书并验证通过

Portal 上的应用设置为生产环境

可能存在的其他问题

收到消息不够稳定

JPush iOS 是对原生官方 APNs 推送的一个补充，是对其的封装，以帮助开发人员更轻松地使用 APNs 。

由于APNs 本身不承诺保证消息到达，客户端网络与服务器端的连通性，对 APNs 是否及时接收到消息具有很大的影响。

4

iOS 证书 设置指南

创建应用程序ID

登陆 iOS Dev Center 选择进入iOS Provisioning Portal。





5

在 iOS Provisioning Portal中，点击App IDs进入App ID列表。





6

创建 App ID，如果 ID 已经存在可以直接跳过此步骤





7

为 App 开启 Push Notification 功能。如果是已经创建的 App ID 也可以通过设置开启 Push Notification 功能。





8

根据实际情况完善 App ID 信息并提交,注意此处需要指定具体的 Bundle ID 不要使用通配符。





9

配置和下载证书

如果你之前没有创建过 Push 证书或者是要重新创建一个新的，请在证书列表下面新建。





10

新建证书需要注意选择证书种类（开发证书用于开发和调试使用，生产证书用于 App Store 发布）





11

点击 Continue 后选择证书对应的应用ID，然后继续会出现“About Creating a Certificate Signing Request (CSR)”。





12

根据它的说明创建打开KeychainAccess 创建 Certificate Signing Request。





13

填写“User Email Address”和“Common Name” 后选择 Saved to disk 进行保存 。





14

继续返回Apple developer 网站点击 Continue ，上传刚刚生成的 .certSigningRequest 文件生成 APNs Push  Certificate。

下载并双击打开证书，证书打开时会启动“钥匙串访问”工具。

在“钥匙串访问”中你的证书会显示在“我的证书”中，注意选择“My Certificates” 和"login"





15

导出 .p12 证书文件

注意要选“login”和“My Certificates” 导出证书时要选中证书文件，不要展开private key。





16

将文件保存为Personal Information Exchange (.p12)格式。





17

将文件保存为Personal Information Exchange (.p12)格式。

上传证书

在 JPush 管理 Portal 上，针对某应用程序，上传上面步骤得到 .p12 证书文件。这是 iOS SDK 能够接收到 JPush 推送消息的必要步骤。

Provisioning Profile的创建

假设创建了一个App ID：cn.jpush.examlpe，并为此App ID配置开发环境的Push Notifications：





18

创建该App ID的推送证书，如下图:





19

创建App ID、APN证书和p12证书的导出的具体步骤请看 :iOS 证书 设置指南

点击下图按钮开始创建Provisioning Profile：





20

选择此Provisioning Profile的环境后点击[Continue]：





21

选择要创建Provisioning Profile的App ID后点击[Continue]：





22

选择所属的开发者证书，（这里创建了多个开发者证书，建议只创建一个，方便管理）为了方便，选择了[Select All]，再点击[Continue]进入下一步：





23

为该Provisioning Profile选择将要安装的设备（一般选择[Select All]），点击[Continue]:





24

给该Provisioning Profile填写Profile Name，点击[generate]完成创建。





25

点击[DownLoad]下载Provisioning Profile：





26

双击下载下来的Provisioning Profile，添加到xcode。

XCode的证书配置教程

参照iOS SDK 集成指南集成JPush SDK 和上传了推送用到的p12证书后在编译运行前需要先配置一下证书，步骤如下：

打开xxx-info.plist的Bundle identifier项把上传到JPush 控制台的bundle id填写进去：





点击项目，进入Build Setting 界面，向下滑动，去到Code Signing 配置证书：





iOS 7 Background Remote Notification

本次iOS 7在推送方面最大的变化就是允许，应用收到通知后在后台（background）状态下运行一段代码，可用于从服务器获取内容更新。功能使用场景：（多媒体）聊天，Email更新，基于通知的订阅内容同步等功能，提升了终端用户的体验。

Remote Notifications 与之前版本的对比可以参考下面两张 Apple 官方的图片便可一目了然。








如果只携带content-available: 1 不携带任何badge，sound 和消息内容等参数，则可以不打扰用户的情况下进行内容更新等操作即为“Silent Remote Notifications”。





客户端设置

开启Remote notifications

需要在Xcode 中修改应用的 Capabilities 开启Remote notifications，请参考下图：





修改通知处理函数

当注册了Backgroud Modes -> Remote notifications 后，notification 处理函数一律切换到下面函数，后台推送代码也在此函数中调用。

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler；

服务端推送设置

推送消息携带 content-available: 1 是Background 运行的必须参数，如果不携带此字段则与iOS7 之前版本的普通推送一样。

使用Web Portal 推送

在“可选设置内”选择对应的参数。





使用 API 推送

只需在Push API v3 的 ios 内附加content-available":true 字段即可

限制与注意

“Silent Remote Notifications”是在 Apple 的限制下有一定的频率控制，但具体频率不详。所以并不是所有的 “Silent Remote Notifications” 都能按照预期到达客户端触发函数。

“Background”下提供给应用的运行时间窗是有限制的，如果需要下载较大的文件请参考 Apple 的 NSURLSession 的介绍。

“Background  Remote Notification”  的前提是要求客户端处于Background 或 Suspended 状态，如果用户通过 App Switcher 将应用从后台 Kill 掉应用将不会唤醒应用处理 background 代码。

更详细的说明资料请查阅 Apple 官方的 iOS 开发文档。

OS 8 UIUserNotificationSettings

支持版本

v1.8.0 版本开始。

本次iOS 8在推送方面最大的变化就是修改了推送的注册接口，在原本的推送type的基础上，增加了一个categories参数，这个参数的目的是用来注册一组和通知关联起来的button的事件。

这个categories由一系列的 UIUserNotificationCategory组成。每个UIUserNotificationCategory对象包含你的app用来响应本地或者远程通知的信息。每一个对象的title作为通知上每一个button的title展示给用户。当用户点击了某一个button，系统将会调用应用内的回调函数application:handleActionWithIdentifier:forRemoteNotification:completionHandler:或者application:handleActionWithIdentifier:forLocalNotification:completionHandler:。

客户端设置

使用UIUserNotificationCategory

客户端设置

使用UIUserNotificationCategory








服务端设置

服务端payload格式:aps增加category字段，当该字段与客户端UIMutableUserNotificationCategory的identifier匹配时，触发设定的action和button显示。

payload example:{"aps":{"alert":"example", "sound":"default", "badge": 1, "category":"identifier"}}

OS 8 UILocalNotification

本次iOS 8 UILocalNotification增加了三个参数: region、regionTriggersOnce、category。

region: 用于控制当用户进入或者离开某一个地理位置时候，触发通知。使用此功能，用户需要拥有CoreLocation的"when-in-use"权限。

regionTriggersOnce(BOOL)：当为YES时，通知只会触发一次，当为NO时，通知将会在每一次进入或者离开时都触发。

category:如果localNotification通过+[UIUserNotificationSettings settingsForUserNotificationTypes:userNotificationActionSettings:]注册了，通过该category可以获取该通知的注册category.

客户端设置

使用UILocalNotification