Android华为推送集成与测试

Android的推送一直是个大坑，好在统一联盟的的推送在测试了，希望早点一统推送，挖去开发者的心病吧。在此之前，该踩坑还是踩坑，按官方文档一步步踩吧。

集成

官方的开发准备

• 先集成必备套件 HMS SDK Agent

1. 下载地址：HMSAgent_2.6.3.301.zip

2. 解压后运行GetHMSAgent_cn.bat文件生成我们所需的文件，输入我们的应用包名和后台配置应用生成的appid，回车运行， cpid没有可以跳过继续，按需集成所需要的功能。

   
   解压目录、执行文件和生成后文件夹.png 命令执行过程.png
3. 代码拷贝

• 标准的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
  好像。。。也挺简单。。。

开始配置与初始化

1. 配置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

2. Agent初始化
   在自定义的Application中的onCreat中调用com.huawei.android.hms.agent.HMSAgent.init(this);

使用与测试

1. 调用获取token
   开发文档要求：调用connect、请务必在应用启动后的首个activity的onCreate方法中调用connect接口，确保HMS SDK和HMS APK的连接。
   因为我这边是一进去就执行获取token，因此我将连接与申请抽成一个方法然后在启动的Activity的onCreate中执行
   image.png
2. 推送测试与错误码
   华为推送通道因为预先配置了SHA256指纹信息，后期测试时需要签名打包才能进行测试，所以这里可以预先更改下debug包的签名模式来方便调试，注意signingConfigs一定要在buildTypes之前，否则会出错 debug签名配置.png
   运行后输出log日志，根据返回的code来对比通用错误码判断是否成功 获取成功.png

过程中刚开始一直拿不到token，四处翻找之后过一会又可以了，初步怀疑中间有什么耗时配置，后期会好很多，拥有token之后就可以去后台进行测试了，推送还是很快的

获取签名包证书指纹信息 SHA256获取

keytool.exe -printcert -jarfile ....\release\app-release.apk

image.png