环信版本: v3.0
使用前,还是应该了解一下iOS本地推送(LocalNotification)和远程推送(RemoteNotification)的内容。
环信推送
环信,主要是做即时通讯的,也就是IM。所以推送是结合在即时通讯里边的。 我们导入的SDK包即使是精简版,其实是包含聊天功能的。 基于这一点,我们在接入换新推送的时候,需要单独调用环信的登录接口,登录环信的聊天后台,才可以正常接收推送。
另外,环信推送只支持离线APNS, 应用存活状态下(前台和后台),是不会显示推送消息的。 这一点我们需要注意。
还有,App进入后台后,能够保持长连接3分钟左右。超过3分钟,长连接会断开,当前登录的账号,在服务端被认为离线,也就是这时候收到的推送是离线推送。
封装效果
- 适配iOS8~iOS10和iOS10+
- 环信登录、注销、自动登录等
- 使用EBForeNotification,当应用在前台时,iOS8-iOS10也显示推送弾框。
- UITabBarController+UINavigationController模式, 点击推送消息跳转到执行页面。 当处于指定页面时,再次点击推送消息执行自定义逻辑。
- 我的项目中,并没有给通知弾框增加Action和附件支持,如果需要的话,可以在下边的参考小节中参考另一个demo。
- 解决了 发了很多推送,App也收到了推送,但是通知栏却只显示最后一条推送 问题
运行demo
注意: 全部需要注意的地方,已经在代码中用error标出, 运行demo只要注释掉即可. 另外,环信IM的登录和退出和app保持一致即可.
-
LLPushNotificationManager.m
中指定环信应用标识:EMOptions *options = [EMOptions optionsWithAppkey:@"环信应用标识"];
-
LLPushNotificationManager.m
中指定上传到环信后台的推送证书名称:#if DEBUG options.apnsCertName = @"自己上传到环信后台的推送证书名称"; #else options.apnsCertName = @"自己上传到环信后台的推送证书名称"; #endif
-
LLPushNotificationManager.m
中指定IM账户:ll_huanxinLoginWithName:@"lisi" password:@"123456"
首次进入应用,需要
账户
页面,点击登录。和应用的正常使用逻辑相同。关于环信的自动登录接口定义,在环信API中可查。
接入到自己的项目
LLPushNotificationManager.m
中FIXME 指明了需要替换的文件名称和业务逻.
接入环信SDK的坑
-
首先环信有技术支持的。只不过技术支持的形式类似于Github的Issues。环信里边叫工单,入口是【应用概括->工单支持中心】,在这里边你填写工单,提交之后等待技术支持回复就可以了。回复速度还是挺快的。
推送,接入
EaseUI
和HyphenateSDK
两个就可以了。拖入到项目中后,首先按照下图导入依赖包。
-
导入依赖包之后,会报错,我们需要在
EaseUI
导入#import<UIKit/UIKit.h>
, 在HyphenateSDK
中将#if ENABLE_LITE == 1 #import <HyphenateLite/HyphenateLite.h> #else #import <Hyphenate/Hyphenate.h> #endif
只保留
#import <HyphenateLite/HyphenateLite.h>
或者在项目 target 中的
Preprocessor Macros
中加入ENABLE_LITE == 1
,和我在《27- iOS项目管理一: 利用Target来管理项目的调试、测试、发布等不同版本或者OEM版本》写的那样。 还有,记住真机运行。
技巧
因为点击离线状态的推送消息打开APP和直接启动APP是不同的启动方式,在我们做推送点击判断的时候,是需要知道应用是怎么启动的。判断依据就是
application:didFinishLaunchingWithOptions:
方法中的launchOptions参数。 具体看此篇文章:《iOS开发 ---- 关于 launchOptions参数下的判断应用的启动方式》根据点击跳转最关键的是要拿到项目的UITabBarController.然后根据UITabBarController获取到当前控制器的UINavigationColtroller,进行跳转。可以参考 《iOS收到推送后,跳转到某一页面》的最下边的代码。
Demo地址
/忧伤的表情, 今天才发现我忘记贴封装代码的地址了...... 赶快补上 【LLHuanXinPushManager】
参考
- 关于本地推送和推送通知框的,看这个《LocalNotification》就可以了,对应的两篇文章也推荐阅读。
- 理论知识: 《官方API》
- 理论知识: 《喵神-活久见的重构 - iOS 10 UserNotifications 框架解析》
- 理论知识:徐不同的 《iOS开发 iOS10推送必看(基础篇)》、 《iOS10推送必看UNNotificationAttachment以及UNTimeIntervalNotificationTrigger》、《iOS10推送必看UNNotificationServiceExtension》
- 理论知识:《推送证书制作和环信使用》
- 理论知识: 《iOS9和iOS10推送通知处理小结》
交流
希望能和大家交流技术
Blog:http://www.lilongcnc.cc