其实集成第三方SDK这件事情十分简单,并不要把它想得多难,只要你做过一遍就会发现,原来就这么容易啊。只要静下心来,什么都不是事。毛毛躁躁的永远都解决不了问题。主要的还是看文档!看文档!看文档!都说重要的的事情说三遍。关于原理我觉得大家还是有必要了解一下的,因为只有了解了苹果的推送机制,你才会真正弄懂这个东西,而不是去简单的集成一个推送功能。这个我就不展开说了,网上文章一大堆。
1.注册账号+创建应用
按照文档说明注册极光账号,然后登陆该账号,然后根据提示创建应用,这里iOS和安卓是一个应用,里面会有安卓和iOS的相关设置。按着文档一步一步操作。里面的代码可以按着Appdelegate里面的函数对照着看,如果Appdelegate里面有的函数就按照极光的代码复制进去,如果没有该函数就添加。
2.集成推送和相关细节
首先把你的工程运行起来,看看你的打印版会不会打印下图这样的日志
如果打印了说明你已经初步成功的集成了推送。我在这里给大家做一些注释,为后来你们的进一步开发做准备。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];
self.window.backgroundColor = [UIColor whiteColor];
[self.window makeKeyAndVisible];
// Required
if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) {
//可以添加自定义categories
[JPUSHService registerForRemoteNotificationTypes:(UIUserNotificationTypeBadge |
UIUserNotificationTypeSound |
UIUserNotificationTypeAlert)
categories:nil];
} else {
//categories 必须为nil
[JPUSHService registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge |
UIRemoteNotificationTypeSound |
UIRemoteNotificationTypeAlert)
categories:nil];
}
// Required
//如需兼容旧版本的方式,请依旧使用[JPUSHService setupWithOption:launchOptions]方式初始化和同时使用pushConfig.plist文件声明appKey等配置内容。
[JPUSHService setupWithOption:launchOptions appKey:appKey channel:channel apsForProduction:isProduction]; //一般使用上面的方法,这个是新版本推出的方法。
可以在这里设置
// [JPUSHService setAlias:@"123" callbackSelector:nil object:nil];//对某一个特地用户手机推送的时候会用到。
return YES;
}
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// Required
[JPUSHService registerDeviceToken:deviceToken];//获得APNS返回的设备标识符deviceToken
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
// Required,For systems with less than or equal to iOS6
[JPUSHService handleRemoteNotification:userInfo];
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// IOS 7 Support Required 在这里处理点击通知栏的通知之后的一些列操作,执行什么方法写在这里,例如跳转到某个特定的界面
[JPUSHService handleRemoteNotification:userInfo];
completionHandler(UIBackgroundFetchResultNewData);
// 应用正处理前台状态下,不会收到推送消息,因此在此处需要额外处理一下
if (application.applicationState == UIApplicationStateActive) {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"收到推送消息"
message:userInfo[@"aps"][@"alert"]
delegate:nil
cancelButtonTitle:@"取消"
otherButtonTitles:@"确定", nil];
[alert show];
}
[[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];//这个方法可以写在任意你想写的地方,数量代表桌面图标上面推送通知的条数。一般写在程序启动之后。
}
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
//Optional
NSLog(@"did Fail To Register For Remote Notifications With Error: %@", error);
}
3.自定义消息
相关推送通知
API里面提供了下面 5 种类型的通知:
extern NSString * const kJPFNetworkDidSetupNotification; // 建立连接
extern NSString * const kJPFNetworkDidCloseNotification; // 关闭连接
extern NSString * const kJPFNetworkDidRegisterNotification; // 注册成功
extern NSString * const kJPFNetworkDidLoginNotification; // 登录成功
extern NSString * const kJPFNetworkDidReceiveMessageNotification; // 收到自定义消息(非APNS)
其中,kJPFNetworkDidReceiveMessageNotification传递的数据可以通过NSNotification中的userInfo方法获取,包括标题、内容、extras信息等
极光还提供了一种自定义消息,我觉得就是极光建立的一个长连接,这个自定义消息不同于通知是不走APNS的,所以不能在程序完全退出的时候进行消息推送。但是有点是:可以发送更多的内容。
注册接收自定义消息的通知
NSNotificationCenter *defaultCenter = [NSNotificationCenter defaultCenter];
[defaultCenter addObserver:self selector:@selector(networkDidReceiveMessage:) name:kJPFNetworkDidReceiveMessageNotification object:nil];
- (void)networkDidReceiveMessage:(NSNotification *)notification {
NSLog(@"收到了自定义信息");
NSDictionary * userInfo = [notification userInfo];
NSString * content = [userInfo valueForKey:@"content"];
NSDictionary *extras = [userInfo valueForKey:@"extras"];
NSLog(@"extras = %@",extras);
NSLog(@"content = %@",content);
//建立本地通知,如果程序在后台的时候也会收到推送通知一样的消息。也可以判断在程序在前台的时候做一些特别的操作。
[JPUSHService setLocalNotification:[NSDate dateWithTimeIntervalSinceNow:10] alertBody:@"收到了自定义信息" badge:1 alertAction:@"adada" identifierKey:nil userInfo:nil soundName:nil];
}
4.利用极光后台进行测试
极光后台提供了测试极光推送的可视化界面,流程非常简单,填写想要推送的内容,选择iOS或者全部进行推送,就可以在手机查看相关的推送信息了。这里你会看到推送的长度会有限制,所以推送的设计初衷就是提醒用户,而非发送较长的信息。
5.针对某一个用户手机进行推送
点开JPUSHService你会发现里面有几个接口自己是没有用到的,那这是干什么用的呢
// 下面的接口是可选的
// 设置标签和(或)别名(若参数为nil,则忽略;若是空对象,则清空;详情请参考文档:http://docs.jpush.cn/pages/viewpage.action?pageId=3309913)
+ (void)setTags:(NSSet *)tags
alias:(NSString *)alias
callbackSelector:(SEL)cbSelector
target:(id)theTarget;
+ (void)setTags:(NSSet *)tags
alias:(NSString *)alias
callbackSelector:(SEL)cbSelector
object:(id)theTarget;
+ (void)setTags:(NSSet *)tags
callbackSelector:(SEL)cbSelector
object:(id)theTarget;
+ (void)setAlias:(NSString *)alias
callbackSelector:(SEL)cbSelector
object:(id)theTarget;
// 用于过滤出正确可用的tags,如果总数量超出最大限制则返回最大数量的靠前的可用tags
+ (NSSet *)filterValidTags:(NSSet *)tags;
针对设置别名上面我已经给出@“123”的例子,可以在后台进行测试。具体的功能还是看文档
6.总结
这是我集成极光的时候想到的可以分享给大家的所有东西了,希望你们会喜欢,希望对部分Dev会有帮助。如有什么地方不对的,欢迎私信我指正。
欢迎关注我的微博和博客