公司准备采用个推作为第三方推送平台,我作为客户端的头号小鸟,掐指一算已经毕业 0.1 年了,Leader 准备把这个简单而又独立的功能点交给我来处理,我紧张兮兮的打开 官网集成文档 学习了起来。其实早在自己大二的时候就集成过个推 SDK,溜达一圈又回来集成个推推送SDK了,发现现在的个推 SDK 与当年相比,集成起来真的方便多了。这次集成的是Android推送SDK,希望这篇文章,可以让同学们可以更加快捷的集成个推推送。
创新互联于2013年创立,是专业互联网技术服务公司,拥有项目成都网站建设、网站建设网站策划,项目实施与项目整合能力。我们以让每一个梦想脱颖而出为使命,1280元惠安做网站,已为上家服务,为惠安各地企业和个人服务,联系电话:18980820575
cdn.xitu.io/2019/8/27/16cd2c41d4126fba?imageView2/0/w/1280/h/960/format/webp/ignore-error/1">
我的师傅大鸟哥告诉我,集成各类 SDK 的第一步骤都是下载个 Demo,先把 Demo 跑起来看看是什么鬼。咱也不敢问,咱也不敢说,先去 下载个Demo玩玩。我选择的是国内版本的个推 SDK,大家可以自行选择要下载的版本。使用 AS 3.1 把 Getui_SDK_Demo_AS_maven 这个工程直接运行起来,出现了下面这个界面(此处已经对我个人参数进行了手动马赛克)。
"/> 好了,按我大鸟哥的意思至少 demo 已经成功运行起来了,接下去就是去把上述的 APPID,APPKey 等参数换成自己的,那么这些参数又是怎么来的呢?
看完 Demo 后,慌兮兮打开官网集成文档,原来那些参数是需要创建应用才会获得的,而 cid 是个推SDK 回调的,没啥说的,那就 “注册登录-创建应用-获取配置” 三连击
"/>
登入成功后,点击我的应用进入,再接着点击右上角的《创建应用》就可以创建属于自己的应用了,因为我已经创建完成,所以此处有城墙一样厚的马赛克????????????
"/>
填写自身 APP 的基础信息
"/> 敲黑板!!!,iOS 是默认不勾选的,听说 iOS 有自带的推送系统?先不管了,勾上再说,他们爱用不用。
由于我已经注册完成了,填完后的界面就要靠大家自行脑补了。应用创建成功后,就可以查看我们创建的 APP 所绑定的配置信息了。
"/> 看到这里,我终于知道了之前 Demo 里面的那些配置信息是哪里来的了,为了保证我这些参数是有效的, 我还来了一波骚操作: 把 Demo 里面的工程的包名换成自己创建 APP 的包名,appid等信息也进行了替换,发现成功拿到了 cid ,问了下他们技术支持,大概意思是 只要拿到 cid,集成就完成了 90 %!!! ,鸟弟我激动的搓起了小手。后面的思路就清晰了,无非是把 Demo 里东西拷到自己的项目里面就完事了嘛。
我使用 Maven 的方式集成了 2.13.2.0 版本的 SDK,选用 Maven是为了方(偷)便(懒)的集成!如果是选择手动集成的, 请疯狂戳我 先看下他们的资料包的内容
"/> 看这个资料包,发现要导入的东西还是蛮多的, 各种资源,我选择了 Maven 集成,那么 jar 包& so 就无需导入了
allprojects { repositories { maven { url 'http://mvn.gt.igexin.com/nexus/content/repositories/releases' } } } 复制代码
dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) compile 'com.getui:sdk:2.13.2.0' } 复制代码
依葫芦画瓢,这里就直接从 demo 那边拷过来就行了 千万千万要小心,认真核对每一个参数,如果出现空格或者 Appid 与 AppKey写反这类的 低级错误真的要检查到哭????????????
manifestPlaceholders = [ GETUI_APP_ID : "你的 APPID", GETUI_APP_KEY : "你的 APP_KEY", GETUI_APP_SECRET : "你的 APP_SECRET" ] 复制代码
千万千万别忘了,我之前就在这个地方踩了坑,使用 maven 集成就不再需要 so 文件,切记!
可选可不选的权限,我这边是写上了,因为我项目中正好也需要用到这些权限,美滋滋~
复制代码
Demo 里面还配置了自定义的 service,我也搞了后,官网上有这么一句话
为了让推送服务在部分主流机型上更稳定运行,从2.9.5.0版本开始,个推支持第三方应用配置使用自定义Service来作为推送服务运行的载体
都这么说了,鸟弟我二话不说就 new 一个自定义服务,进行空实现即可
package com.xinwenwang.xy; import com.igexin.sdk.PushService; public class XyPushService extends PushService { } 复制代码
新建的 service 千万别忘了把新建的 service 注册到 AndroidManifest.xml 中,多么痛的领悟
复制代码
深入一想也可以理解为啥要加个空实现的 service,就像集成微信分享一样,微信分享也要求继承一个指定的 activity。
这么一步步的走下来,要配置挺多东西的,终于要开始初始化 SDK 了 ????♀️????♀️????♀️
com.igexin.sdk.PushManager.getInstance().initialize(getApplicationContext(), com.xxxx.yyyy.XyPushService.class); 复制代码
我这边是在开屏页初始化个推推送的,大家可以随意,只要在 activity 初始化即可, 建议是初始化越早越好
那么问题来了,搞了上面这么多东西,推送的消息或者透传是怎么个接收法呢?一头雾水有木有!我又跑回去看了看 Demo,发现还有个叫 DemoIntentService 的玩意,打开一看里面有很多很多的回调,鸟哥说的话果然带劲呀, Demo 理解透,项目集成快! 建议大家直接把 Demo 中的 DemoIntentService 拷到自己的项目中,如果需要修改一些DemoIntentService 里面的内容,自便哈。记得修改个名字,不然放在自己的项目里面真的太 low 了!我暂名为 XyPushIntentService。
复制代码
// XyPushIntentService 为第三方自定义的推送服务事件接收类 PushManager.getInstance().registerPushIntentService(getApplicationContext(), XyPushIntentService.class); 复制代码
总算集成完了,导入上述东西需要细心些哈,漏了一步有的你难受的。 项目跑起来后,在 XyPushIntentService 会有 cid 的回调,最直观的方法是在 logcat 里面输入 clientid ,就可以看到在控制台输出日志了, 这个 clientID 相当于此 APP 在该设备上的唯一识别码。
"/> 最后一步肯定是创建通知了。 "/>
"/>
这边只是创建了一个最最最简单的样式仅供参考,我看这界面上的功能估计可以满足各种运营的玩法了,我这边就不献丑了:)。 推送测试消息的时候,应用一定要在前台,在前台,在前台,重要的事情说三遍
#尾声 首次集成这类大型 SDK 让我意想不到的顺利,我和我的小伙伴们都????惊呆了????,后面我再仔细阅读了下个推的文档,他们家的功能还是很齐全的,我仅是进行了最基础的集成而已,不过也可以满足产品与运营的需求了。不得不提一句,他们的技术支持服务确实够劲(此处确实是一条广告实锤了~),回复的快而准。现在我得赶紧去写 Bug 了,告辞????????????~~~
原文链接: blog.csdn.net/u013651405/… 作者:吃饱了想睡
行业前沿、移动开发、数据建模等干货内容,尽在公众号:个推技术学院