31- 最新环信推送封装 v3.0【附代码】

环信版本: 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保持一致即可.

1. LLPushNotificationManager.m中指定环信应用标识：

     EMOptions *options = [EMOptions optionsWithAppkey:@"环信应用标识"];
   

2. LLPushNotificationManager.m中指定上传到环信后台的推送证书名称：

    #if DEBUG
        options.apnsCertName = @"自己上传到环信后台的推送证书名称";
    #else
        options.apnsCertName = @"自己上传到环信后台的推送证书名称";
    #endif
   

3. LLPushNotificationManager.m中指定IM账户：

    ll_huanxinLoginWithName:@"lisi" password:@"123456"
   

4. 首次进入应用，需要账户页面，点击登录。和应用的正常使用逻辑相同。关于环信的自动登录接口定义，在环信API中可查。

接入到自己的项目

LLPushNotificationManager.m中FIXME 指明了需要替换的文件名称和业务逻.

FIXME

接入环信SDK的坑

1. 首先环信有技术支持的。只不过技术支持的形式类似于Github的Issues。环信里边叫工单，入口是【应用概括->工单支持中心】，在这里边你填写工单，提交之后等待技术支持回复就可以了。回复速度还是挺快的。

   

   工单

2. 推送，接入EaseUI和HyphenateSDK两个就可以了。拖入到项目中后，首先按照下图导入依赖包。

依赖包

3. 导入依赖包之后,会报错,我们需要在EaseUI导入 #import, 在HyphenateSDK中将

    #if ENABLE_LITE == 1
    #import 
    #else
    #import 
    #endif
   

   只保留

    #import 
   

   或者在项目 target 中的Preprocessor Macros中加入ENABLE_LITE == 1,和我在《27- iOS项目管理一: 利用Target来管理项目的调试、测试、发布等不同版本或者OEM版本》写的那样。

4. 还有，记住真机运行。

技巧

1. 因为点击离线状态的推送消息打开APP和直接启动APP是不同的启动方式，在我们做推送点击判断的时候，是需要知道应用是怎么启动的。判断依据就是application:didFinishLaunchingWithOptions：方法中的launchOptions参数。 具体看此篇文章：《iOS开发 ---- 关于 launchOptions参数下的判断应用的启动方式》

2. 根据点击跳转最关键的是要拿到项目的UITabBarController.然后根据UITabBarController获取到当前控制器的UINavigationColtroller，进行跳转。可以参考 《iOS收到推送后，跳转到某一页面》的最下边的代码。

Demo地址

/忧伤的表情, 今天才发现我忘记贴封装代码的地址了...... 赶快补上 【LLHuanXinPushManager】

---

参考

1. 关于本地推送和推送通知框的，看这个《LocalNotification》就可以了，对应的两篇文章也推荐阅读。
2. 理论知识： 《官方API》
3. 理论知识： 《喵神-活久见的重构 - iOS 10 UserNotifications 框架解析》
4. 理论知识：徐不同的 《iOS开发 iOS10推送必看(基础篇)》、 《iOS10推送必看UNNotificationAttachment以及UNTimeIntervalNotificationTrigger》、《iOS10推送必看UNNotificationServiceExtension》
5. 理论知识：《推送证书制作和环信使用》
6. 理论知识： 《iOS9和iOS10推送通知处理小结》

交流

---

希望能和大家交流技术
Blog:http://www.lilongcnc.cc

---