iOS 平台上推送通知,只有 APNs 这个官方的通道,是可以随时送达的。一般开发者都是自己部署应用服务器向 APNs Server 推送。
JPush iOS 推送相比直接向 APNs 推送有什么好处呢?
1. 减少开发及维护成本:
应用开发者不需要去开发维护自己的推送服务器与 APNs 对接。
集成了 JPush iOS SDK 后不必自己维护更新 device token。
通过 JPush 的 Web Portal 直接推送,也可以调用JPush的 HTTP 协议 API 来完成,开发工作量大大减少。
2. 减少运营成本:
极光推送支持一次推送,同时向 Android, iOS, WinPhone 三个平台。支持统一的 API 与推送界面。
极光推送提供标签、别名绑定机制,以及提供了非常细分的用户分群方式,运营起来非常简单、直观。
3. 提供应用内推送:
除了使得 APNs 推送更简单,也另外提供应用内消息推送。这在类似于聊天的场景里很有必要。
第一步:在极光官网注册极光推送
第二步:下载SDK
资源文件
包名为JPush-iOS-SDK-{版本号}
lib文件夹:包含头文件 JPUSHService.h,静态库文件jpush-ios-x.x.x.a ,支持的iOS版本为 6.0 及以上版本。(请注意:模拟器不支持APNs)
pdf文件:集成指南
demo文件夹:示例
第三步:创建应用-在 JPush的管理Portal 上创建应用并上传推送(APNs)证书
创建成功后自动生成 AppKey 用以标识该应用
第四步:配置工程
1. 导入SDK
将SDK包解压,在Xcode中选择“Add files to 'Your project name'...”,将解压后的lib子文件夹(包含JPUSHService.h、jpush-ios-x.x.x.a)添加到你的工程目录中
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,请不要添加)
UserNotifications.framework(Xcode8及以上)
libresolv.tbd (JPush 2.2.0及以上版本需要)
3. 创建并配置PushConfig.plist文件
在你的工程中创建一个新的Property List文件,并将其命名为PushConfig.plist,文件所含字段如下:
1. CHANNEL
指明应用程序包的下载渠道,为方便分渠道统计,具体值由你自行定义,如:App Store。
2. APP_KEY
填写管理Portal上创建应用后自动生成的AppKey值。请确保应用内配置的 AppKey 与第1步在 Portal 上创建应用后生成的 AppKey 一致。
3. APS_FOR_PRODUCTION
1.3.1版本新增,用于标识当前应用所使用的APNs证书环境。
0 (默认值)表示采用的是开发证书,1 表示采用生产证书发布应用。
注:此字段的值要与Build Settings的Code Signing配置的证书环境一致。
在1.2.2或之前版本的配置文件中,有 TEST_MODE 这个键,新版的SDK不再使用,可以将它删除。
第五步:添加代码
2.1.0版本开始,API类名为JPUSHService,不再使用原先的APService
1. 注册极光
在桥接文件中导入头文件#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)
}
// 参数2: 填你创建的应用生成的AppKey
// 参数3: 可以不填
// 参数4: 这个值生产环境为YES,开发环境为NO(BOOL值)
JPUSHService.setupWithOption(launchOptions, appKey: "62ea209c75aadacd9f863b65", channel: nil, apsForProduction: false)
return true
}
2. 注册DeviceToken
// 注册成功后会调用AppDelegate的下面方法,得到设备的deviceToken
func application(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) {
JPUSHService.registerDeviceToken(deviceToken)
print("Notification token: ", deviceToken)
}
//(App即将进入前台)中将小红点清除
func applicationWillEnterForeground(application: UIApplication) { UIApplication.sharedApplication().applicationIconBadgeNumber = 0
}
// 处理接收推送错误的情况(一般不会…)
func application(application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: NSError) {
print("error: Notification setup failed: ", error)
}
// App在后台时收到推送时的处理
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的应用程序分为3种状态
* 1、前台运行的状态UIApplicationStateActive;
* 2、后台运行的状态UIApplicationStateInactive;
* 3、app关闭状态UIApplicationStateBackground。
*/
// 应用在前台 或者后台开启状态下,不跳转页面,让用户选择。
if (application.applicationState == UIApplicationState.Active) || (application.applicationState == UIApplicationState.Background){
UIAlertView(title: "推送消息", message: "\(alert)", delegate: nil, cancelButtonTitle: "确定").show()
}else{
//杀死状态下,直接跳转到跳转页面
}
// badge清零
application.applicationIconBadgeNumber = 0
JPUSHService.resetBadge()
completionHandler(UIBackgroundFetchResult.NewData)
}
结果
运行出现以下信息,表示连接成功
发送推送消息
极光平台推送测试成功状态