数据改变世界,关于JPush(极光推送)那些细枝末节的事
iOS不倒,博客不停
JPush的文档说明挺不错,非常详细!为什么还要写这篇简书?主要是为了记录自己开发过程,也给一些朋友提供一点点帮助.首先是JPush的文档地址:JPush文档
JPush,推送原理
可以看出,JPush iOS Push 包括 2 个部分,APNs 推送(代理)与 JPush 应用内消息。
红色部分是 APNs 推送,JPush 代理开发者的应用(需要基于开发者提供的应用证书),向苹果 APNs 服务器推送。由 APNs Server 推送到 iOS 设备上。
蓝色部分是 JPush 应用内推送部分,即 App 启动时,内嵌的 JPush SDK 会开启长连接到 JPush Server,从而 JPush Server 可以推送消息到 App 里
APNs 通知
APNs 通知:是指通过向 Apple APNs 服务器发送通知,到达 iOS 设备,由 iOS 系统提供展现的推送。用户可以通过 IOS 系统的 “设置” >> “通知” 进行设置,开启或者关闭某一个 App 的推送能力。
JPush iOS SDK 不负责 APNs 通知的展现,只是向 JPush 服务器端上传 Device Token 信息,JPush 服务器端代理开发者向 Apple APNs 推送通知。
获取 APNs 推送内容
应用内消息
应用内消息:JPush iOS SDK 提供的应用内消息功能,在 App 在前台时能够收到推送下来的消息。App 可使用此功能来做消息下发动作。
此消息不经过 APNs 服务器,完全由 JPush 提供功能支持。
APNs通知与应用内消息对比
如果只需要发送通知,则可以忽略应用内消息的处理。对于两种消息的代码处理可以参考API 部分的描述。
JPush API v3 支持同时一次调用同时推送 APNs 通知与 JPush 应用内消息。这在某些应用场景里是有意义的。
APNs 通知与应用内消息对比.png
OK,原理了解之后,下面开始集成.
- 1:下载JPush的SDK:SDK下载地址
- 2:在JPush平台注册应用,这里的目的:
- A:交付授权,因为在这里开发者需要上传应用的推送开发证书,推送生产证书,这样JPush平台就能去苹果服务器拿去一个推送关键字段:DeviceToken,相当于授权码.
- B:平台注册,还会生成一个:AppKey和一个MasterSecret.这两个东西相当于一个登陆账号,一个登陆密码.这样生成出来,JPush就能根据MasterSecret.去校验** AppKey,然后去找绑定在这个 AppKey上面的生产,开发证书授权的DeviceToken**去苹果服务器推送消息.
JPush平台创建应用.jpg
生成成产,开发证书
JPush创建成功.jpg
- 3 导入SDK
将SDK包解压,在Xcode中选择“Add files to 'Your project name'...”,将解压后的lib子文件夹(包含JPUSHService.h、jpush-ios-x.x.x.a,jcore-ios-x.x.x.a)添加到你的工程目录中。
添加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)
*4:编译与开启推送功能
编译与开启推送功能
*5:ATS
*6:添加头文件和添加代理
请将以下代码添加到 AppDelegate.m 引用头文件的位置。
- 7:核心代码: 添加初始化代码
添加初始化APNs代码
请将以下代码添加到
添加初始化JPush代码
注册APNs成功并上报DeviceToken
实现注册APNs失败接口(可选)
添加处理APNs通知回调方法
下面这几个方法也是核心代码,这是对通知的回调方法,通知达到之后会调用这下面的方法,所以说也是必须要实现的.JPush考虑很周全,涉及到了各个版本,但是方法太多,要是能一个方法处理完就更好了.
调用,成功打印:
程序到这,也就基本集成完毕:
8:还有推送的一些新特性极光新特性地址
action.jpg
这样就能给你推送添加操作:
具体代码:
iOS 10 想要对这些操作action处理:
iOS 9 想要对这些操作action处理:
iOS 8 想要对这些操作action处理:
上面三个方法还可以对附件:attachment操作处理;
9:这里还介绍一下关于设置tags和alias
10:设置Badge
清空JPush服务器中存储的badge值,即 [setBadge:0]
+ (void)resetBadge
11:API 用于移除待推送或已在通知中心显示的推送(支持iOS10,并兼容iOS10以下版本)
iOS10以上identifier设置为nil,则移除所有在通知中心显示推送和待推送请求,也可以通过设置identifier.delivered和identifier.identifiers来移除相应在通知中心显示推送或待推送请求,identifier.identifiers如果设置为nil或空数组则移除相应标志下所有在通知中心显示推送或待推送请求;iOS10以下identifier设置为nil,则移除所有推送,identifier.delivered属性无效,另外可以通过identifier.notificationObj传入特定推送对象来移除此推送。
12:极光还有下面的功能(因为项目没有集成,没有仔细研究):极光响应SDK地址
- AddNotification: 广告推送
- FindNotification: 查询推送
- SetLocalNotification: 地理推送
- clearAllLocalNotification:用于清除所有注册的通知
花了一周时间学习极光推送,虽然时间有点长,但是对于我自己来说很不错了,沉下心来慢慢学东西,不管外面iOS多么多么惨,但是只要一天iOS不倒,我还会坚持学习,坚持学