一. 創(chuàng)建推送證書
1.1. 創(chuàng)建 APP ID
登陸蘋果開發(fā)者中心developer.apple.com, 進(jìn)入后臺:
選擇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è)界面, 選擇你需要創(chuàng)建的證書類型:
Development下的:
Apple Push Notification service SSL (Sandbox) :測試環(huán)境下的推送證書
Production下的:
Apple Push Notification service SSL (Sandbox & Production): 發(fā)布環(huán)境, 推送證書
最好兩種證書都創(chuàng)建一個(gè), 一個(gè)用于測試, 一個(gè)用于發(fā)布;
然后來到:
這里選擇剛剛創(chuàng)建的含有推送服務(wù) 的 App ID
繼續(xù), 下個(gè)頁面,不用設(shè)置, 接下來會來到:
這里需要使用電腦的鑰匙串訪問來請求一個(gè)證書,:
填寫相關(guān)信息:
這里選擇的保存到磁盤, 所以上面的郵箱可以隨便寫, 建議選擇保存到磁盤, 然后選擇個(gè)保存位置, 即可!
然后,回到證書申請頁面, 選擇剛剛使用鑰匙串創(chuàng)建的請求證書, 下一步:
Download這個(gè)新的證書, 雙擊, 安裝到鑰匙串, 然后打開鑰匙串:
上面選擇登錄, 下面選擇我的證書, 然后在右側(cè)就能找到你剛剛安裝的證書, 導(dǎo)出:
選擇保存位置, 設(shè)置文件名稱, 文件格式, 一定要選擇* 個(gè)人信息交換(.p12)*
點(diǎn)擊存儲的時(shí)候, 會彈出設(shè)置密碼的界面, 這里的密碼一定要設(shè)置,而且不能忘記, 安裝彈框提示, 至完成即可!
這樣, 桌面上就要我們設(shè)置好的p12文件, 也就是我們配置好的推送證書.
二. 在極光平臺創(chuàng)建應(yīng)用
要想使用極光的服務(wù), 需要注冊成為極光的開發(fā)者.這里可在其官網(wǎng)進(jìn)行注冊, 然后進(jìn)入控制臺:
在應(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)依賴庫:
添加系統(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债热，請不要添加)
- UserNotifications.framework (Xcode8及以上)
- libresolv.tbd (JPush 2.2.0及以上版本需要, Xcode7以下版本是libresolv.dylib)
3.2 在XCode中開啟Push Notifications
來到Xcode的Capabilities, 打開Push Notifications, 如果是首次打開, 可能會彈出一個(gè)界面, 讓你選擇開發(fā)者賬號, 選擇你創(chuàng)建推送證書那個(gè)賬號即可, 完成后如下圖所示:
3.3 關(guān)于網(wǎng)絡(luò)訪問權(quán)限
不過, 就要全面使用ATS, 所以這個(gè)操作, 以后可能就不行了:
在info.plist 文件添加* NSAppTransportSecurity*, 類型為字典 , 然后添加一個(gè)key: * NSAllowsArbitraryLoads*, 類型bool, 值為: YES,即可;
注意: 對于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注冊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注冊極光推送:
//Required
? //notice: 3.0.0及以后版本注冊可以這樣寫编丘，也可以繼續(xù)用之前的注冊方式
? 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新增的注冊方法刻两，改成可上報(bào)IDFA心剥，如果沒有使用IDFA直接傳nil
? // 如需繼續(xù)使用pushConfig.plist文件聲明appKey等配置內(nèi)容罩驻，請依舊使用[JPUSHService setupWithOption:launchOptions]方式初始化咱士。
? [JPUSHService setupWithOption:launchOptions appKey:appKey
? ? ? ? ? ? ? ? ? ? ? ? channel:channel
? ? ? ? ? ? ? apsForProduction:isProduction
? ? ? ? ? advertisingIdentifier:advertisingId];
上面的方法中的幾個(gè)參數(shù), 官方的解釋是這樣的:
appKey :極光管理后臺創(chuàng)建應(yīng)用后自動生成的AppKey值球订。請確保應(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)識當(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)推送代理方法:
// 注冊APNs成功并上報(bào)DeviceToken
- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
? /// Required - 注冊 DeviceToken
? [JPUSHService registerDeviceToken:deviceToken];
}
// 實(shí)現(xiàn)注冊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ī)上, 測試,控制臺輸出包含以下信息的log, 說明已成功集成:
--------------------------- JPush Log ----------------------------
--------------------JPush SDK Version:3.0.0--build:13----------
--------------------JCore Lib Version:1.0.0------------
-----------------AppKey:e7f56fsafssdd61f72de59a----------------
----------------------------------------------------------------
四. 測試發(fā)送
來到極光的開發(fā)者服務(wù)后臺, 在應(yīng)用管理中找到你的應(yīng)用, 然后點(diǎn)擊進(jìn)入, 選擇推送–>發(fā)送通知。
編輯需要發(fā)送的內(nèi)容枷恕，然后, 選擇推送對象:
這里選擇的是開發(fā)環(huán)境和所有人, 然后立即發(fā)送即可! 這樣, 你安裝了這個(gè)App的設(shè)備就會收到這一條推送信息:
以上便是最基本集成過程, 其他的業(yè)務(wù)需求, 可在此基礎(chǔ)上進(jìn)行相關(guān)邏輯的編寫.
轉(zhuǎn)載自：https://blog.csdn.net/lqq200912408/article/details/54376208
