iOS集成极光推送,绕过一些坑

Tate_zwt 投稿 2016-02-26 06:18:51 25524

最近公司要求把维护期的项目都集成极光推送,集成期间遇到一些小坑,特此在这总结!

极光推送能干嘛?

1.为 JPush Server 上报 Device Token,免除开发者管理 Device Token 的麻烦

2.支持iOS APNs推送

3.前台运行时,可接收由JPush下发的(透传的)自定义消息

4.灵活管理接收用户:Tag(标签分组)、Alias(用户别名)、RegistrationID(设备注册ID)

知道能干嘛了那就开始动手集成????

配push证书:

此步骤直接看极光的文档即可,写得很详细。

导入必要的框架

  • CFNetwork.framework

  • CoreFoundation.framework

  • CoreTelephony.framework

  • SystemConfiguration.framework

  • CoreGraphics.framework

  • Foundation.framework

  • UIKit.framework

  • Security.framework

  • Xcode7需要的是libz.tbd;Xcode7以下版本是libz.dylib

创建并配置PushConfig.plist文件

在你的工程中创建一个新的Property List文件,并将其命名为PushConfig.plist,文件所含字段如下:

CHANNEL:指明应用程序包的下载渠道,为方便分渠道统计,具体值由你自行定义,如:App Store。

APP_KEY:填写管理Portal上创建应用后自动生成的AppKey值。请确保应用内配置的 AppKey 与第1步在 Portal 上创建应用后生成的 AppKey 一致。

APS_FOR_PRODUCTION

1.3.1版本新增,用于标识当前应用所使用的APNs证书环境。

0 (默认值)表示采用的是开发证书,1 表示采用生产证书发布应用。

注:此字段的值要与Build Settings的Code Signing配置的证书环境一致。

在1.2.2或之前版本的配置文件中,有 TEST_MODE 这个键,新版的SDK不再使用,可以将它删除。

313852-e92dae77c5019e5f.jpg

核心代码

首先在AppDelegate.m 导入#import "JPUSHService.h"

~didFinishLaunchingWithOptions方法贴上核心代码:

//极光推送
    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];
    }
    //JAppKey : 是你在极光推送申请下来的appKey Jchannel : 可以直接设置默认值即可 Publish channel
    [JPUSHService setupWithOption:launchOptions appKey:JAppKey
                          channel:Jchannel apsForProduction:NO]; //如果是生产环境应该设置为YES

之后还需要加入以下方法:

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {    // Required
    [JPUSHService registerDeviceToken:deviceToken];
}
-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo{
    NSString *alert = [[userInfo objectForKey:@"aps"] objectForKey:@"alert"];
    if (application.applicationState == UIApplicationStateActive) {
        UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"推送消息"
                                                            message:alert
                                                           delegate:self
                                                  cancelButtonTitle:@"OK"
                                                  otherButtonTitles:nil];
        [alertView show];
    }
    [application setApplicationIconBadgeNumber:0];
    [JPUSHService handleRemoteNotification:userInfo];
}

我们还能监听极光推送生命周期通知。API里面提供了下面 5 种类型的通知:

API里面提供了下面 5 种类型的通知:

extern NSString * const kJPFNetworkDidSetupNotification; // 建立连接
extern NSString * const kJPFNetworkDidCloseNotification; // 关闭连接
extern NSString * const kJPFNetworkDidRegisterNotification; // 注册成功
extern NSString * const kJPFNetworkDidLoginNotification; // 登录成功
温馨提示: 
Registration id 需要在执行到kJPFNetworkDidLoginNotification的方法里获取
extern NSString * const kJPFNetworkDidReceiveMessageNotification; // 收到自定义消息(非APNS)
其中,kJPFNetworkDidReceiveMessageNotification传递的数据可以通过NSNotification中的userInfo方法获取,包括标题、内容、extras信息等

使用方法

Tag(标签分组)& Alias(用户别名)

//用于绑定Tag的 根据自己想要的Tag加入,值得注意的是这里Tag需要用到NSSet
[JPUSHService setTags:[NSSet set]callbackSelector:nil object:self];
//用于绑定Alias的  使用NSString 即可
[JPUSHService setAlias:@"" callbackSelector:nil object:self];

如果想要即要绑定Alias也要绑定Tag,必须使用以下方法,已被坑

//用于同时绑定Tag与Alias的
[JPUSHService setTags:[NSSet set] alias:@"" callbackSelector:nil target:self];

一般在项目哪里绑定呢?

我主要是在项目的登录成功或者自动登录后,使用用户的唯一标示进行绑定,或者根据需求添加一些前缀

去除绑定

用户进行退出登录的方法里添加去除绑定即可,值得注意的是用到即时通讯的话,被挤下线也要去除绑定,已被坑,贴代码:

//没有值就代表去除
[JPUSHService setTags:[NSSet set]callbackSelector:nil object:self];
[JPUSHService setAlias:@"" callbackSelector:nil object:self];
[JPUSHService setTags:[NSSet set] alias:@"" callbackSelector:nil target:self];

测试是否集成成功。到极光平台测试推送:

313852-ffaf1b475c5debb7.jpg

只要推送成功,剩下的由后台根据Alias或者Tag来推送就可以了????

JPushSDK资源下载