Android:消息推送增加推送成功率,集成厂商通道

来源:互联网 发布:java软件工程师笔试题 编辑:程序博客网 时间:2024/05/16 17:34

极光厂商通道功能:

极光新的SDK,已集成了小米,华为,魅族的厂商通道功能
针对VIP用户需要联系商务:
VIP专享高速推送通道、子账户管理、更高的推送频率、用户分群推送 
为了保证 SDK 的易用性,原本 JPush 的所有接口调用逻辑都不用修改,JPush 会对自身支持的功能做兼容

本文重点在于集成厂商通道(后台杀死进程依旧能接受到推送通知)

一、先集成极光SDK 

Android SDK 版本

目前SDK只支持Android 2.3或以上版本的手机系统。富媒体信息流功能则需Android3.0或以上版本的系统。

jcenter 自动集成步骤

说明 : 使用jcenter自动集成的开发者,不需要在项目中添加jar和so,jcenter会自动完成依赖;在AndroidManifest.xml中不需要添加任何JPush SDK 相关的配置,jcenter会自动导入。

  • 如果开发者需要修改组件属性,可以在本地的 AndroidManifest 中定义同名的组件并配置想要的属性,然后用 xmlns:tools 来控制本地组件覆盖 jcenter 上的组件。示例:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"    package="com.android.tests.flavorlib.app"    xmlns:tools="http://schemas.android.com/tools">    <application        android:icon="@drawable/icon"        android:name="com.example.jpushdemo.ExampleApplication"        android:label="@string/app_name" >        <service android:name="cn.jpush.android.service.PushService"            android:process=":multiprocess"            tools:node="replace" >            ……        </service>    ……  </application>  ……</manifest>
  • 确认android studio的 Project 根目录的主 gradle 中配置了jcenter支持。(新建project默认配置就支持)

    buildscript {    repositories {        jcenter()    }    ......}allprojets {    repositories {        jcenter()    }}
  • 在 module 的 gradle 中添加依赖和AndroidManifest的替换变量。

    android {    ......    defaultConfig {        applicationId "com.xxx.xxx" //JPush上注册的包名.        ......        ndk {            //选择要添加的对应cpu类型的.so库。            abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a'            // 还可以添加 'x86', 'x86_64', 'mips', 'mips64'        }        manifestPlaceholders = [            JPUSH_PKGNAME : applicationId,            JPUSH_APPKEY : "你的appkey", //JPush上注册的包名对应的appkey.            JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.        ]        ......    }    ......}dependencies {    ......    compile 'cn.jiguang.sdk:jpush:3.0.9'  // 此处以JPush 3.0.9 版本为例。    compile 'cn.jiguang.sdk:jcore:1.1.7'  // 此处以JCore 1.1.7 版本为例。    ......}

 : 如果在添加以上 abiFilter 配置之后android Studio出现以下提示:

    NDK integration is deprecated in the current plugin. Consider trying the new experimental plugin

则在 Project 根目录的gradle.properties文件中添加:

    android.useDeprecatedNdk=true

说明:若没有res/drawable-xxxx/jpush_notification_icon这个资源默认使用应用图标作为通知icon,在5.0以上系统将应用图标作为statusbar icon可能显示不正常,用户可定义没有阴影和渐变色的icon替换这个文件,文件名不要变。

手动集成步骤

  • 解压缩 jpush-android--3.x.x-release.zip 集成压缩包。
  • 复制 libs/jcore-android-1.x.x.jar 到工程 libs/ 目录下。
  • 复制 libs/jpush-android-3.x.x.jar 到工程 libs/ 目录下。
  • 复制 libs/(cpu-type)/libjcore1xy.so 到你的工程中存放对应cpu类型的目录下。
  • 复制 res/ 中drawable-hdpi, layout, values文件夹中的资源文件到你的工程中 res/ 对应同名的目录下。

说明 1:若没有res/drawable-xxxx/jpush_notification_icon这个资源默认使用应用图标作为通知icon,在5.0以上系统将应用图标作为statusbar icon可能显示不正常,用户可定义没有阴影和渐变色的icon替换这个文件,文件名不要变。

说明 2:使用android studio的开发者,如果使用jniLibs文件夹导入so文件,则仅需将所有cpu类型的文件夹拷进去;如果将so文件添加在module的libs文件夹下,注意在module的gradle配置中添加一下配置:

    android {        ......        sourceSets {            main {                jniLibs.srcDirs = ['libs']                ......            }            ......        }        ......    }

配置 AndroidManifest.xml

根据 SDK 压缩包里的 AndroidManifest.xml 样例文件,来配置应用程序项目的 AndroidManifest.xml 。

主要步骤为:

  • 复制备注为 "Required" 的部分
  • 将标注为“您应用的包名”的部分,替换为当前应用程序的包名
  • 将标注为“您应用的Appkey”的部分,替换为在Portal上注册该应用的的Key,例如:9fed5bcb7b9b87413678c407

小帖士

如果使用android studio, 可在AndroidManifest中引用applicationId的值,在build.gradle配置中 defaultConfig节点下配置,如:

defaultConfig {      applicationId "cn.jpush.example" // <--您应用的包名      …… }

在AndroidManifest中使用 ${applicationId} 引用gradle中定义的包名

AndroidManifest 示例

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"    package="您应用的包名"    android:versionCode="309"    android:versionName="3.0.9"    >    <uses-sdk android:minSdkVersion="9" android:targetSdkVersion="23" />    <!-- Required -->    <permission        android:name="您应用的包名.permission.JPUSH_MESSAGE"        android:protectionLevel="signature" />    <!-- Required -->    <uses-permission android:name="您应用的包名.permission.JPUSH_MESSAGE" />    <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />    <uses-permission android:name="android.permission.INTERNET" />    <uses-permission android:name="android.permission.WAKE_LOCK" />    <uses-permission android:name="android.permission.READ_PHONE_STATE" />    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />    <uses-permission android:name="android.permission.VIBRATE" />    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    <uses-permission android:name="android.permission.WRITE_SETTINGS" />    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />    <!-- Optional. Required for location feature -->    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于开启 debug 版本的应用在6.0 系统上 层叠窗口权限 -->    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />    <uses-permission android:name="android.permission.GET_TASKS" />    <application        android:icon="@drawable/ic_launcher"        android:label="@string/app_name"        android:name="Your Application Name">        <!-- Required SDK 核心功能-->        <!-- 可配置android:process参数将PushService放在其他进程中 -->        <service            android:name="cn.jpush.android.service.PushService"            android:enabled="true"            android:exported="false" >            <intent-filter>                <action android:name="cn.jpush.android.intent.REGISTER" />                <action android:name="cn.jpush.android.intent.REPORT" />                <action android:name="cn.jpush.android.intent.PushService" />                <action android:name="cn.jpush.android.intent.PUSH_TIME" />            </intent-filter>        </service>    <!-- since 3.0.9 Required SDK 核心功能-->        <provider            android:authorities="您应用的包名.DataProvider"            android:name="cn.jpush.android.service.DataProvider"            android:exported="true"        />        <!-- since 1.8.0 option 可选项。用于同一设备中不同应用的JPush服务相互拉起的功能。 -->        <!-- 若不启用该功能可删除该组件,将不拉起其他应用也不能被其他应用拉起 -->         <service             android:name="cn.jpush.android.service.DaemonService"             android:enabled="true"             android:exported="true">             <intent-filter >                 <action android:name="cn.jpush.android.intent.DaemonService" />                 <category android:name="您应用的包名"/>             </intent-filter>         </service>        <!-- Required SDK核心功能-->        <receiver            android:name="cn.jpush.android.service.PushReceiver"            android:enabled="true" >          <intent-filter android:priority="1000">                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />                <category android:name="您应用的包名"/>            </intent-filter>            <intent-filter>                <action android:name="android.intent.action.USER_PRESENT" />                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />            </intent-filter>            <!-- Optional -->            <intent-filter>                <action android:name="android.intent.action.PACKAGE_ADDED" />                <action android:name="android.intent.action.PACKAGE_REMOVED" />                <data android:scheme="package" />            </intent-filter>        </receiver>        <!-- Required SDK核心功能-->        <activity            android:name="cn.jpush.android.ui.PushActivity"            android:configChanges="orientation|keyboardHidden"            android:theme="@android:style/Theme.NoTitleBar"            android:exported="false" >            <intent-filter>                <action android:name="cn.jpush.android.ui.PushActivity" />                <category android:name="android.intent.category.DEFAULT" />                <category android:name="您应用的包名" />            </intent-filter>        </activity>        <!-- SDK核心功能-->        <activity            android:name="cn.jpush.android.ui.PopWinActivity"            android:configChanges="orientation|keyboardHidden"            android:exported="false"            android:theme="@style/MyDialogStyle">            <intent-filter>                <category android:name="android.intent.category.DEFAULT" />                <category android:name="您应用的包名" />            </intent-filter>        </activity>        <!-- Required SDK核心功能-->        <service            android:name="cn.jpush.android.service.DownloadService"            android:enabled="true"            android:exported="false" >        </service>        <!-- Required SDK核心功能-->        <receiver android:name="cn.jpush.android.service.AlarmReceiver" />        <!-- Required since 3.0.7 -->        <!-- 新的tag/alias接口结果返回需要开发者配置一个自定的广播 -->        <!-- 该广播需要继承JPush提供的JPushMessageReceiver类, 并如下新增一个 Intent-Filter -->        <receiver        android:name="自定义 Receiver"        android:enabled="true" >        <intent-filter>        <action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" />        <category android:name="您应用的包名" />        </intent-filter>        </receiver>        <!-- User defined. 用户自定义的广播接收器-->         <receiver             android:name="您自己定义的Receiver"             android:enabled="true">             <intent-filter>                 <!--Required 用户注册SDK的intent-->                 <action android:name="cn.jpush.android.intent.REGISTRATION" />                 <!--Required 用户接收SDK消息的intent-->                 <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" />                 <!--Required 用户接收SDK通知栏信息的intent-->                 <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" />                 <!--Required 用户打开自定义通知栏的intent-->                 <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />                 <!-- 接收网络变化 连接/断开 since 1.6.3 -->                 <action android:name="cn.jpush.android.intent.CONNECTION" />                 <category android:name="您应用的包名" />             </intent-filter>         </receiver>        <!-- Required. For publish channel feature -->        <!-- JPUSH_CHANNEL 是为了方便开发者统计APK分发渠道。-->        <!-- 例如: -->        <!-- 发到 Google Play 的APK可以设置为 google-play; -->        <!-- 发到其他市场的 APK 可以设置为 xxx-market。 -->        <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>        <!-- Required. AppKey copied from Portal -->        <meta-data android:name="JPUSH_APPKEY" android:value="您应用的Appkey"/>    </application></manifest>

配置和代码说明

必须权限说明

权限用途You Package.permission.JPUSH_MESSAGE官方定义的权限,允许应用接收JPUSH内部代码发送的广播消息。RECEIVE_USER_PRESENT允许应用可以接收点亮屏幕或解锁广播。INTERNET允许应用可以访问网络。WAKE_LOCK允许应用在手机屏幕关闭后后台进程仍然运行READ_PHONE_STATE允许应用访问手机状态。WRITE_EXTERNAL_STORAGE允许应用写入外部存储。READ_EXTERNAL_STORAGE允许应用读取外部存储。WRITE_SETTINGS允许应用读写系统设置项。VIBRATE允许应用震动。MOUNT_UNMOUNT_FILESYSTEMS允许应用挂载/卸载 外部文件系统。ACCESS_NETWORK_STATE允许应用获取网络信息状态,如当前的网络连接是否有效。

集成 JPush Android SDK 的混淆

  • 请下载4.x及以上版本的proguard.jar, 并替换你Android Sdk "tools\proguard\lib\proguard.jar"

  • 请在工程的混淆文件中添加以下配置:

    -dontoptimize-dontpreverify-dontwarn cn.jpush.**-keep class cn.jpush.** { *; }-keep class * extends cn.jpush.android.helpers.JPushMessageReceiver { *; }-dontwarn cn.jiguang.**-keep class cn.jiguang.** { *; }
  • 2.0.5 ~ 2.1.7 版本有引入 gson 和 protobuf ,增加排除混淆的配置。(2.1.8版本不需配置)

    #==================gson && protobuf==========================-dontwarn com.google.**-keep class com.google.gson.** {*;}-keep class com.google.protobuf.** {*;}

添加代码

JPush SDK 提供的 API 接口,都主要集中在 cn.jpush.android.api.JPushInterface 类里。

基础API

  • init 初始化SDK

    public static void init(Context context)
  • setDebugMode 设置调试模式

注:该接口需在init接口之前调用,避免出现部分日志没打印的情况。多进程情况下建议在自定义的Application中onCreate中调用。

    // You can enable debug mode in developing state. You should close debug mode when release.    public static void setDebugMode(boolean debugEnalbed)

添加统计代码

  • 参考文档: 统计分析 API

调用示例代码(参考 example 项目)

  • init 只需要在应用程序启动时调用一次该 API 即可。

  • 以下代码定制一个本应用程序 Application 类。需要在 AndoridManifest.xml 里配置。请参考上面 AndroidManifest.xml 片断,或者 example 项目。

    public class ExampleApplication extends Application {@Override    public void onCreate() {        super.onCreate();        JPushInterface.setDebugMode(true);        JPushInterface.init(this);    }}

测试确认

  • 确认所需的权限都已经添加。如果必须的权限未添加,日志会提示错误。
  • 确认 AppKey(在Portal上生成的)已经正确的写入 Androidmanifest.xml 。
  • 确认在程序启动时候调用了init(context) 接口
  • 确认测试手机(或者模拟器)已成功连入网络 + 客户端调用 init 后不久,如果一切正常,应有登录成功的日志信息
  • 启动应用程序,在 Portal 上向应用程序发送自定义消息或者通知栏提示。详情请参考管理Portal。
    • 在几秒内,客户端应可收到下发的通知或者正定义消息,如果 SDK 工作正常,则日志信息会如下:
[JPushInterface] action:init.......[PushService] Login succeed!

如图所示,客户端启动分为 4 步:

  • 检查 metadata 的 appKey 和 channel ,如果不存在,则启动失败
  • 初始化 JPush SDK,检查 JNI 等库文件的有效性,如果库文件无效,则启动失败
  • 检查 Androidmanifest.xml,如果有 Required 的权限不存在,则启动失败
  • 连接服务器登录,如果存在网络问题,则登陆失败,或者前面三步有问题,不会启动JPush SDK

 技术支持

邮件联系:support@jpush.cn

二、集成华为推送

1、注册账号

2、应用通过审核,在产品服务中添加Push权益

3、需要添加应用的SHA256证书指纹。SHA256获取方式

未通过审核的应用无法享受Push权益接收不到推送


4、增加华为HMS SDK的aar

将华为HMS sdk的aar文件添加到工程/libs目录下。然后在build.gradle中增加编译该 aar 的代码:dependencies {    compile fileTree(include: ['*.jar'], dir: 'libs')    compile(name: 'HMSSdk-base-2.5.2.300', ext: 'aar')    compile(name: 'HMSSdk-push-2.5.2.300', ext: 'aar')}repositories {    flatDir{        dirs 'libs'  //this way we can find the .aar file in libs folder    }}

5、配置你的AndroidManifest.xml

<!-- huawei start--><provider android:name="com.huawei.hms.update.provider.UpdateProvider"    android:authorities="com.youpinwallet.ypw.hms.update.provider" android:exported="false"    android:grantUriPermissions="true"></provider><receiver android:name="cn.jpush.android.service.PluginHuaweiPlatformsReceiver">    <intent-filter>        <!-- 必须,用于接收token -->        <action            android:name="com.huawei.android.push.intent.REGISTRATION" /> <!-- 必须,用于接收消息 -->        <action android:name="com.huawei.android.push.intent.RECEIVE" />        <!-- 可选,用于点击通知栏或通知栏上的按钮后触发onEvent回调 -->        <action android:name="com.huawei.android.push.intent.CLICK" />        <!-- 可选,查看push通道是否连接,不查看则不需要 -->        <action android:name="com.huawei.intent.action.PUSH_STATE" />    </intent-filter>    <meta-data android:name="CS_cloud_ablitity" android:value="successRateAnalytics" /></receiver><receiver android:name="com.huawei.hms.support.api.push.PushEventReceiver">    <intent-filter>        <!-- 接收通道发来的通知栏消息,兼容老版本Push -->        <action android:name="com.huawei.intent.action.PUSH" />    </intent-filter></receiver><meta-data android:name="com.huawei.hms.client.appid"    android:value="你的华为APPID"></meta-data><!-- huawei end-->

三、集成小米推送 

1、注册账号应用通过审核 

 

2、在应用服务中>消息推送>立即体验>开启推送


3、配置你的AndroidManifest.xml

<!-- 小米开始--><service android:name="com.xiaomi.push.service.XMJobService" android:enabled="true"    android:exported="false" android:permission="android.permission.BIND_JOB_SERVICE"    android:process=":pushservice" /><service android:name="com.xiaomi.push.service.XMPushService" android:enabled="true"    android:process=":pushservice" /><service android:name="com.xiaomi.mipush.sdk.PushMessageHandler" android:enabled="true"    android:exported="true" /><service android:name="com.xiaomi.mipush.sdk.MessageHandleService" android:enabled="true" /><receiver android:name="com.xiaomi.push.service.receivers.NetworkStatusReceiver"    android:exported="true">    <intent-filter>        <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />        <category android:name="android.intent.category.DEFAULT" />    </intent-filter></receiver><receiver android:name="com.xiaomi.push.service.receivers.PingReceiver"    android:exported="false" android:process=":pushservice">    <intent-filter>        <action android:name="com.xiaomi.push.PING_TIMER" />    </intent-filter></receiver><receiver android:name="cn.jpush.android.service.PluginXiaomiPlatformsReceiver"    android:exported="true">    <intent-filter>        <action android:name="com.xiaomi.mipush.RECEIVE_MESSAGE" />    </intent-filter>    <intent-filter>        <action android:name="com.xiaomi.mipush.MESSAGE_ARRIVED" />    </intent-filter>    <intent-filter>        <action android:name="com.xiaomi.mipush.ERROR" />    </intent-filter></receiver><meta-data android:name="XIAOMI_APPKEY" android:value="MI-XIAOMI_APPKEY" /><meta-data android:name="XIAOMI_APPID" android:value="MI-XIAOMI_APPID" /><!-- 小米结束-->

四、集成魅族推送 

1、注册账号应用通过审核 (时间比较漫长)

2、配置你的AndroidManifest.xml

<!--meizu start--><receiver android:name="cn.jpush.android.service.PluginMeizuPlatformsReceiver">    <intent-filter>        <!-- 接收 push 消息 -->        <action android:name="com.meizu.flyme.push.intent.MESSAGE" />        <!-- 接收 register 消息 -->        <action android:name="com.meizu.flyme.push.intent.REGISTER.FEEDBACK" />        <!-- 接收 unregister 消息-->        <action android:name="com.meizu.flyme.push.intent.UNREGISTER.FEEDBACK" />        <!-- 兼容低版本 Flyme3 推送服务配置 -->        <action android:name="com.meizu.c2dm.intent.REGISTRATION" />        <action android:name="com.meizu.c2dm.intent.RECEIVE" />        <category android:name="您应用的包名"></category>    </intent-filter></receiver><meta-data android:name="MEIZU_APPKEY" android:value="MZ-您的应用对应的魅族的APPKEY" /><meta-data android:name="MEIZU_APPID" android:value="MZ-您的应用对应的魅族的APPID" /><!--meizhu end-->

五、集中测试

所有都集成好像极光对接的人要一份VIP申请登记表,坐等极光工作人员配置好就可以进行测试了

测试:

华为:极光根据 EMUI 系统版本间差异,现采取的方案是 EMUI 4.1 及以上版本,使用 HMS 服务,通知走 HMS 通道;对于 EMUI 4.1 以下版本还是走极光通道

魅族:在flyme5.1.11.1及以上才使用 mzpush,因为之前的版本上 mzpush 的通道并非系统通道

小米:极光集成小米通道在 JPush Android SDK 3.0.3 添加,对应测试的小米 SDK 版本为:3.2.2**

后台杀死进程依旧能接受到推送通知)就可以了