Android华为推送集成与测试

时间:2024-04-09 09:37:53

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

集成

官方的开发准备

  • 先集成必备套件 HMS SDK Agent

  1. 下载地址:HMSAgent_2.6.3.301.zip
  2. 解压后运行GetHMSAgent_cn.bat文件生成我们所需的文件,输入我们的应用包名和后台配置应用生成的appid,回车运行, cpid没有可以跳过继续,按需集成所需要的功能。
    Android华为推送集成与测试Android华为推送集成与测试
  3. 代码拷贝
  • 标准的AS项目直接拷贝到app/src/main/下即可
  • 转换成AS项目的我将java下的文件夹及AppManifestConfig.xml文件拷贝至src/下,结构如图Android华为推送集成与测试

Android华为推送集成与测试

  • 自动集成

    项目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}'         
  }        
    

最后进行同步配置

开始配置与初始化

  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>

Android华为推送集成与测试

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

使用与测试

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

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

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

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

Android华为推送集成与测试