前言
最近要把维护期的项目都集成极光推送，集成期间遇到一些小坑，特此在这总结！
极光推送能干嘛？
1.为 JPush Server 上报 Device Token，免除开发者管理 Device Token 的麻烦
2.支持iOS APNs推送
3.前台运行时，可接收由JPush下发的（透传的）自定义消息
4.灵活管理接收用户：Tag（标签分组）、Alias（用户别名）、RegistrationID（设备注册ID）
知道能干嘛了那就开始动手集成👌
配push证书：
此步骤直接看极光的 文档即可,写得很详细😄
导入必要的框架
1
2
3
4
5
6
7
8
9
10
| 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不再使用，可以将它删除。
核心代码
首先在
AppDelegate.m
导入
#import “JPUSHService.h”
在对应的方法
didFinishLaunchingWithOptions
里贴上核心代码：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| //极光推送
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
|
之后还需要加入以下方法：
1
2
3
4
| - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// Required
[JPUSHService registerDeviceToken:deviceToken];
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| -(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];
}
|
我们还能监听极光推送生命周期通知：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| 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（用户别名）
1
2
3
4
| //用于绑定Tag的 根据自己想要的Tag加入，值得注意的是这里Tag需要用到NSSet
[JPUSHService setTags:[NSSet set]callbackSelector:nil object:self];
//用于绑定Alias的 使用NSString 即可
[JPUSHService setAlias:@"" callbackSelector:nil object:self];
|
如果想要即要绑定Alias也要绑定Tag,必须使用以下方法，已被坑
1
2
| //用于同时绑定Tag与Alias的
[JPUSHService setTags:[NSSet set] alias:@"" callbackSelector:nil target:self];
|
一般在项目哪里绑定呢？
我主要是在项目的登录成功或者自动登录后，使用用户的唯一标示进行绑定，或者根据需求添加一些前缀
去除绑定
用户进行退出登录的方法里添加去除绑定即可，值得注意的是用到即时通讯的话，被挤下线也要去除绑定，已被坑，贴代码：
1
2
3
4
| //没有值就代表去除
[JPUSHService setTags:[NSSet set]callbackSelector:nil object:self];
[JPUSHService setAlias:@"" callbackSelector:nil object:self];
[JPUSHService setTags:[NSSet set] alias:@"" callbackSelector:nil target:self];
|
测试是否集成成功
到极光平台测试推送：
只要推送成功，剩下的由后台根据Alias或者Tag来推送就可以了😄
补充
关于推送来的小红点角标，简称badge。默认是极光推送过来一次角标+1，这个值badge是由后台推送过来的消息传的值，但是当用户看了，角标会默认被清除，如果你没有去告诉后台的话，后台下次推送过来，你的badge显示的值还是你上一次的值加一，那如何解决这个问题呢？
细心的开发者会去查看极光推送的API文档，但是我觉得看文档就有点麻烦了，所以我直接去看JPUSHService.h文件，所以我发现极光为这个问题提供了解决的方法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| /*!
* @abstract 设置角标(到服务器)
*
* @param value 新的值. 会覆盖服务器上保存的值(这个用户)
*
* @discussion 本接口不会改变应用本地的角标值.
* 本地仍须调用 UIApplication:setApplicationIconBadgeNumber 函数来设置脚标.
*
* 本接口用于配合 JPush 提供的服务器端角标功能.
* 该功能解决的问题是, 服务器端推送 APNs 时, 并不知道客户端原来已经存在的角标是多少, 指定一个固定的数字不太合理.
*
* JPush 服务器端脚标功能提供:
*
* - 通过本 API 把当前客户端(当前这个用户的) 的实际 badge 设置到服务器端保存起来;
* - 调用服务器端 API 发 APNs 时(通常这个调用是批量针对大量用户),
* 使用 "+1" 的语义, 来表达需要基于目标用户实际的 badge 值(保存的) +1 来下发通知时带上新的 badge 值;
*/
+ (BOOL)setBadge:(NSInteger)value;
|
而且我还发现极光推送也能收集Crash日志,之前只知道友盟与听云
1
2
3
4
5
6
7
| /*!
* @abstract 开启Crash日志收集
*
* @discussion 默认是关闭状态.
*/
+ (void)crashLogON;
|
如何改变推送过来的提示音呢？
只需要让服务端设置sound字段就可以了。
iOS 通知声音 (sound)
APNs通知，通过这个字段指定声音。默认为default，即系统默认声音。
如果设置为空值，则为静音。
如果设置为特殊的名称，则需要你的App里配置了该声音才可以正常。