前言：
说到这个远程推送，大家知道的应该都挺多的，但用到的估计极光和个推要占一很大部分，这篇博客重点说的就是个推的使用，个推官网的链接在这里，它的集成是比较方便的，你可以直接使用Cocoapods集成，待会再下面命令行也会给大家分享出来，这我们还会提到的有它的一个推送流程，还有SDK的一些使用以及在使用的过程中我们需要注意的地方：
先看看个推的推送流程图：
集成中建议利用Cocoapods集成，建议还是集成这个无IDFA版本，下面是命令行，至于为什么建议集成这个版本的，个推的文档中也有这样一段话：“在 App 内无广告情况下还是建议开发者使用获取 IDFA 版本，并提交 AppStore 审核。 集成 IDFA 而未集成任何广告服务可能会遭到 Apple 拒绝。”。
platform :ios pod 'GTSDK', '1.5.3-noidfa'
推送需要注意点：
一：在 Xcode 8.0 以上，必须开启Push Notification能力，操作看下图：
二：为了更好支持消息推送，SDK可定期抓取离线消息，提高消息到达率，需要配置后台运行权限，操作如下：
个推把你需要勾选的这两个选项也作出了解释：
Background fetch： 后台定期获取权限
Remote notifications：APNs静默推送权限
代码使用说明：
还是建议大家给个推创建一个APPDelegate的类别，如下图所示：
下一步就是注册远程通知 即用户是否同意接收通知，源代码如下：
/** 注册远程通知 即用户是否同意接收通知 */
- (void)registerRemoteNotification {
/*
Xcode8的需要手动开启“TARGETS -> Capabilities -> Push Notifications”
*/
/*
下面的方法区分10.0之后版本和之前版本
该项目的最低适配版本是8.0之后的，所以放弃8.0之前注册远程通知方法
*/
if ([[UIDevice currentDevice].systemVersion floatValue] >= 10.0) {
#if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_10_0 // Xcode 8编译会调用
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
center.delegate = self;
[center requestAuthorizationWithOptions:(UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionCarPlay) completionHandler:^(BOOL granted, NSError *_Nullable error) {
if (!error) {
// NSLog(@"request authorization succeeded!");
}
}];
[[UIApplication sharedApplication] registerForRemoteNotifications];
#else
// Xcode 7编译会调用
UIUserNotificationType types = (UIUserNotificationTypeAlert | UIUserNotificationTypeSound | UIUserNotificationTypeBadge);
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
[[UIApplication sharedApplication] registerForRemoteNotifications];
#endif
// 大于等于8.0系统的就用这个方法注册远程通知
}else if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0){
UIUserNotificationType types = (UIUserNotificationTypeAlert | UIUserNotificationTypeSound | UIUserNotificationTypeBadge);
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
[[UIApplication sharedApplication] registerForRemoteNotifications];
}
}
#pragma mark - 远程通知(推送)回调
/** 远程通知注册成功委托 */
-(void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
NSString *token = [[deviceToken description] stringByTrimmingCharactersInSet:[NSCharacterSet characterSetWithCharactersInString:@"<>"]];
token = [token stringByReplacingOccurrencesOfString:@" " withString:@""];
// 获取到的Token
// NSLog(@"
>>>[DeviceToken Success]:%@
", token);
// [ GTSdk ]：向个推服务器注册deviceToken，这个方法写在类别里面！
[self registerDeviceTokenToGeTuiSDK:token];
}
/** 远程通知注册失败委托 */
-(void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
// NSLog(@"
>>>[DeviceToken Error]:%@
", error.description);
}
原本想着把SDK的方法一个一个写出来解读的，不过那样子感觉就像官方文档了，没什么意思了，在这里我直接把AppDelegate+getui.m这整个文件的代码写出来，每一个方法都是有说明的，里面很多点也是写在了注释当中，这样就觉得更完整，可读性更高一点：
@implementation AppDelegate (getui)
// 初始化个推SDK
-(void)initGeTuiSDK{
// [ GTSdk ]：使用APPID/APPKEY/APPSECRENT创建个推实例
// 通过个推平台分配的appId、 appKey 、appSecret 启动SDK，
// 注：该方法需要在主线程中调用
[GeTuiSdk startSdkWithAppId:GTAPPID appKey:GTAPPKEY appSecret:GTAPPSECRET delegate:self];
}
// Background Fetch 恢复SDK 运行
-(void)BackgroundFetchGeTuiSdk{
// Background Fetch 恢复SDK 运行
[GeTuiSdk resume];
}
// 同步本地角标值到服务器
-(void)setBadgeGeTuiSdk:(NSInteger)badge{
[GeTuiSdk setBadge:badge];
}
// 重置角标计数
-(void)resetBadgeGeTuiSdk{
[GeTuiSdk resetBadge];
}
/**
向个推注册deviceToken
@param deviceToken deviceToken
*/
-(void)registerDeviceTokenToGeTuiSDK:(NSString *)deviceToken{
// 向个推服务器注册deviceToken
[GeTuiSdk registerDeviceToken:deviceToken];
}
/*
将收到的APNs信息传给个推统计
@param userInfo 获取到的消息
*/
-(void)handleRemoteNotificationToGrTuiSDK:(NSDictionary *)userInfo{
// 将收到的APNs信息传给个推统计
[GeTuiSdk handleRemoteNotification:userInfo];
}
#pragma mark - GeTuiSdkDelegate
/** SDK启动成功返回cid */
- (void)GeTuiSdkDidRegisterClient:(NSString *)clientId {
// [4-EXT-1]: 个推SDK已注册，返回clientId
// NSLog(@"
>>[GTSdk RegisterClient]:%@
", clientId);
WRITEUSERDEFAULTS(clientId, ClientId);
}
/** SDK遇到错误回调 */
- (void)GeTuiSdkDidOccurError:(NSError *)error {
// [EXT]:个推错误报告，集成步骤发生的任何错误都在这里通知，如果集成后，无法正常收到消息，查看这里的通知。
//NSLog(@"
>>[GTSdk error]:%@
", [error localizedDescription]);
}
/* SDK收到透传消息回调
SDK 在线状态时（ App 在前台运行），个推服务器会直接给 App 发送透传消息，不发送苹果APNS消息，可以更快的把消息发送到手机端；SDK 离线状态时 （停止 SDK 或 App 后台运行 或 App 停止），个推服务器会给 App 发送苹果 APNs 消息，同时保存个推的离线消息，当 SDK 在线后，SDK 会获取所有的个推透传消息，offLine 字段就是表明该条消息是否为离线消息。
注意：这里是否能收到推送消息也是有在线时间限制的，最长是72小时之前的在线过的用户、
也就是说能收到消息的就是在72小时内在线过的，超过这个时间的是收不到推送消息的，这也就解决好长时间不在线，已在线会收到很多推送消息的困扰
**/
- (void)GeTuiSdkDidReceivePayloadData:(NSData *)payloadData andTaskId:(NSString *)taskId andMsgId:(NSString *)msgId andOffLine:(BOOL)offLine fromGtAppId:(NSString *)appId {
/**
*汇报个推自定义事件
*actionId：用户自定义的actionid，int类型，取值90001-90999。
*taskId： 下发任务的任务ID。
*msgId： 下发任务的消息ID。
*返回值： BOOL，YES表示该命令已经提交，NO表示该命令未提交成功。注：该结果不代表服务器收到该条命令
**/
//[GeTuiSdk sendFeedbackMessage:90001 andTaskId:taskId andMsgId:msgId];
// 数据转换
NSString *payloadMsg = nil;
if (payloadData) {
payloadMsg = [[NSString alloc] initWithBytes:payloadData.bytes length:payloadData.length encoding:NSUTF8StringEncoding];
}
// 解析拿到的数据
if (payloadMsg != nil) {
NSData * data = [payloadMsg dataUsingEncoding:NSUTF8StringEncoding];
NSDictionary * JSONresponseObject = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];
}
UIAlertController * GeTuiAlertController=[[NotificationHandleObject sharedInstance]addBaseViewNotificationAlertViewWithMessage:JSONresponseObject[@"title"] andConfirmTitle:@"确定"];
[self.window.rootViewController presentViewController:GeTuiAlertController animated:YES completion:nil];
}
}
}
/** SDK收到sendMessage消息回调 */
- (void)GeTuiSdkDidSendMessage:(NSString *)messageId result:(int)result{
// 发送上行消息结果反馈
// NSString *msg = [NSString stringWithFormat:@"sendmessage=%@,result=%d", messageId, result];
// NSLog(@"
>>[GTSdk DidSendMessage]:%@
", msg);
}
/** SDK运行状态通知 */
- (void)GeTuiSDkDidNotifySdkState:(SdkStatus)aStatus {
// 通知SDK运行状态
// NSLog(@"
>>[GTSdk SdkState]:%u
", aStatus);
}
/** SDK设置推送模式回调 */
- (void)GeTuiSdkDidSetPushMode:(BOOL)isModeOff error:(NSError *)error {
if (error) {
// NSLog(@"
>>[GTSdk SetModeOff Error]:%@
", [error localizedDescription]);
return;
}
// NSLog(@"
>>[GTSdk SetModeOff]:%@
", isModeOff ? @"开启" : @"关闭");
}
// 别名推送
// 绑定别名是否成功
// 处理 绑定/解绑 delegate返回结果：
- (void)GeTuiSdkDidAliasAction:(NSString *)action result:(BOOL)isSuccess sequenceNum:(NSString *)aSn error:(NSError *)aError {
if ([kGtResponseBindType isEqualToString:action]) {
//NSLog(@"绑定结果 ：%@ !, sn : %@", isSuccess ? @"成功" : @"失败", aSn);
if (!isSuccess) {
//NSLog(@"失败原因: %@", aError);
}
} else if ([kGtResponseUnBindType isEqualToString:action]) {
//NSLog(@"绑定结果 ：%@ !, sn : %@", isSuccess ? @"成功" : @"失败", aSn);
if (!isSuccess) {
//NSLog(@"失败原因: %@", aError);
}
}
}