如果你刚开始集成、使用 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文档):
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开启以下设置:
如果没有开启此设置,运行安装到非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,但是无法收到推送。
0条评论