版本记录

版本号	时间
V1.0	2017.05.15

前言

前一篇已经对ios的SDK进行了研究，这一篇则对iOS SDK 常见问题进行说明。
1. 极光推送集成（一）

2. 极光推送集成（二）

3. 极光推送集成（三）

4. 极光推送集成（四）

5. 极光推送集成（五）

6. 极光推送集成（六）

下面说一下iOS SDK 的常见问题。

iOS SDK 常见问题

一、iOS 9集成

1.iOS 9变动影响SDK部分:

增加了bitCode编码格式,当SDK不支持bitCode时，用户集成时无法开启bitCode选项.
- 现象:用户集成SDK后无法编译通过，错误日志里包含了bitCode的相关错误信息
默认使用https连接,如果请求为http,需要手动配置plist来支持http服务，当前我们的服务器请求都走http服务。
- 现象:用户集成SDK后，所有JPush相关的http服务都提示连接错误或者连接超时,可能是此问题。

2.bitCode解决方式

JPush iOS SDK v1.8.7 及以上版本的SDK,已经增加对 iOS 9 新特性 bitCode 的支持.JMessage iOS SDK v2.0.0 及以上版本支持bitCode。

3.Https解决方式

SDK未提供https地址版本时

需要用户主动在当前项目的Info.plist中添加NSAppTransportSecurity类型Dictionary。
在NSAppTransportSecurity下添加NSAllowsArbitraryLoads类型Boolean,值设为YES。

二、iOS 如何推送自定义声音

客户端需要将声音文件导入工程里，选中工程Target -> Build Phrases -> Copy Bundle Resources。

自定义声音

服务端推送时，需要指定iOS 平台下的sound参数，具体传入的值是声音文件名＋后缀。

三、为什么iOS收不到推送消息？

如果你确认 appKey 在 SDK 客户端与 Portal 上设置是一致，其他环节也按照文档正确地操作。但还是收不到推送消息。那么，有一定的可能性，是你在 Portal 上上传的证书，不是 APNs (Push) 证书。推送时指定的iOS推送环境和应用证书是同一个环境。请参考iOS 证书设置指南再次检查证书选择是否正确。

请注意：iOS能接受消息的必要条件是：应用程序的证书要和你上传到jpush portal上的证书对应，如果你的程序是直接在xcode上运行的，你的应用部署环境必须是开发状态才能收到APNS消息。

温馨提示：目前api推送的时候可以通过参数apns_production可以指定推送环境，false为开发环境，true为生产环境。V3 api不带此参数则默认为生产环境，V3 api封装的sdk 默认为开发环境。如果api有传apns_production则以此值为准，否则以应用详情的部署环境为准。

四、为什么启动的时候出现 Did Fail To Register For Remote Notifications With Error的错误

程序运行的时候出现下面的错误信息：

did Fail To Register For Remote Notifications With Error: Error Domain=NSCocoaErrorDomain Code=3000 "未找到应用程序的“aps-environment”的权利字符串" UserInfo=0x1c55e000 {NSLocalizedDescription=未找到应用程序的“aps-environment”的权利字符串}

这个是由于你的Provisioning Profile文件，不具备APNS功能导致的。请登陆Apple Developer 网站设置好证书，更新Provisioning Profile，重新导入Xcode。或参考博客

五、如何在接收到 APN 的时候获取 APN 消息内容并进行跳转或做出响应处理？

获取 APNs 推送内容

六、如何关闭 APN 推送？

可通过调用代码

// iOS 8 以上可用此方法
[[UIApplication sharedApplication] openURL:[NSURL URLWithString:UIApplicationOpenSettingsURLString]] ;

进入您的应用的设置页面，点击“通知设置”，用户手可以动变更“允许通知”的状态。

七、App badge number（角标）如何更改与清空？

JPush 网站上推送 iOS 通知时，可在［可选设置］里面指定 badge 参数的值，如：1或"+1"。

api上指定badge的参数请看：Push API
客户端上报badge到JPush服务器的接口请看:设置badge
关于badge ＋1的介绍，请看APNs Notification badge

八、Icon Badge number 的清空方法：

APN 推送内容指定 badge number 为 0；
在代码中使用如下代码清空 badge number： [[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];

注意：
badge累加只能通过v3 api推送，且只有1.7.4版本以上才能支持。

九、为何推送一条 APN 后，点击通知中心的 APN 通知打开 App，可是 APN 通知在通知中心依然存在而未被删除？

如果推送 APN 时，Badge number 被指定为0 ，则可能出现 APN 消息在通知中心被点击后，尽管调用了 [[UIApplication sharedApplication] setApplicationIconBadgeNumber:0]; 但 APN 消息在通知中心不会被删除的情况。这种情况可以按如下代码调用以清除通知中心的 APN 通知。

[[UIApplication sharedApplication] setApplicationIconBadgeNumber:1];
[[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];

如果仍有其他消息，则考虑清除 local notification 通知。
（ [[UIApplication sharedApplication] cancelAllLocalNotifications] ）

十、出现Not get deviceToken yet. Maybe: your certificate not configured APNs?...错误日志时如何排除问题?

如果出现上述日志，则说明一段时间内都无法获取device token，那么：

确认你的app配置了apns权限，如果未配置apns权限，则应该会出现此错误提示。
确认你的app运行在ios真机而非模拟器上，且通知中心中对应app的通知权限没有完全关闭（alert/sound/badge至少有一个权限是打开的）。
确认你的网络状况，与apple的服务器的连接是通过tcp的 5223端口连接，确认你网络的对应端口是否可用，可通过下列命令来确认这点：

telnet 1-courier.push.apple.com 5223

在代码中可在以下两个函数中断点以确认device token的获取状态。

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken;

- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error;

如果app运行进入 didFailToRegisterForRemoteNotificationsWithError 则说明app的APNS权限问题或者app运行在模拟器，参考证书设置文档。
如果app运行进入didRegisterForRemoteNotificationsWithDeviceToken 则说明运行正常，请确认你在此函数中的代码中有将token传递给jpush的调用：

[JPUSHService registerDeviceToken:deviceToken];

如果以上两个registerRemoteNotification的函数都未进入，请确认你的代码中有注册申请apns的函数调用：

[JPUSHService registerForRemoteNotificationTypes:];

如果上述情况都已确认且未进入第4步的任意回调函数，则可以判断无法获取token的原因在于设备与apple的网络连通性问题（注：一个设备只有在未申请过token的情况下才会需要与apple的网络交互来获取token，已经获取过某一环境token的设备在无网络的情况下也能获取到对应环境的token（环境分为开发/生产）），这种情况下切换网络能够在大部分情况下解决此问题。
如果仍然有问题，请将上述步骤的结果以邮件附件的形式发送到JPush支持邮箱，我们将协助你解决此问题。

十一、上传到appStore的版本为什么收不到推送？

请确认xcode选择的生产证书和上传的证书的bundleid一致；
如果是在jpush网站上推送，请确认新建通知时推送对象是否选择了生产环境；
如果是v3 api推送，请确认是否使用了apns_production参数，值是否为：true；如果没有使用apns_production参数请确认jpush网站上该应用的部署环境是否已经切换到生产环境。

十二、iOS 平台上传证书一直为未通过状态

证书上传未通过的原因一般有：

密码错误；
上传的apns证书环境不一致；
上传到控制台必须是apns证书，非apns证书会带来错误，还有其他的原因可能是开发者证书也可能是apns证书那里导出来的私钥。

具体请看上传后显示的错误输出内容

十三、为什么日志里面会打印：You've implemented -[ application:didReceiveRemoteNotification:fetchCompletionHandler:], but you still need to add "remote-notification" to the list of your supported UIBackgroundModes in your Info.plist.

这个主要是提示开发者如果要支持UIBackgroundModes，需要开启Remote notifications，具体操作可以看：iOS 7 Background Remote Notification

后记

极光推送理论和常见问题就这些了，以后我会加一下我写的工程上的代码。有什么不对的地方，欢迎发邮件或者私信我，谢谢大家。

她很美！

极光推送集成（七）