如果你刚开始集成、使用 JPush iOS SDK,你可能会遇到各种各样的问题,下面是我们整理的一些注意事项,给大家作为参考。


1、

从iOS9系统开始,使用通配证书也能成功获取到Token,但是无法收到推送的通知(APNs);

注:
1、JPush iOS SDK 从2.1.7版本开始,如果当前应用不具备推送功能会打印:PUSH | W - [JPUSHClientController] APNs is not available,please check your provisioning profile and certification
2、iOS9以前的系统会在

  • (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
    方法打印:
    Error Domain=NSCocoaErrorDomain Code=3000 "未找到应用程序的“aps-environment”的权利字符串"

2、

运行安装项目到测试设备,假设你的Provisioning Profile选择自动,如果测试设备是iOS9系统,且本地的Provisioning Profile不含此设备,仍能正常运行安装到测试设备并获取到Token!其实你这时安装的是通配证书的应用,你将无法收到APNs推送;请参考JPush的教程文档配置项目证书:XCode的证书配置教程

注:
JPush iOS SDK 从2.1.7版本开始,如果当前应用不具备推送功能会打印:PUSH | W - [JPUSHClientController] APNs is not available,please check your provisioning profile and certification


3、

从iOS9系统开始,每次卸载安装都会获取到新的Token。如果你没有使用传IDFA的JPush初始化接口,那JPush会认为你当前是一个新的设备,RegistrationId会随之改变,之前设置的tag、alias需要重新设置;


4、

从iOS9系统开始,新安装某个调用apns注册接口且开启Capabilites-Background Modes-Remote notifications选项的应用,弹出[“xxx”想给您发送推送通知]的提示时,无需你否允许,应用都能获取到Token;


5、

JPush没有提供开关推送的接口,但是可以调用apple的注册APNs接口和反注册APNs接口来设置是否有通知提醒!

注:从iOS9.3系统开始,调用代码注册APNs,再调用反注册APNs接口,需要把应用进程杀掉在发起apns,重新开启才能恢复APNs提示;


6、

JPush iOS SDK从2.1.8版本开始支持https,如集成的SDK 版本低于2.1.8,请到xxx-info.plist里面配置下http,否则无法统计通知点击和调用JPUSHService setBadge:<#(NSInteger)#>来上报badge,具体配置看文档:https解决方式


7、

如果你是直接运行安装到测试设备(运行调试状态),那你的安装的应用的证书环境只有可能是开发环境或者通配的。向该设备(RegistrationID)推送开发环境的通知,如果能收到(目标和成功为:1/1),则说明是当前安装的应用是开发环境的证书;如果目标和成功为(0/0),则可能是通配证书。应用证书环境具体以Code Signing配置为准:


8、

如果你想内部测试生产环境的推送,请去apple上面为该appid创建一个AD-Hoc的Provisioning Profile,下载,添加到XCode,Archive项目,export ipa文件,把该ipa拖到iTunes,再同步到测试设备。
导出的时候下图标注的Profile必须是你所创建的AD-Hoc Profile:


9、

第7、8点说到安装应用证书环境的判断依据,那这里再说明下:推送的时候如何指定iOS通知的推送环境。
进入官方控制台的发送通知页面,可通过如下选项指定iOS通知的推送环境:

如果你通过api推送,则需要注意options下面的apns_production字段。官网发送通知的

对应的"apns_production":false和"apns_production":true(推送api文档):

JPush Java SDK 示例代码和注释传送门

iOS Push SDK的初始化接口:
+ (void)setupWithOption:(NSDictionary *)launchingOption
                 appKey:(NSString *)appKey
                channel:(NSString *)channel
       apsForProduction:(BOOL)isProduction;

注:
项目中配置的证书环境决定你的app能收到来自哪个环境的通知(APNs);
初始化接口的isProduction字段需要与你应用配置的证书环境一致。

即:
如果按照第7点的配置证书,isProduction的值应该是false;
如果按照第8点的配置证书,isProduction的值应该是true;
如果发布到App Store,,isProduction的值应该是true

10、

请不要在初始化应用的方法


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
///
}

里面设置tag、alias和获取registrationID ,如果你在这里设置tag、alias和获取registrationID,你将无法获取到registrationID,设置tag、alias会打印:E - [JPUSHService] app not registed, give up set tag:xxx,alias:xxx

建议如下:

注:想了解集成文档的[五个监听]请戳我
如不知道该如何添加监听,请参考官方 demo的:RootViewController.m;


11、

应用前台运行的时候收到APNs不会有提示(横幅、sound),只会调用apple提供的APNs获取接口:获取 APNs(通知) 推送内容,如果想弹出提示请自己在获取接口里面写代码处理;


12、

后台收到普通APNs,点击icon进入应用并不会触发APNs获取接口,只有点击通知才会触发获取接口;


13、

从JPush下的发iOS自定义消息,只有在前台运行的时候才能收到(不会有apns提示),如果想要获取由JPush 下发的自定义消息,请看:获取自定义消息推送内容

注:如果想了解通知和自定义消息的区别请看:常见问题的通知与自定义消息有什么区别?


14、

建议在AppDelegate.m的applicationWillResignActive方法写代码调整本地的badge显示和重置JPush服务器上面Badge值,示例代码如下:

- (void)applicationWillResignActive:(UIApplication *)application {

        [JPUSHService setBadge:0];//重置JPush服务器上面的badge值。如果下次服务端推送badge传"+1",则会在你当时JPush服务器上该设备的badge值的基础上+1;

        [[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];//apple自己的接口,变更应用本地(icon)的badge值;
}

注:
1)JPush的badge上报接口可根据实际使用场景计算再调用接口上报;
2)应用icon上显示的badge最好在applicationWillResignActive方法里面设为最终计算所得的值。


15、

如果你之前能正常推送iOS通知,忽然所有推送记录的结果都变成了:0/0。这个时候你需要去到JPush控制台,进入该应用的 [应用设置]页面,检查证书的有效期,如果没有过期,则去到apple账号检查该证书是否还在(以appid+有效期来看)

注:无论是上述何种原因,你都需要在apple账号上下载该bundle id的有效APNs证书,添加到本地,导出p12文件,上传到JPush官网

16、

使用XCode8开发,请在Application Target开启以下设置:
null

如果没有开启此设置,运行安装到非iOS 9系统的设备会打印:

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

注:
如果运行安装的设备是iOS9,可以成功获取到Device Token,但是无法收到推送。