Android的推送一直是个大坑，好在统一联盟的的推送在测试了，希望早点一统推送，挖去开发者的心病吧。在此之前，该踩坑还是踩坑，按官方文档一步步踩吧。
集成
-
先集成必备套件 HMS SDK Agent
- 下载地址：HMSAgent_2.6.3.301.zip
-
解压后运行GetHMSAgent_cn.bat文件生成我们所需的文件，输入我们的应用包名和后台配置应用生成的appid，回车运行， cpid没有可以跳过继续，按需集成所需要的功能。
解压目录、执行文件和生成后文件夹.png
命令执行过程.png
- 代码拷贝
- 标准的AS项目直接拷贝到app/src/main/下即可
- 转换成AS项目的我将java下的文件夹及AppManifestConfig.xml文件拷贝至src/下，结构如图
拷贝后目录结构.png
生成文件目录.png
-
自动集成
项目build.gradle配置
allprojects {
repositories {
···
maven {url 'http://developer.huawei.com/repo/'}
}
}
app的build.gradle配置
dependencies {
···
//说明：{version} 替换为实际的版本号，如：compile 'com.huawei.android.hms:push:2.6.3.301'
compile 'com.huawei.android.hms:push:{version}'
}
最后进行同步配置
-
手动集成
毕竟现在都用AS了，自动集成的方便手动集成你想象不到啊，奈何还有Eclipse转成AS的项目，怎么都下载不到依赖包，只能老老实实手动集成了
- SDK下载：hmssdk-gradle-2.6.3.301.zip
- 解压后进行代码拷贝，这里文件夹结构简单，直接全部复制到对应工程相应文件夹即可
解压目录.png
好像。。。也挺简单。。。
开始配置与初始化
- 配置manifest文件<记得更改appid和${PACKAGE_NAME}>
因为当前应用只需要推送功能，所以我只集成了推送必须项
- 配置appid application节点下
<meta-data android:name="com.huawei.hms.client.appid" <!-- value的值“xxx”用实际申请的应用ID替换，来源于开发者>联盟网站应用的服务详情。--> android:value="appid=xxx"> </meta-data>
- 配置自定义的Application，这个开发过程中我们都会做的
- 配置BridgeActivity --定义了HMS SDK中一些跳转所需要的透明页面
<activity android:name="com.huawei.hms.activity.BridgeActivity" android:configChanges="orientation|locale|screenSize|layoutDirection|fontScale" android:excludeFromRecents="true" android:exported="false" android:hardwareAccelerated="true" android:theme="@android:style/Theme.Translucent" > <meta-data android:name="hwc-theme" android:value="androidhwext:style/Theme.Emui.Translucent" /> </activity>
- 在manifest节点下增加所需权限
<!--HMS-SDK引导升级HMS功能，访问OTA服务器需要网络权限--> <uses-permission android:name="android.permission.INTERNET" /> <!--HMS-SDK引导升级HMS功能，保存下载的升级包需要SD卡写权限--> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!--检测网络状态--> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <!--检测wifi状态--> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <!--为了获取用户手机的IMEI，用来唯一的标识用户。--> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <!--如果是安卓8.0，应用编译配置的targetSdkVersion>=26，请务必添加以下权限 --> <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" /> <!-- 接收PUSH TOKEN的广播以及PUSH消息需要定义该权限 ${PACKAGE_NAME} 要替换上您应用的包名 --> <permission android:name="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG" android:protectionLevel="signatureOrSystem"/> <!--接收PUSH TOKEN的广播以及PUSH消息需要定义该权限 ${PACKAGE_NAME} 要替换上您应用的包名 --> <uses-permission android:name="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG" />
- 配置Receiver
<!-- 接入HMSSDK PUSH模块需要注册，第三方相关 :接收Push消息（注册、透传消息、通知栏点击事件）广播，此receiver类需要开发者自己创建并继承com.huawei.hms.support.api.push.PushReceiver类，参考示例代码中的类：com.huawei.hmsagent.HuaweiPushRevicer--> <!--“xxx”用实际的类名替换, ${PACKAGE_NAME} 要替换上您应用的包名--> <receiver android:name=".receiver.HWReciver" android:permission="com.foxhis.kft.permission.PROCESS_PUSH_MSG"> <intent-filter> <!-- 必须,用于接收token --> <action android:name="com.huawei.android.push.intent.REGISTRATION" /> <!-- 必须, 用于接收透传消息 --> <action android:name="com.huawei.android.push.intent.RECEIVE" /> <!-- 必须, 用于接收通知栏消息点击事件 此事件不需要开发者处理，只需注册就可以--> <action android:name="com.huawei.intent.action.PUSH_DELAY_NOTIFY"/> </intent-filter> </receiver>配置自己的HWReciver.png
- Agent初始化
在自定义的Application中的onCreat中调用com.huawei.android.hms.agent.HMSAgent.init(this);
使用与测试
- 调用获取token
开发文档要求：调用connect、请务必在应用启动后的首个activity的onCreate方法中调用connect接口，确保HMS SDK和HMS APK的连接。
因为我这边是一进去就执行获取token，因此我将连接与申请抽成一个方法然后在启动的Activity的onCreate中执行
image.png
- 推送测试与错误码
华为推送通道因为预先配置了SHA256指纹信息，后期测试时需要签名打包才能进行测试，所以这里可以预先更改下debug包的签名模式来方便调试，注意signingConfigs一定要在buildTypes之前，否则会出错
debug签名配置.png
运行后输出log日志，根据返回的code来对比通用错误码判断是否成功
获取成功.png
过程中刚开始一直拿不到token，四处翻找之后过一会又可以了，初步怀疑中间有什么耗时配置，后期会好很多，拥有token之后就可以去后台进行测试了，推送还是很快的
获取签名包证书指纹信息 SHA256获取
keytool.exe -printcert -jarfile ....\release\app-release.apkimage.png
网友评论