[iOS]極光推送JPushSDK開(kāi)發(fā)--準(zhǔn)備篇

關(guān)于iOS中的推送, 我們使用最多的可能就是極光了, 關(guān)于極光推送, 這里不做過(guò)多的介紹, 可到其官網(wǎng)進(jìn)行學(xué)習(xí), 這里主要是介紹集成的大致過(guò)程.

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

1.1. 創(chuàng)建 APP ID

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

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

新建 APP ID

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

設(shè)置APP ID 信息

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

下面的App Services, 勾選Push Notifications:

選擇服務(wù)

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

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

編輯 App ID

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

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

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


選擇證書(shū)類型

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

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

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

然后來(lái)到:

選擇 APP ID

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

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

選擇CSR請(qǐng)求文件

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

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


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

然后,回到證書(shū)申請(qǐng)頁(yè)面, 選擇剛剛使用鑰匙串創(chuàng)建的請(qǐng)求證書(shū), 下一步:
Download這個(gè)新的證書(shū), 雙擊, 安裝到鑰匙串, 然后打開(kāi)鑰匙串:


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

導(dǎo)出證書(shū)

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

點(diǎn)擊存儲(chǔ)的時(shí)候, 會(huì)彈出設(shè)置密碼的界面, 這里的密碼一定要設(shè)置,而且不能忘記, 安裝彈框提示, 至完成即可!
這樣, 桌面上就要我們?cè)O(shè)置好的p12文件, 也就是我們配置好的推送證書(shū).

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

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

極光控制臺(tái)

應(yīng)用管理中創(chuàng)建一個(gè)應(yīng)用:
設(shè)置應(yīng)用名稱, 選擇應(yīng)用圖標(biāo):


下面的Android不用管, 直接來(lái)到iOS

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

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

在最后彈出的頁(yè)面中, 我們可以查看證書(shū)是否可用:

應(yīng)該狀態(tài)

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

證書(shū)狀態(tài)

三. 配置Xcode

3.1 集成SDK

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

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

添加系統(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 開(kāi)啟Push Notifications

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

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

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

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

注意: 對(duì)于JPush 2.1.9 及以上的版本是支持ATS訪問(wèn)的, 所以在使用大于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荔燎,如果沒(méi)有使用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證書(shū)環(huán)境繁莹。0 (默認(rèn)值)表示采用的是開(kāi)發(fā)證書(shū),1 表示采用生產(chǎn)證書(shū)發(fā)布應(yīng)用特幔。
    注:此字段的值要與Build Settings的Code Signing配置的證書(shū)環(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, 說(shuō)明已成功集成:

--------------------------- JPush Log ----------------------------
--------------------JPush SDK Version:3.0.0--build:13----------
--------------------JCore Lib Version:1.0.0------------
-----------------AppKey:e7f56fsafssdd61f72de59a----------------
----------------------------------------------------------------

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

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

編輯推送內(nèi)容

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

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

以上便是最基本集成過(guò)程, 其他的業(yè)務(wù)需求, 可在此基礎(chǔ)上進(jìn)行相關(guān)邏輯的編寫.
此篇文章對(duì)應(yīng)的demo為:https://github.com/LQQZYY/LZJPush, 可以作為參考.

(完)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末拍嵌,一起剝皮案震驚了整個(gè)濱河市遭赂,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌横辆,老刑警劉巖撇他,帶你破解...
    沈念sama閱讀 207,113評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡困肩,警方通過(guò)查閱死者的電腦和手機(jī)募疮,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,644評(píng)論 2 381
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)僻弹,“玉大人阿浓,你說(shuō)我怎么就攤上這事√U溃” “怎么了芭毙?”我有些...
    開(kāi)封第一講書(shū)人閱讀 153,340評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)卸耘。 經(jīng)常有香客問(wèn)我退敦,道長(zhǎng),這世上最難降的妖魔是什么蚣抗? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,449評(píng)論 1 279
  • 正文 為了忘掉前任侈百,我火速辦了婚禮,結(jié)果婚禮上翰铡,老公的妹妹穿的比我還像新娘钝域。我一直安慰自己,他們只是感情好锭魔,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,445評(píng)論 5 374
  • 文/花漫 我一把揭開(kāi)白布例证。 她就那樣靜靜地躺著,像睡著了一般迷捧。 火紅的嫁衣襯著肌膚如雪织咧。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 49,166評(píng)論 1 284
  • 那天漠秋,我揣著相機(jī)與錄音笙蒙,去河邊找鬼。 笑死庆锦,一個(gè)胖子當(dāng)著我的面吹牛捅位,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播肥荔,決...
    沈念sama閱讀 38,442評(píng)論 3 401
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼绿渣,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了燕耿?” 一聲冷哼從身側(cè)響起中符,我...
    開(kāi)封第一講書(shū)人閱讀 37,105評(píng)論 0 261
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎誉帅,沒(méi)想到半個(gè)月后淀散,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體右莱,經(jīng)...
    沈念sama閱讀 43,601評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,066評(píng)論 2 325
  • 正文 我和宋清朗相戀三年档插,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了慢蜓。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,161評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡郭膛,死狀恐怖晨抡,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情则剃,我是刑警寧澤耘柱,帶...
    沈念sama閱讀 33,792評(píng)論 4 323
  • 正文 年R本政府宣布,位于F島的核電站棍现,受9級(jí)特大地震影響调煎,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜己肮,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,351評(píng)論 3 307
  • 文/蒙蒙 一士袄、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧谎僻,春花似錦娄柳、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,352評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)讶舰。三九已至鞍盗,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間跳昼,已是汗流浹背般甲。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,584評(píng)論 1 261
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留鹅颊,地道東北人敷存。 一個(gè)月前我還...
    沈念sama閱讀 45,618評(píng)論 2 355
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像堪伍,于是被迫代替她去往敵國(guó)和親锚烦。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,916評(píng)論 2 344

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理帝雇,服務(wù)發(fā)現(xiàn)涮俄,斷路器,智...
    卡卡羅2017閱讀 134,601評(píng)論 18 139
  • 不同版本極光推送SDK集成各有差異尸闸,集成時(shí)一定要注意版本號(hào)彻亲,樓主已將博文更新成最新的SDK JPush v3.0....
    i順頌時(shí)宜閱讀 7,843評(píng)論 37 170
  • 極光推送和百度比起來(lái)較為簡(jiǎn)單,但是很有新手對(duì)于集成極光推送時(shí)配置證書(shū)比較暈頭轉(zhuǎn)向,也沒(méi)有太小白的教程,所以寫了這個(gè)...
    Roct閱讀 1,128評(píng)論 1 17
  • 版本記錄 前言 ??現(xiàn)在很多APP都有推送功能孕锄,其中極光推送就是很多APP的首選。我們最近的幾個(gè)APP也是用的極光...
    刀客傳奇閱讀 8,364評(píng)論 0 8
  • ** Tips:** 不同版本極光推送SDK集成各有差異苞尝,各位童鞋在集成時(shí)一定要注意版本號(hào)畸肆,本人集成的是基于 極光...
    anyurchao閱讀 2,406評(píng)論 3 26