iOS 平臺(tái)上推送通知,只有 APNs 這個(gè)官方的通道喧笔,是可以隨時(shí)送達(dá)的。一般開(kāi)發(fā)者都是自己部署應(yīng)用服務(wù)器向 APNs Server 推送。
JPush iOS 推送相比直接向 APNs 推送有什么好處呢祖驱?
1. 減少開(kāi)發(fā)及維護(hù)成本:
應(yīng)用開(kāi)發(fā)者不需要去開(kāi)發(fā)維護(hù)自己的推送服務(wù)器與 APNs 對(duì)接。
集成了 JPush iOS SDK 后不必自己維護(hù)更新 device token瞒窒。
通過(guò) JPush 的 Web Portal 直接推送捺僻,也可以調(diào)用JPush的 HTTP 協(xié)議 API 來(lái)完成,開(kāi)發(fā)工作量大大減少根竿。
2. 減少運(yùn)營(yíng)成本:
極光推送支持一次推送陵像,同時(shí)向 Android, iOS, WinPhone 三個(gè)平臺(tái)就珠。支持統(tǒng)一的 API 與推送界面。
極光推送提供標(biāo)簽醒颖、別名綁定機(jī)制妻怎,以及提供了非常細(xì)分的用戶(hù)分群方式,運(yùn)營(yíng)起來(lái)非常簡(jiǎn)單泞歉、直觀逼侦。
3. 提供應(yīng)用內(nèi)推送:
除了使得 APNs 推送更簡(jiǎn)單,也另外提供應(yīng)用內(nèi)消息推送腰耙。這在類(lèi)似于聊天的場(chǎng)景里很有必要榛丢。
第一步:在極光官網(wǎng)注冊(cè)極光推送
第二步:下載SDK
資源文件
包名為JPush-iOS-SDK-{版本號(hào)}
lib文件夾:包含頭文件 JPUSHService.h,靜態(tài)庫(kù)文件jpush-ios-x.x.x.a 挺庞,支持的iOS版本為 6.0 及以上版本晰赞。(請(qǐng)注意:模擬器不支持APNs)
pdf文件:集成指南
demo文件夾:示例
第三步:創(chuàng)建應(yīng)用-在 JPush的管理Portal 上創(chuàng)建應(yīng)用并上傳推送(APNs)證書(shū)
Paste_Image.png
Paste_Image.png
創(chuàng)建成功后自動(dòng)生成 AppKey 用以標(biāo)識(shí)該應(yīng)用
Paste_Image.png
第四步:配置工程
1. 導(dǎo)入SDK
將SDK包解壓,在Xcode中選擇“Add files to 'Your project name'...”选侨,將解壓后的lib子文件夾(包含JPUSHService.h掖鱼、jpush-ios-x.x.x.a)添加到你的工程目錄中
Paste_Image.png
2. 在Build Phases中添加Framework
CFNetwork.framework
CoreFoundation.framework
CoreTelephony.framework
SystemConfiguration.framework
CoreGraphics.framework
Foundation.framework
UIKit.framework
Security.framework
Xcode7需要的是libz.tbd;Xcode7以下版本是libz.dylib
Adsupport.framework (獲取IDFA需要援制;如果不使用IDFA戏挡,請(qǐng)不要添加)
UserNotifications.framework(Xcode8及以上)
libresolv.tbd (JPush 2.2.0及以上版本需要)
3. 創(chuàng)建并配置PushConfig.plist文件
在你的工程中創(chuàng)建一個(gè)新的Property List文件,并將其命名為PushConfig.plist晨仑,文件所含字段如下:
1. CHANNEL
指明應(yīng)用程序包的下載渠道褐墅,為方便分渠道統(tǒng)計(jì),具體值由你自行定義洪己,如:App Store妥凳。
2. APP_KEY
填寫(xiě)管理Portal上創(chuàng)建應(yīng)用后自動(dòng)生成的AppKey值。請(qǐng)確保應(yīng)用內(nèi)配置的 AppKey 與第1步在 Portal 上創(chuàng)建應(yīng)用后生成的 AppKey 一致码泛。
3. APS_FOR_PRODUCTION
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)境一致。
在1.2.2或之前版本的配置文件中痢站,有 TEST_MODE 這個(gè)鍵磷箕,新版的SDK不再使用,可以將它刪除阵难。
Paste_Image.png
第五步:添加代碼
2.1.0版本開(kāi)始,API類(lèi)名為JPUSHService岳枷,不再使用原先的APService
1. 注冊(cè)極光
在橋接文件中導(dǎo)入頭文件#import "JPUSHService.h"
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, WXApiDelegate {
var window: UIWindow?
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
// 極光推送
if #available(iOS 8.0, *) {
let type: UInt = UIUserNotificationType.Badge.rawValue | UIUserNotificationType.Sound.rawValue | UIUserNotificationType.Alert.rawValue
JPUSHService.registerForRemoteNotificationTypes(type, categories: nil)
} else {
let type: UInt = UIUserNotificationType.Badge.rawValue | UIUserNotificationType.Sound.rawValue | UIUserNotificationType.Alert.rawValue
JPUSHService.registerForRemoteNotificationTypes(type, categories: nil)
}
// 參數(shù)2: 填你創(chuàng)建的應(yīng)用生成的AppKey
// 參數(shù)3: 可以不填
// 參數(shù)4: 這個(gè)值生產(chǎn)環(huán)境為YES,開(kāi)發(fā)環(huán)境為NO(BOOL值)
JPUSHService.setupWithOption(launchOptions, appKey: "62ea209c75aadacd9f863b65", channel: nil, apsForProduction: false)
return true
}
2. 注冊(cè)DeviceToken
// 注冊(cè)成功后會(huì)調(diào)用AppDelegate的下面方法,得到設(shè)備的deviceToken
func application(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) {
JPUSHService.registerDeviceToken(deviceToken)
print("Notification token: ", deviceToken)
}
//(App即將進(jìn)入前臺(tái))中將小紅點(diǎn)清除
func applicationWillEnterForeground(application: UIApplication) { UIApplication.sharedApplication().applicationIconBadgeNumber = 0
}
// 處理接收推送錯(cuò)誤的情況(一般不會(huì)…)
func application(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSError) {
print("error: Notification setup failed: ", error)
}
// App在后臺(tái)時(shí)收到推送時(shí)的處理
func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) {
JPUSHService.handleRemoteNotification(userInfo)
let alert: String = userInfo["aps"]!["alert"] as! String
var badge: Int = userInfo["aps"]!["badge"] as! Int
badge -= 1
JPUSHService.setBadge(badge)
UIApplication.sharedApplication().applicationIconBadgeNumber = 0
/**
* iOS的應(yīng)用程序分為3種狀態(tài)
* 1空繁、前臺(tái)運(yùn)行的狀態(tài)UIApplicationStateActive殿衰;
* 2、后臺(tái)運(yùn)行的狀態(tài)UIApplicationStateInactive盛泡;
* 3闷祥、app關(guān)閉狀態(tài)UIApplicationStateBackground。
*/
// 應(yīng)用在前臺(tái) 或者后臺(tái)開(kāi)啟狀態(tài)下傲诵,不跳轉(zhuǎn)頁(yè)面凯砍,讓用戶(hù)選擇。
if (application.applicationState == UIApplicationState.Active) || (application.applicationState == UIApplicationState.Background){
UIAlertView(title: "推送消息", message: "\(alert)", delegate: nil, cancelButtonTitle: "確定").show()
}else{
//殺死狀態(tài)下拴竹,直接跳轉(zhuǎn)到跳轉(zhuǎn)頁(yè)面
}
// badge清零
application.applicationIconBadgeNumber = 0
JPUSHService.resetBadge()
completionHandler(UIBackgroundFetchResult.NewData)
}
結(jié)果
運(yùn)行出現(xiàn)以下信息悟衩,表示連接成功
Paste_Image.png
發(fā)送推送消息
Paste_Image.png
極光平臺(tái)推送測(cè)試成功狀態(tài)
Paste_Image.png