个推你应该这样用的

前言：

    说到这个远程推送，大家知道的应该都挺多的，但用到的估计极光和个推要占一很大部分，这篇博客重点说的就是个推的使用，个推官网的链接在这里，它的集成是比较方便的，你可以直接使用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);
        }
    }
}