iOS推送测试——Easy APNs Provider
很多同学在接入APNS服务的时候,十有八九会遇到不少问题。尤其是在接某些第三方推送服务SDK的时候。这里介绍一下如何使用Easy APNs Provider测试推送,以后就可以判断是在哪个环节出了问题了,非常方便。
推送设置
要实现推送需要两个前提:
-
打开capabilities的push notifications选项
-
打开capabilities的background modes中的Remote notifications
当然最为重要的还是需要在AppDelegate中写相关的代码,下面是一个简单的例子,可以在这个逻辑更改。很多同学会遇到为什么什么娶不到token的问题,原因就是或多或少你少了下面的某些代码。
推送代码
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
[self registRemoteNotification];
return YES;
}
- (void)registRemoteNotification {
#ifdef __IPHONE_8_0
if ([[UIApplication sharedApplication] respondsToSelector:@selector(registerUserNotificationSettings:)]) {
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge|UIUserNotificationTypeSound|UIUserNotificationTypeAlert categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
} else {
UIRemoteNotificationType myTypes = UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeSound;
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:myTypes];
}
#else
UIRemoteNotificationType myTypes = UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeSound;
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:myTypes];
#endif
}
#pragma mark - remote Notification
- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings{
[application registerForRemoteNotifications];
}
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(nonnull NSData *)devToken {
NSString *devToken_str = [NSString stringWithFormat:@"%@",devToken];
devToken_str = [self removeSpace:devToken_str];
devToken_str = [self removeBracket:devToken_str];
NSLog(@"%@", devToken_str);
[[NSNotificationCenter defaultCenter] postNotificationName:@"PUSHTOEKN" object:nil userInfo:@{@"token":devToken_str}];
}
- (void) application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
NSLog(@"%@",error);
}
//ios 7.0
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
NSLog(@"did recevive remote noti userInfo %@ for ios 7 ",userInfo);
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
/**
* 系统会估量App消耗的电量,并根据传递的UIBackgroundFetchResult 参数记录新数据是否可用
* 调用完成的处理代码时,应用的界面缩略图会自动更新
*/
NSLog(@"did Receive Remote Notification userInfo %@",userInfo);
switch (application.applicationState) {
case UIApplicationStateActive:
completionHandler(UIBackgroundFetchResultNewData);
break;
case UIApplicationStateInactive:
completionHandler(UIBackgroundFetchResultNewData);
break;
case UIApplicationStateBackground:
completionHandler(UIBackgroundFetchResultNewData);
break;
default:
break;
}
}
- (NSString *)removeSpace:(NSString *)str{
NSString *r_str = [str stringByReplacingOccurrencesOfString:@" " withString:@""];
return r_str;
}
- (NSString *)removeBracket:(NSString *)str{
NSString *r_str = [str stringByReplacingOccurrencesOfString:@"<" withString:@""];
r_str = [r_str stringByReplacingOccurrencesOfString:@">" withString:@""];
return r_str;
}
测试工具
这是一个良心的测试工具,Mac AppStore下载地址Easy APNs Provider
具体使用页面:
使用步骤按照界面所标注的1——6进行,接下来分别介绍。
1. 添加Token
添加Token界面.
建议不要弄什么花里胡哨的,最好使用手动添加。
连接真机运行,打Log获取deviceToken
#pragma mark 注册通知
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(nonnull NSData *)deviceToken
{
NSLog(@"deviceToken:%@",deviceToken);
}
注意:输出的deviceToken是NSData类型的,要的就是这个.
输出的Log如下:
deviceToken:<9bf8412c 55df912e 12e689f3 4c4a4c72 361262bb efbdf526 e01ebb6d 223a80c9>
把那一串数字字符组合粘贴出来删除空格,然后复制粘贴到手动添加的框里
注: 1、不要token两端的尖括号 2、空格删完之后再添加,那个框框只能放64个字符,多的会自动删除
2. 添加证书
一般推送证书有一下三类。voip相关的证书可能有些同学用不到,这也没关系。这里讲讲Token和证书之间的关系,非常非常重要!!!
15288888918570.jpg
- Token和推送证书必须配对,也就是Debug下的Token,不能用Release的推送证书;Release下的Token,不能用Debug的推送证书,
-
苹果会根据应用是开发包(Debug)还是发布包(Release)发送不同的Token。如下图所示
3. 选择苹果APNS地址
Apple提供了Debug和Release的两个地址,一个是gateway.sandbox.push.apple.com
,另一个是gateway.sandbox.push.apple.com
。如下所示
同样APNS地址和证书也必须匹配。
4. 设置推送内容
支持推送的内容有标题、内容、未读数(图标)、声音。比较遗憾的是没有支持iOS10之后可以推送图片视图等入口。不过对于一般推送而言已经够了。
不要被这里的图标所迷惑了,其实这里的图标就是所谓的未读数。
注意一下Content-Avaliable:
5.发送推送
在发送之前一定要在步骤3的时候,连接到APNS地址
如果一切正常的情况下,会在下面的信息框中提示:
正在连接到gateway.sandbox.push.apple.com
已连接至服务器,正在验证身份...
身份已验证,您可以发送推送消息了。
推送已尝试发送至test,APN识别:0x0BC5816B
当然,如果你证书和服务器不匹配,则会提示:
正在连接到gateway.push.apple.com
已连接至服务器,正在验证身份...
身份已验证,您可以发送推送消息了。
服务端主动断开连接,这可能是由于证书错误,发送的数据错误,网络错误等原因引起的。
如果你的token和证书不匹配,则会提示:
正在连接到gateway.sandbox.push.apple.com
已连接至服务器,正在验证身份...
身份已验证,您可以发送推送消息了。
推送已尝试发送至test,APN识别:0x22E82902
尝试发送推送到test失败,错误描述:无效的设备Token,APN识别:0x22E82902
服务端主动断开连接,这可能是由于证书错误,发送的数据错误,网络错误等原因引起的。
6. 断开连接
一般在想要换证书或者服务器地址的时候才需要断开,进而重新建立连接。
可能遇到的问题
process launch failed
Debug环境运行没问题,Release环境会弹出以下提示:
解决办法,在Release的环境下去掉断点即可,参照下图:
注:Debug executable 意思是是否可以断点执行,Release模式下不可以打断点,所以这项要勾掉,勾掉之后不会影响Log的输出。
token不匹配
一般在我们在上传服务端token的时候会标识当前的环境是debug还是release环境下的token。我们简称devtype,0代表release,1代表debug。那么在特别注意在debug环境下一定要传1,release环境下传0。而实际项目中往往有多个开关控制环境,比如调用的API的、传递token的。千万不要忘了其中一个!