極光推送：推送證書申請(qǐng)配置及iOS客戶端的實(shí)現(xiàn)

一. 創(chuàng)建推送證書

1.1. 創(chuàng)建 APP ID

登陸蘋果開發(fā)者中心developer.apple.com, 進(jìn)入后臺(tái):

選擇Certificates, Identifiers&Profiles, 然后選擇Identifiers下的App IDs , 右側(cè)右上角 “+“, 新建一個(gè)APP ID:

下一步, 這里給你的ID 設(shè)置一個(gè)名字, 便于記憶就好:

注意: 這里的APP ID Suffix, 一定要選擇 Explicit App ID(精確型), 不要選擇下面的通配型(Wildcard App ID), 一般直接使用項(xiàng)目的 Bundle Identifier即可;

下面的App Services, 勾選Push Notifications:


然后, 根據(jù)頁面提示繼續(xù), 完成即可;

PS: 如果是已有的APP ID 可點(diǎn)擊下面的Edit, 來勾選 Push Notifications

1.2 創(chuàng)建推送證書

然后選擇Certificates下的 all, 點(diǎn)擊右側(cè)右上角 “+“, 新建一個(gè)證書:

然后來到下面這個(gè)界面, 選擇你需要?jiǎng)?chuàng)建的證書類型:


Development下的:

Apple Push Notification service SSL (Sandbox) :測(cè)試環(huán)境下的推送證書

Production下的:

Apple Push Notification service SSL (Sandbox & Production): 發(fā)布環(huán)境, 推送證書

最好兩種證書都創(chuàng)建一個(gè), 一個(gè)用于測(cè)試, 一個(gè)用于發(fā)布;

然后來到:


這里選擇剛剛創(chuàng)建的含有推送服務(wù) 的 App ID

繼續(xù), 下個(gè)頁面,不用設(shè)置, 接下來會(huì)來到:


這里需要使用電腦的鑰匙串訪問來請(qǐng)求一個(gè)證書,:


填寫相關(guān)信息:


這里選擇的保存到磁盤, 所以上面的郵箱可以隨便寫, 建議選擇保存到磁盤, 然后選擇個(gè)保存位置, 即可!

然后,回到證書申請(qǐng)頁面, 選擇剛剛使用鑰匙串創(chuàng)建的請(qǐng)求證書, 下一步:

Download這個(gè)新的證書, 雙擊, 安裝到鑰匙串, 然后打開鑰匙串:


上面選擇登錄, 下面選擇我的證書, 然后在右側(cè)就能找到你剛剛安裝的證書, 導(dǎo)出:


選擇保存位置, 設(shè)置文件名稱, 文件格式, 一定要選擇* 個(gè)人信息交換(.p12)*


點(diǎn)擊存儲(chǔ)的時(shí)候, 會(huì)彈出設(shè)置密碼的界面, 這里的密碼一定要設(shè)置,而且不能忘記, 安裝彈框提示, 至完成即可!

這樣, 桌面上就要我們?cè)O(shè)置好的p12文件, 也就是我們配置好的推送證書.

二. 在極光平臺(tái)創(chuàng)建應(yīng)用

要想使用極光的服務(wù), 需要注冊(cè)成為極光的開發(fā)者.這里可在其官網(wǎng)進(jìn)行注冊(cè), 然后進(jìn)入控制臺(tái):

在應(yīng)用管理中創(chuàng)建一個(gè)應(yīng)用.

設(shè)置應(yīng)用名稱, 選擇應(yīng)用圖標(biāo):


?直接來到iOS


需要注意的是: 這里的證書密碼必須要設(shè)置, 我之前導(dǎo)出時(shí)沒有設(shè)置密碼, 這里直接什么都沒填, 但是認(rèn)證一直不能通過, 所以要設(shè)置密碼;

然后, 創(chuàng)建我的應(yīng)用, 即可;我們就獲取到了AppKey;

在最后彈出的頁面中, 我們可以查看證書是否可用:


可以看到, 我這里的開發(fā)環(huán)境的證書狀態(tài)是已驗(yàn)證, 就是可用的, 成產(chǎn)環(huán)境的證書我沒有上傳, 所以此處的狀態(tài)是未上傳, 點(diǎn)擊左側(cè)的?, 可以查看各個(gè)狀態(tài)的含義:


三. 配置Xcode

3.1 集成SDK

首先在官網(wǎng)下載SDK, 將解壓后的文件夾中的Lib 文件夾拖入到你的項(xiàng)目中:

有下面這三個(gè)文件:


然后, 添加系統(tǒng)依賴庫(kù):


添加系統(tǒng) Framework

- CFNetwork.framework

- CoreFoundation.framework

- CoreTelephony.framework

- SystemConfiguration.framework

- CoreGraphics.framework

- Foundation.framework

- UIKit.framework

- Security.framework

- libz.tbd (Xcode7以下版本是libz.dylib)

- AdSupport.framework (獲取IDFA需要；如果不使用IDFA，請(qǐng)不要添加)

- UserNotifications.framework (Xcode8及以上)

- libresolv.tbd (JPush 2.2.0及以上版本需要, Xcode7以下版本是libresolv.dylib)

3.2 在XCode中開啟Push Notifications


來到Xcode的Capabilities, 打開Push Notifications, 如果是首次打開, 可能會(huì)彈出一個(gè)界面, 讓你選擇開發(fā)者賬號(hào), 選擇你創(chuàng)建推送證書那個(gè)賬號(hào)即可, 完成后如下圖所示:

3.3 關(guān)于網(wǎng)絡(luò)訪問權(quán)限

不過, 就要全面使用ATS, 所以這個(gè)操作, 以后可能就不行了:

在info.plist 文件添加* NSAppTransportSecurity*, 類型為字典 , 然后添加一個(gè)key: * NSAllowsArbitraryLoads*, 類型bool, 值為: YES,即可;

注意: 對(duì)于JPush 2.1.9 及以上的版本是支持ATS訪問的, 所以在使用大于2.1.9版本的JPushSDK的時(shí)候, 不需要進(jìn)行這個(gè)設(shè)置了, 這里使用的是3.0版本, 所以不需配置這一項(xiàng).

3.4 使用API

以下只是極光推送文檔中的實(shí)例代碼!!!

在項(xiàng)目AppDelegate, 添加以下代碼:

// 引入JPush功能所需頭文件

#import "JPUSHService.h"

// iOS10注冊(cè)APNs所需頭文件

#ifdef NSFoundationVersionNumber_iOS_9_x_Max

#import <UserNotifications/UserNotifications.h>

#endif

并實(shí)現(xiàn)代理:

@interface AppDelegate ()<JPUSHRegisterDelegate>

@end

在-(BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions注冊(cè)極光推送:

//Required

? //notice: 3.0.0及以后版本注冊(cè)可以這樣寫，也可以繼續(xù)用之前的注冊(cè)方式

? JPUSHRegisterEntity * entity = [[JPUSHRegisterEntity alloc] init];

? entity.types = JPAuthorizationOptionAlert|JPAuthorizationOptionBadge|JPAuthorizationOptionSound;

? if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) {

? ? // 可以添加自定義categories

? ? // NSSet<UNNotificationCategory *> *categories for iOS10 or later

? ? // NSSet<UIUserNotificationCategory *> *categories for iOS8 and iOS9

? }

? [JPUSHService registerForRemoteNotificationConfig:entity delegate:self];

// Required

? // init Push

? // notice: 2.1.5版本的SDK新增的注冊(cè)方法，改成可上報(bào)IDFA，如果沒有使用IDFA直接傳nil

? // 如需繼續(xù)使用pushConfig.plist文件聲明appKey等配置內(nèi)容，請(qǐng)依舊使用[JPUSHService setupWithOption:launchOptions]方式初始化。

? [JPUSHService setupWithOption:launchOptions appKey:appKey

? ? ? ? ? ? ? ? ? ? ? ? channel:channel

? ? ? ? ? ? ? apsForProduction:isProduction

? ? ? ? ? advertisingIdentifier:advertisingId];

上面的方法中的幾個(gè)參數(shù), 官方的解釋是這樣的:

appKey :極光管理后臺(tái)創(chuàng)建應(yīng)用后自動(dòng)生成的AppKey值。請(qǐng)確保應(yīng)用內(nèi)配置的 AppKey 與 Portal 上創(chuàng)建應(yīng)用后生成的 AppKey 一致。

channel : 指明應(yīng)用程序包的下載渠道，為方便分渠道統(tǒng)計(jì)，具體值由你自行定義，如：App Store。

apsForProduction : 1.3.1版本新增，用于標(biāo)識(shí)當(dāng)前應(yīng)用所使用的APNs證書環(huán)境。0 (默認(rèn)值)表示采用的是開發(fā)證書，1 表示采用生產(chǎn)證書發(fā)布應(yīng)用。

注：此字段的值要與Build Settings的Code Signing配置的證書環(huán)境一致。

advertisingIdentifier : IDFA 廣告標(biāo)示符

實(shí)現(xiàn)系統(tǒng)推送代理方法:

// 注冊(cè)APNs成功并上報(bào)DeviceToken

- (void)application:(UIApplication *)application

didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

? /// Required - 注冊(cè) DeviceToken

? [JPUSHService registerDeviceToken:deviceToken];

}

// 實(shí)現(xiàn)注冊(cè)APNs失敗接口（可選）

- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {

? //Optional

? NSLog(@"did Fail To Register For Remote Notifications With Error: %@", error);

}

實(shí)現(xiàn)* JPUSHRegisterDelegate* 相關(guān)代理方法, 處理通知回調(diào)方法

#pragma mark- JPUSHRegisterDelegate

// iOS 10 Support

- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler {

? // Required

? NSDictionary * userInfo = notification.request.content.userInfo;

? if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {

? ? [JPUSHService handleRemoteNotification:userInfo];

? }

? completionHandler(UNNotificationPresentationOptionAlert); // 需要執(zhí)行這個(gè)方法，選擇是否提醒用戶，有Badge、Sound、Alert三種類型可以選擇設(shè)置

}

// iOS 10 Support

- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {

? // Required

? NSDictionary * userInfo = response.notification.request.content.userInfo;

? if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {

? ? [JPUSHService handleRemoteNotification:userInfo];

? }

? completionHandler();? // 系統(tǒng)要求執(zhí)行這個(gè)方法

}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

? // Required, iOS 7 Support

? [JPUSHService handleRemoteNotification:userInfo];

? completionHandler(UIBackgroundFetchResultNewData);

}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {

? // Required,For systems with less than or equal to iOS6

? [JPUSHService handleRemoteNotification:userInfo];

}

然后, 在真機(jī)上, 測(cè)試,控制臺(tái)輸出包含以下信息的log, 說明已成功集成:

--------------------------- JPush Log ----------------------------

--------------------JPush SDK Version:3.0.0--build:13----------

--------------------JCore Lib Version:1.0.0------------

-----------------AppKey:e7f56fsafssdd61f72de59a----------------

----------------------------------------------------------------

四. 測(cè)試發(fā)送

來到極光的開發(fā)者服務(wù)后臺(tái), 在應(yīng)用管理中找到你的應(yīng)用, 然后點(diǎn)擊進(jìn)入, 選擇推送–>發(fā)送通知。

編輯需要發(fā)送的內(nèi)容，然后, 選擇推送對(duì)象:

這里選擇的是開發(fā)環(huán)境和所有人, 然后立即發(fā)送即可! 這樣, 你安裝了這個(gè)App的設(shè)備就會(huì)收到這一條推送信息:

以上便是最基本集成過程, 其他的業(yè)務(wù)需求, 可在此基礎(chǔ)上進(jìn)行相關(guān)邏輯的編寫.



轉(zhuǎn)載自：https://blog.csdn.net/lqq200912408/article/details/54376208

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容