Xcode8下快速集成極光推送并兼顧iOS10

不同版本極光推送SDK集成各有差異，集成時(shí)一定要注意版本號(hào)，樓主已將博文更新成最新的SDK JPush v3.0.2. 各位童鞋先閱讀下JPush v3.0.2的升級(jí)指南吧熙宇！
極光的最近更新
 極光資源下載

JPush SDK v3.0.2 升級(jí)指南

更新時(shí)間
2017-02-13
更新信息
修復(fù)：DNS解析失敗帶來(lái)的崩潰問(wèn)題围段，提升穩(wěn)定性
升級(jí)提示
建議升級(jí)！
注意：支持 Xcode 8.0 以上版本開(kāi)啟 bitcode台腥。
升級(jí)指南
1.注意 3.0.0及以上版本將不再支持處理器為i386的模擬器宏赘。
2.添加libresolv.tbd庫(kù)（2.2.0及以上版本要求）
3.Xcode7 升級(jí)到 Xcode8，替換原先導(dǎo)入的 .dylib 框架為 .tbd （特別留意）

本博文修改歷史

2017.03.25 ------------ JPush v3.0.2
2016.12.13 ------------ JPush v2.2.0
2016.09.28 ----------- JPush v2.1.9

簡(jiǎn)介

iOS10下黎侈，遠(yuǎn)程推送發(fā)生了變化察署，新增的UserNotifications.framework將本地推送和遠(yuǎn)程推送整合在一起。最近剛剛更新了Xcode8蜓竹，自動(dòng)創(chuàng)建證書(shū)和配置文件確實(shí)方便許多箕母。琰君分享下以開(kāi)發(fā)環(huán)境為例（非生產(chǎn)環(huán)境）在Xcode8下，快速集成極光推送并兼顧iOS10俱济。

注意：極光的遠(yuǎn)程推送是免費(fèi)的嘶是，并同時(shí)兼顧iOS，Android蛛碌，Windows Phone三個(gè)平臺(tái)聂喇，但相應(yīng)的用戶統(tǒng)計(jì)，終端統(tǒng)計(jì)等功能是不免費(fèi)的蔚携。如果你需要用戶統(tǒng)計(jì)希太，終端統(tǒng)計(jì)這些功能意味著需要付費(fèi)才能使用。

參考鏈接

開(kāi)發(fā)證書(shū)配置
 APNs 推送原理及問(wèn)題
 iOS 推送全解析酝蜒，你不可不知的所有 Tips誊辉！

接下來(lái)假設(shè)你都了解證書(shū)相關(guān)的，推送的一些概念和極光推送的知識(shí)亡脑。那么相信你應(yīng)該知道需要一臺(tái)iOS設(shè)備和一個(gè)蘋(píng)果開(kāi)發(fā)者帳號(hào)才能去體驗(yàn)遠(yuǎn)程推送堕澄。如果你清楚遠(yuǎn)程推送的原理邀跃，那可以直接從以下第2步開(kāi)始。

集成步驟

遠(yuǎn)程推送原理
Xcode8創(chuàng)建項(xiàng)目蛙紫，配置自動(dòng)創(chuàng)建App ID/證書(shū)/配置文件
創(chuàng)建APNs 推送證書(shū)
在極光推送后臺(tái)創(chuàng)建應(yīng)用拍屑，并上傳APNs 推送證書(shū)
項(xiàng)目中集成極光推送SDK
notification payload 和遠(yuǎn)程推送類(lèi)型
獲取 APNs推送內(nèi)容
極光推送后臺(tái)發(fā)送遠(yuǎn)程推送測(cè)試

1. 遠(yuǎn)程推送原理

當(dāng)iOS設(shè)備連網(wǎng)的情況下，iOS設(shè)備和蘋(píng)果服務(wù)器建立了一個(gè)長(zhǎng)鏈接坑傅，即便應(yīng)用處于掛起和后臺(tái)的狀態(tài)僵驰，蘋(píng)果可以給iOS設(shè)備中的應(yīng)用發(fā)送通知。

遠(yuǎn)程推送原理

概念

iOS：iOS設(shè)備

APNs Server：蘋(píng)果服務(wù)器
Your App: 自己的應(yīng)用
Your Server：自己的服務(wù)器

推送流程

iOS 應(yīng)用注冊(cè)推送通知唁毒，iOS設(shè)備將設(shè)備的UDID和應(yīng)用的Bundle ID發(fā)送到蘋(píng)果服務(wù)器蒜茴。
蘋(píng)果服務(wù)器將接收到的UDID和Bundle ID加密生成一個(gè)deviceToken，并返回給對(duì)應(yīng)iOS應(yīng)用枉证。
iOS應(yīng)用將接收到的deviceToken發(fā)送到自己的服務(wù)器矮男，服務(wù)器并保存。
自己的服務(wù)器需配置APNs 推送證書(shū)室谚，當(dāng)需要推送時(shí)毡鉴，去后臺(tái)查詢推送目標(biāo)設(shè)備的deviceToken，將notification payload和deviceToken一起發(fā)送給蘋(píng)果服務(wù)器秒赤。notification payload是一個(gè)JSON字典猪瞬，包含著發(fā)給應(yīng)用程序的數(shù)據(jù)，并且包含通知的類(lèi)型（類(lèi)型決定系統(tǒng)如何通知用戶）入篮。
蘋(píng)果服務(wù)器通過(guò)deviceToken找到對(duì)應(yīng)設(shè)備下的對(duì)應(yīng)應(yīng)用陈瘦，推送消息。

說(shuō)明

真機(jī)測(cè)試并且包含推送功能需要?jiǎng)?chuàng)建對(duì)應(yīng)App ID／證書(shū)／配置文件潮售，這步可以用Xcode8 自動(dòng)創(chuàng)建痊项，而不需要到蘋(píng)果開(kāi)發(fā)者平臺(tái)去創(chuàng)建。如果不是Xcode8酥诽，則需要去開(kāi)發(fā)者平臺(tái)申請(qǐng)鞍泉，確保App ID包含推送通知服務(wù)，并且在Xcode中配置肮帐，保證真機(jī)測(cè)試即可咖驮。

我們自己的服務(wù)器需要配置 APNs 推送證書(shū)，同樣的分為開(kāi)發(fā)證書(shū)和生產(chǎn)證書(shū)训枢。需要到蘋(píng)果開(kāi)發(fā)者平臺(tái)去申請(qǐng)托修。

如果不借助第三方推送平臺(tái)，我們需要完成推送流程中的1恒界，3睦刃，4步。借助極光推送十酣，那么我們只需要完成推送流程中的1眯勾，3步枣宫，但同樣需要我們完成第4步中的申請(qǐng)APNs 推送證書(shū)，并且上傳到極光推送平臺(tái)吃环。

2. Xcode8配置自動(dòng)創(chuàng)建App ID/證書(shū)/配置文件

在Xcode8下，確保已經(jīng)登錄付費(fèi)蘋(píng)果開(kāi)發(fā)者帳號(hào)洋幻。請(qǐng)開(kāi)啟Application Target的Capabilities->Push Notifications選項(xiàng)郁轻。

開(kāi)啟遠(yuǎn)程推送

2.勾選自動(dòng)管理App ID／證書(shū)／配置文件

勾選自動(dòng)管理

3.檢查Xcode自動(dòng)創(chuàng)建的App ID／證書(shū)／配置文件，保證下圖中第4步App ID包含的遠(yuǎn)程推送服務(wù)文留。如果沒(méi)問(wèn)題就可以真機(jī)運(yùn)行了好唯。

檢查Xcode生產(chǎn)的App ID／證書(shū)／配置文件

3. 創(chuàng)建APNs 推送證書(shū)

登錄開(kāi)發(fā)者網(wǎng)站，并點(diǎn)擊按鈕創(chuàng)建證書(shū)

點(diǎn)擊按鈕創(chuàng)建證書(shū)

2.選擇開(kāi)發(fā)環(huán)境APNs 推送證書(shū)點(diǎn)擊右下角按鈕創(chuàng)建

創(chuàng)建開(kāi)發(fā)環(huán)境APNs 推送證書(shū)

3.選擇工程的App ID

選擇工程的App ID

4.上傳證書(shū)請(qǐng)求文件燥翅，不知道的童鞋可參照開(kāi)發(fā)證書(shū)配置

上傳證書(shū)請(qǐng)求文件

5.點(diǎn)擊下載證書(shū)骑篙，并雙擊安裝到鑰匙串.

安裝APNs 推送證書(shū)

6.打開(kāi)鑰匙串，找到對(duì)應(yīng)的APNs 推送證書(shū)森书，并選擇右鍵導(dǎo)出包含私鑰的證書(shū)靶端。（確保證書(shū)左側(cè)為向右的小箭頭，導(dǎo)出的證書(shū)才會(huì)包含私鑰.）

鑰匙串導(dǎo)出證書(shū)

7.設(shè)置證書(shū)名字凛膏，并選擇證書(shū)存放位置杨名。

設(shè)置證書(shū)名字

8.設(shè)置證書(shū)密碼，可不填猖毫。極光推送支持證書(shū)設(shè)置密碼台谍，但像leanCloud推送不支持證書(shū)設(shè)置密碼，各位童鞋可按照實(shí)際情況來(lái)吁断。最后輸入電腦開(kāi)密碼趁蕊，導(dǎo)出證書(shū)。

設(shè)置證書(shū)密碼

輸入電腦開(kāi)機(jī)密碼導(dǎo)出證書(shū)

4. 在極光推送后臺(tái)創(chuàng)建應(yīng)用仔役，并上傳APNs 推送證書(shū)

1.登錄極光推送平臺(tái)掷伙，切換到控制臺(tái)，并創(chuàng)建應(yīng)用骂因。接下來(lái)在應(yīng)用信息中上傳開(kāi)發(fā)推送證書(shū)炎咖。生產(chǎn)推送證書(shū)配置類(lèi)似，不做贅述寒波。

上傳開(kāi)發(fā)APNs 推送證書(shū)

核對(duì)應(yīng)用的Bundle ID 等信息是否正確.

核對(duì)Bundle ID 等信息

5. 項(xiàng)目中集成極光推送SDK

極光推送最新版本3.0.2已支持CocoaPods導(dǎo)入乘盼。

方式一：CocoaPods導(dǎo)入，一句話搞定俄烁。

pod 'JPush', '3.0.2'

方式二：手動(dòng)導(dǎo)入SDK和系統(tǒng)依賴(lài)庫(kù)
```
jpush-ios-3.0.2.a
jcore-ios-1.1.1.a
JPUSHService.h
```

導(dǎo)入系統(tǒng)依賴(lài)庫(kù)

CFNetwork.framework
CoreFoundation.framework
CoreTelephony.framework
SystemConfiguration.framework
CoreGraphics.framework
Foundation.framework
UIKit.framework
Security.framework
libz.tbd
Adsupport.framework (獲取IDFA需要绸栅；如果不使用IDFA，請(qǐng)不要添加)
UserNotifications.framework(Xcode8及以上)
libresolv.tbd (JPush 2.2.0及以上版本需要)

3. AppDelegate.m 配置
導(dǎo)入以下頭文件

import "JPUSHService.h"

// 如果需要使用idfa功能所需要引入的頭文件（可選）

import <AdSupport/AdSupport.h>

ifdef NSFoundationVersionNumber_iOS_9_x_Max

import <UserNotifications/UserNotifications.h>

endif

并且遵守`<JPUSHRegisterDelegate>`協(xié)議

@interface AppDelegate ()<JPUSHRegisterDelegate>
@end

注冊(cè)遠(yuǎn)程推送页屠，初始化極光推送SDK粹胯。

-(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{

//-------------注冊(cè)遠(yuǎn)程推送
//notice: 3.0.0及以后版本注冊(cè)可以這樣寫(xiě)蓖柔，也可以繼續(xù)用之前的注冊(cè)方式
JPUSHRegisterEntity * entity = [[JPUSHRegisterEntity alloc] init];
entity.types = JPAuthorizationOptionAlert|JPAuthorizationOptionBadge|JPAuthorizationOptionSound;
[JPUSHService registerForRemoteNotificationConfig:entity delegate:self];
//-------------極光推送SDK初始化
BOOL isProduction = NO;// NO為開(kāi)發(fā)環(huán)境，YES為生產(chǎn)環(huán)境
//廣告標(biāo)識(shí)符如果沒(méi)有使用IDFA直接傳nil
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
[JPUSHService setupWithOption:launchOptions appKey:@"極光推送AppKey"
channel:nil
apsForProduction:isProduction
advertisingIdentifier:advertisingId];
return YES;
}

以上是注冊(cè)遠(yuǎn)程推送極光版本风纠，很簡(jiǎn)潔况鸣。下面是注冊(cè)遠(yuǎn)程推送系統(tǒng)版本，可以參考下竹观。

-(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

CGFloat version = [[[UIDevice currentDevice] systemVersion] floatValue];  
  
if (version >= 10.0)  
{  
    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];  
    [center requestAuthorizationWithOptions:UNAuthorizationOptionCarPlay | UNAuthorizationOptionSound | UNAuthorizationOptionBadge | UNAuthorizationOptionAlert completionHandler:^(BOOL granted, NSError * _Nullable error) {  
          
        if (granted) {  
            NSLog(@" iOS 10 request notification success");  
        }else{  
            NSLog(@" iOS 10 request notification fail");  
        }  
    }];  
}  
else if (version >= 8.0)  
{  
    UIUserNotificationSettings *setting = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeSound | UIUserNotificationTypeBadge | UIUserNotificationTypeAlert categories:nil];  
    [application registerUserNotificationSettings:setting];  
}else  
{     //iOS <= 7.0
    UIRemoteNotificationType type = UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound;  
    [application registerForRemoteNotificationTypes:type];  
}    

//注冊(cè)通知  
[[UIApplication sharedApplication] registerForRemoteNotifications];  
  
return YES;

}

將蘋(píng)果服務(wù)器返回的`deviceToken`,上傳到極光推送服務(wù)器镐捧。

-(void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{
[JPUSHService registerDeviceToken:deviceToken];
}

注冊(cè)遠(yuǎn)程通知失敗，比如沒(méi)有聯(lián)網(wǎng)的狀態(tài)下臭增。

-(void)application:(UIApplication *)application
didFailToRegisterForRemoteNotificationsWithError:(NSError *)error{
NSLog(@"did Fail To Register For Remote Notifications With Error: %@", error);
}


#####6.notification payload 和遠(yuǎn)程推送類(lèi)型
發(fā)送遠(yuǎn)程推送的服務(wù)器發(fā)送給APNs的每個(gè)通知都包含payload懂酱。 payload是一個(gè)JSON字典，包含要發(fā)送到應(yīng)用程序的任何自定義數(shù)據(jù)誊抛，并包含有關(guān)推送類(lèi)型的信息（推送類(lèi)型決定系統(tǒng)如何通知用戶）列牺。

遠(yuǎn)程推送分為普通推送，后臺(tái)推送拗窃，靜默推送三種方式瞎领。以下以遠(yuǎn)程推送的類(lèi)型來(lái)討論下payload的構(gòu)造。以下只考慮iOS7之后的操作系統(tǒng)并炮。

- 普通推送 
  - payload 構(gòu)造：包含聲音默刚、內(nèi)容、角標(biāo)逃魄、自定義字段荤西。

{
aps = {
alert = "顯示內(nèi)容";//alert對(duì)應(yīng)的值也可以是字典，字典中body鍵的值對(duì)應(yīng)顯示內(nèi)容
badge = 1; // App 角標(biāo)伍俘，可推送 n邪锌、+n、-n 來(lái)實(shí)現(xiàn)角標(biāo)的固定癌瘾、增加觅丰、減少
sound = default; // 推送聲音，默認(rèn)系統(tǒng)三全音妨退，如需使用自己的聲音妇萄，需要將聲音文件拖拽&拷貝至 Xcode 工程目錄任意位置，并在推送時(shí)指定其文件名
};
proNo = "tb_pro_no_id249349874"; // 自定義字段
DesVc = "ProViewController";
}


 - 處于未啟動(dòng)咬荷，系統(tǒng)會(huì)顯示通知冠句，點(diǎn)擊通知橫幅啟動(dòng)，在以下方法中獲取通知內(nèi)容:

-(BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

 - 處于后臺(tái)幸乒，系統(tǒng)會(huì)顯示通知懦底，但不會(huì)通知對(duì)應(yīng)應(yīng)用（即應(yīng)用的方法不會(huì)被調(diào)用）。
 - 處于前臺(tái)罕扎，iOS10之后會(huì)顯示通知聚唐。（iOS10之前會(huì)不會(huì)展示通知丐重，樓主也記不住了??）在以下方法中獲取通知內(nèi)容:
   - iOS7 ~ iOS9