设为首页收藏本站
开启辅助访问

厂商通道 SDK 集成指南

 您所在的位置：网站首页 › oppo如何添加相同插件设置 › 厂商通道 SDK 集成指南

厂商通道 SDK 集成指南

2023-12-23 10:50| 来源: 网络整理| 查看: 265

厂商通道 SDK 集成指南

本文旨在指导客户使用自动集成的方式集成各个厂商通道的 SDK，实现离线推送。

SDK 下载详见 资源下载。 SDK 最新版本号参见 更新日志。 前提条件

集成厂商通道 SDK 需要先申请厂商通道相关参数，详情参考 厂商通道参数申请指南 。

小米通道集成指南 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持。（新建 project 默认配置就支持）

buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } 此代码块在浮窗中显示 配置依赖

在应用 module 的 gradle 中 dependencies 节点添加如下代码:

dependencies { //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:xiaomi:5.x.x' } dependencies { //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:xiaomi:5.x.x' } 此代码块在浮窗中显示 配置参数

在应用 module 的 gradle 中 defaultConfig 节点添加如下代码:

小米的参数需要添加前缀 “MI-”。

manifestPlaceholders = [ // 设置manifest.xml中的变量 XIAOMI_APPKEY : "MI-您的应用对应的小米的APPKEY",// 小米平台注册的appkey XIAOMI_APPID : "MI-您的应用对应的小米的APPID", // 小米平台注册的appid ] manifestPlaceholders = [ // 设置manifest.xml中的变量 XIAOMI_APPKEY : "MI-您的应用对应的小米的APPKEY",// 小米平台注册的appkey XIAOMI_APPID : "MI-您的应用对应的小米的APPID", // 小米平台注册的appid ] 此代码块在浮窗中显示 配置代码混淆

如果使用了 proguard，为了防止误报的 warning 导致无法成功编译，需要在配置文件中加入以下内容：

-dontwarn com.xiaomi.push.** -keep class com.xiaomi.push.** { *; } -dontwarn com.xiaomi.push.** -keep class com.xiaomi.push.** { *; } 此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

D/JIGUANG-JPush: [XMPlatformsReceiver] xiao mi push register success D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=Tv3KBknVcnEaXnLe89MGEH3SWVgUYdLDYzJaST30IoIGATl2tv5eu6iuT/PTO0Mj, platform=1}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:Tv3KBknVcnEaXnLe89MGEH3SWVgUYdLDYzJaST30IoIGATl2tv5eu6iuT/PTO0Mj D/JIGUANG-JPush: [XMPlatformsReceiver] xiao mi push register success D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=Tv3KBknVcnEaXnLe89MGEH3SWVgUYdLDYzJaST30IoIGATl2tv5eu6iuT/PTO0Mj, platform=1}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:Tv3KBknVcnEaXnLe89MGEH3SWVgUYdLDYzJaST30IoIGATl2tv5eu6iuT/PTO0Mj 此代码块在浮窗中显示 小米通道测试方法

1.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：AppKey、AppID、AppSecret、DefaultTitle，并点击“启用”。 2.杀死 App 进程后进行推送，如果能够收到推送，则表明厂商通道集成成功。

华为通道集成指南 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持和 agconnect 依赖。

buildscript { repositories { google() mavenCentral() maven {url 'https://developer.huawei.com/repo/'} } } buildscript { dependencies { classpath 'com.huawei.agconnect:agcp:1.9.1.301' } } allprojects { repositories { google() mavenCentral() maven {url 'https://developer.huawei.com/repo/'} } } buildscript { repositories { google() mavenCentral() maven {url 'https://developer.huawei.com/repo/'} } } buildscript { dependencies { classpath 'com.huawei.agconnect:agcp:1.9.1.301' } } allprojects { repositories { google() mavenCentral() maven {url 'https://developer.huawei.com/repo/'} } } 此代码块在浮窗中显示 添加华为插件

在应用 module 的 build.gradle 文件底部添加 apply plugin 代码行，以启用 gradle 插件：

apply plugin: 'com.huawei.agconnect' apply plugin: 'com.huawei.agconnect' 此代码块在浮窗中显示 配置依赖

在应用 module 的 gradle 中 dependencies 节点添加如下代码，可根据华为发布的版本更新选择最新版本:

dependencies { //JPush Android SDK 4.6.0 以上版本更新华为 HMS SDK 版本为:6.3.0.304 及以上版本,接入要求：Android Studio 3.6.1 或更高版本、Android Gradle 插件 3.5.4 或更高版本。 implementation 'com.huawei.hms:push:6.12.0.300' //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:huawei:5.x.x' } dependencies { //JPush Android SDK 4.6.0 以上版本更新华为 HMS SDK 版本为:6.3.0.304 及以上版本,接入要求：Android Studio 3.6.1 或更高版本、Android Gradle 插件 3.5.4 或更高版本。 implementation 'com.huawei.hms:push:6.12.0.300' //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:huawei:5.x.x' } 此代码块在浮窗中显示 配置 agconnect-services.json 文件

参考 厂商通道参数申请指南 获取 agconnect-services.json 文件，并配置到 app 目录下。

配置签名证书

在 build.gradle 中配置在华为后台添加的指纹证书对应的签名。

HMS 服务必须要求 app 签名才能注册成功，可以在终端采用keytool -list -v -keystore keystorefileName 获取对应的指纹证书。

signingConfigs { release { storeFile file("release.keystore")//签名文件的path storePassword "123456" keyAlias "android.keystore" keyPassword "123456" } } buildTypes { release { minifyEnabled true proguardFiles 'proguard-rules.pro' signingConfig signingConfigs.release } debug{ minifyEnabled false signingConfig signingConfigs.release } } signingConfigs { release { storeFile file("release.keystore")//签名文件的path storePassword "123456" keyAlias "android.keystore" keyPassword "123456" } } buildTypes { release { minifyEnabled true proguardFiles 'proguard-rules.pro' signingConfig signingConfigs.release } debug{ minifyEnabled false signingConfig signingConfigs.release } } 此代码块在浮窗中显示 配置代码混淆

如果使用了 proguard，为了防止误报的 warning 导致无法成功编译，需要在配置文件中加入以下内容：

-ignorewarnings -keepattributes *Annotation* -keepattributes Exceptions -keepattributes InnerClasses -keepattributes Signature -keepattributes SourceFile,LineNumberTable -keep class com.hianalytics.android.**{*;} -keep class com.huawei.updatesdk.**{*;} -keep class com.huawei.hms.**{*;} -ignorewarnings -keepattributes *Annotation* -keepattributes Exceptions -keepattributes InnerClasses -keepattributes Signature -keepattributes SourceFile,LineNumberTable -keep class com.hianalytics.android.**{*;} -keep class com.huawei.updatesdk.**{*;} -keep class com.huawei.hms.**{*;} 此代码块在浮窗中显示

如果开发者使用了 AndResGuard，需要在混淆配置文件中加入 AndResGuard 白名单。

"R.string.hms*", "R.string.connect_server_fail_prompt_toast", "R.string.getting_message_fail_prompt_toast", "R.string.no_available_network_prompt_toast", "R.string.third_app_*", "R.string.upsdk_*", "R.layout.hms*", "R.layout.upsdk_*", "R.drawable.upsdk*", "R.color.upsdk*", "R.dimen.upsdk*", "R.style.upsdk*", "R.string.agc*" "R.string.hms*", "R.string.connect_server_fail_prompt_toast", "R.string.getting_message_fail_prompt_toast", "R.string.no_available_network_prompt_toast", "R.string.third_app_*", "R.string.upsdk_*", "R.layout.hms*", "R.layout.upsdk_*", "R.drawable.upsdk*", "R.color.upsdk*", "R.dimen.upsdk*", "R.style.upsdk*", "R.string.agc*" 此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

I/JIGUANG-JPush: [HWPushHelper] get huawei token:IQAAAACy0aL1AABEZ3l2C7jluCGX5XriooCvoOwK9TrjG1MTpH0CD47WPXFcAbtt3DdOeOPvX6d7xfAVctoyaOCGKRllRa-0RBP7WQrYI6SxnOp1GA I/JIGUANG-JPush: [HWPushHelper] isNeedReport:true D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=IQAAAACy0aL1AABEZ3l2C7jluCGX5XriooCvoOwK9TrjG1MTpH0CD47WPXFcAbtt3DdOeOPvX6d7xfAVctoyaOCGKRllRa-0RBP7WQrYI6SxnOp1GA, platform=2}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:IQAAAACy0aL1AABEZ3l2C7jluCGX5XriooCvoOwK9TrjG1MTpH0CD47WPXFcAbtt3DdOeOPvX6d7xfAVctoyaOCGKRllRa-0RBP7WQrYI6SxnOp1GA I/JIGUANG-JPush: [HWPushHelper] get huawei token:IQAAAACy0aL1AABEZ3l2C7jluCGX5XriooCvoOwK9TrjG1MTpH0CD47WPXFcAbtt3DdOeOPvX6d7xfAVctoyaOCGKRllRa-0RBP7WQrYI6SxnOp1GA I/JIGUANG-JPush: [HWPushHelper] isNeedReport:true D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=IQAAAACy0aL1AABEZ3l2C7jluCGX5XriooCvoOwK9TrjG1MTpH0CD47WPXFcAbtt3DdOeOPvX6d7xfAVctoyaOCGKRllRa-0RBP7WQrYI6SxnOp1GA, platform=2}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:IQAAAACy0aL1AABEZ3l2C7jluCGX5XriooCvoOwK9TrjG1MTpH0CD47WPXFcAbtt3DdOeOPvX6d7xfAVctoyaOCGKRllRa-0RBP7WQrYI6SxnOp1GA 此代码块在浮窗中显示 华为通道测试方法

1.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：AppID、AppSecret、DefaultTitle，并点击“启用” 2.杀死 App 进程后进行推送，如果能够收到推送，则表明厂商通道集成成功。

魅族通道集成指南 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持。（新建 project 默认配置就支持）

buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } 此代码块在浮窗中显示 配置依赖

在应用 module 的 gradle 中 dependencies 节点添加如下代码:

dependencies { //厂商版本和JPush SDK版本保持一致 implementation 'cn.jiguang.sdk.plugin:meizu:5.x.x' } dependencies { //厂商版本和JPush SDK版本保持一致 implementation 'cn.jiguang.sdk.plugin:meizu:5.x.x' } 此代码块在浮窗中显示 添加 aar

JPush Android SDK v5.2.2 开始，需要单独引入 魅族 厂商的 aar 。

下载 极光官网 SDK 。

把 jpush-android-xxx-release/third-push/meizu/libs 下的 aar 文件拷贝到应用 module/libs 下。

配置参数

在应用 module 的 gradle 中 defaultConfig 节点添加如下代码:

魅族的参数需要添加前缀 “MZ-”。

manifestPlaceholders = [ // 设置manifest.xml中的变量 MEIZU_APPKEY : "MZ-您的应用对应的魅族的APPKEY", // 魅族平台注册的appkey MEIZU_APPID : "MZ-您的应用对应的魅族的APPID", // 魅族平台注册的appid ] manifestPlaceholders = [ // 设置manifest.xml中的变量 MEIZU_APPKEY : "MZ-您的应用对应的魅族的APPKEY", // 魅族平台注册的appkey MEIZU_APPID : "MZ-您的应用对应的魅族的APPID", // 魅族平台注册的appid ] 此代码块在浮窗中显示 配置代码混淆

如果使用了 proguard，为了防止误报的 warning 导致无法成功编译，需要在配置文件中加入以下内容：

-dontwarn com.meizu.cloud.** -keep class com.meizu.cloud.** { *; } -dontwarn com.meizu.cloud.** -keep class com.meizu.cloud.** { *; } 此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=DDI5c060475064d447b40670206756d73605705037205, platform=3}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:DDI5c060475064d447b40670206756d73605705037205 D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=DDI5c060475064d447b40670206756d73605705037205, platform=3}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:DDI5c060475064d447b40670206756d73605705037205 此代码块在浮窗中显示 魅族厂商测试方法

1.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：AppKey、AppID、AppSecret、DefaultTitle，并点击“启用”。 2.杀死 App 进程后进行推送，如果能够收到推送，则表明厂商通道集成成功。

vivo 通道集成指南 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持。（新建 project 默认配置就支持）

buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } 此代码块在浮窗中显示 配置依赖

在应用 module 的 gradle 中 dependencies 节点添加如下代码:

dependencies{ //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:vivo:5.x.x' } //特别说明：如果您使用的是 JPush Android SDK v5.2.0 版本，你需要按照如下写法进行 dependencies{ implementation 'cn.jiguang.sdk.plugin:vivo:5.2.0.a' } dependencies{ //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:vivo:5.x.x' } //特别说明：如果您使用的是 JPush Android SDK v5.2.0 版本，你需要按照如下写法进行 dependencies{ implementation 'cn.jiguang.sdk.plugin:vivo:5.2.0.a' } 此代码块在浮窗中显示 配置参数

在应用 module 的 gradle 中 defaultConfig 节点添加如下代码:

manifestPlaceholders=[ VIVO_APPKEY : "您的应用对应的VIVO的APPKEY", // VIVO平台注册的appkey VIVO_APPID : "您的应用对应的VIVO的APPID", // VIVO平台注册的appid ] manifestPlaceholders=[ VIVO_APPKEY : "您的应用对应的VIVO的APPKEY", // VIVO平台注册的appkey VIVO_APPID : "您的应用对应的VIVO的APPID", // VIVO平台注册的appid ] 此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

D/JIGUANG-JPush: [PushMessageReceiver] Vivo regId:15723354120401574713525 D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=15723354120401574713525, platform=5}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:15723354120401574713525 D/JIGUANG-JPush: [PushMessageReceiver] Vivo regId:15723354120401574713525 D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=15723354120401574713525, platform=5}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:15723354120401574713525 此代码块在浮窗中显示 配置代码混淆

如果使用了 proguard，为了防止误报的 warning 导致无法成功编译，需要在配置文件中加入以下内容：

-dontwarn com.vivo.push.** -keep class com.vivo.push.**{*; } -keep class com.vivo.vms.**{*; } -dontwarn com.vivo.push.** -keep class com.vivo.push.**{*; } -keep class com.vivo.vms.**{*; } 此代码块在浮窗中显示 vivo 通道测试方法

1.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：AppKey、AppID、AppSecret、DefaultTitle，并点击“启用”。 2.杀死 App 进程后进行推送，如果能够收到推送，则表明厂商通道集成成功。

若 vivo 未上架，推送测试时需要在 vivo 推送平台添加测试设备，并且只能通过 API 指定推送参数 push_mode 进行下发。

"third_party_channel": { "vivo": { "distribution": "ospush", "classification": 1, "push_mode": 1//可选，2020/09/21 新增，对应 vivo 的 pushMode 字段,值为int 类型，值分别是：“0”表示正式推送；“1”表示测试推送，不填默认为0 } } "third_party_channel": { "vivo": { "distribution": "ospush", "classification": 1, "push_mode": 1//可选，2020/09/21 新增，对应 vivo 的 pushMode 字段,值为int 类型，值分别是：“0”表示正式推送；“1”表示测试推送，不填默认为0 } } 此代码块在浮窗中显示 OPPO 通道集成指南 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持。（新建 project 默认配置就支持）

buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } buildscript { repositories { mavenCentral() } } allprojects { repositories { mavenCentral() } } 此代码块在浮窗中显示 添加 aar

JPush Android SDK v4.6.0 开始，需要单独引入 OPPO 厂商的 aar 。

注意：3.1.0 需使用 JPush SDK 4.8.1 及以上的版本。

下载 极光官网 SDK 。 把 jpush-android-xxx-release/third-push/oppo/libs 下的 aar 文件拷贝到应用 module/libs 下。

配置依赖

在应用 module 的 gradle 中 dependencies 节点添加如下代码:

dependencies{ //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:oppo:5.x.x' //引入 libs 中的 aar，如果项目中有此依赖不需要重复引用 implementation fileTree(include: ['*.jar','*.aar'], dir: 'libs') //OPPO 3.1.0 aar 及其以上版本需要添加以下依赖 implementation 'com.google.code.gson:gson:2.6.2' implementation 'commons-codec:commons-codec:1.6' implementation 'androidx.annotation:annotation:1.1.0' } dependencies{ //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:oppo:5.x.x' //引入 libs 中的 aar，如果项目中有此依赖不需要重复引用 implementation fileTree(include: ['*.jar','*.aar'], dir: 'libs') //OPPO 3.1.0 aar 及其以上版本需要添加以下依赖 implementation 'com.google.code.gson:gson:2.6.2' implementation 'commons-codec:commons-codec:1.6' implementation 'androidx.annotation:annotation:1.1.0' } 此代码块在浮窗中显示 配置参数

在应用 module 的 gradle 中 defaultConfig 节点添加如下代码:

OPPO 的参数需要添加前缀 “OP-”。

manifestPlaceholders=[ OPPO_APPKEY : "OP-您的应用对应的OPPO的APPKEY", // OPPO平台注册的appkey OPPO_APPID : "OP-您的应用对应的OPPO的APPID", // OPPO平台注册的appid OPPO_APPSECRET: "OP-您的应用对应的OPPO的APPSECRET"//OPPO平台注册的appsecret ] manifestPlaceholders=[ OPPO_APPKEY : "OP-您的应用对应的OPPO的APPKEY", // OPPO平台注册的appkey OPPO_APPID : "OP-您的应用对应的OPPO的APPID", // OPPO平台注册的appid OPPO_APPSECRET: "OP-您的应用对应的OPPO的APPSECRET"//OPPO平台注册的appsecret ] 此代码块在浮窗中显示 配置代码混淆

如果使用了 proguard，为了防止误报的 warning 导致无法成功编译，需要在配置文件中加入以下内容：

-dontwarn com.coloros.mcsdk.** -keep class com.coloros.mcsdk.** { *; } -dontwarn com.heytap.** -keep class com.heytap.** { *; } -dontwarn com.mcs.** -keep class com.mcs.** { *; } -dontwarn com.coloros.mcsdk.** -keep class com.coloros.mcsdk.** { *; } -dontwarn com.heytap.** -keep class com.heytap.** { *; } -dontwarn com.mcs.** -keep class com.mcs.** { *; } 此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

D/JIGUANG-JPush: [OPushCallback] OPush registerID is OnePlus_CN_0e3c2f966c9d01d4e2423cbc9e7598b6 D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=OnePlus_CN_0e3c2f966c9d01d4e2423cbc9e7598b6, platform=4}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:OnePlus_CN_0e3c2f966c9d01d4e2423cbc9e7598b6 D/JIGUANG-JPush: [OPushCallback] OPush registerID is OnePlus_CN_0e3c2f966c9d01d4e2423cbc9e7598b6 D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=OnePlus_CN_0e3c2f966c9d01d4e2423cbc9e7598b6, platform=4}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:OnePlus_CN_0e3c2f966c9d01d4e2423cbc9e7598b6 此代码块在浮窗中显示 OPPO 通道测试方法

1.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：AppKey、AppID、AppSecret、MasterSecret/AppServerSecret、DefaultTitle，并点击“启用”。 2.杀死 App 进程后进行推送，如果能够收到推送，则表明厂商通道集成成功。

若应用未上架，需要在 OPPO 开放平台申请推送测试权限，每个应用每天可以推送1000条公信通道消息。

FCM 通道集成指南 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持和 google-services 依赖。

buildscript { repositories { mavenCentral() } dependencies { classpath 'com.google.gms:google-services:4.3.8' } } allprojects { repositories { mavenCentral() maven { url "https://maven.google.com" } } } buildscript { repositories { mavenCentral() } dependencies { classpath 'com.google.gms:google-services:4.3.8' } } allprojects { repositories { mavenCentral() maven { url "https://maven.google.com" } } } 此代码块在浮窗中显示 添加 FCM 插件

在应用 module 的 build.gradle 文件底部添加 apply plugin 代码行，以启用 gradle 插件：

apply plugin: 'com.google.gms.google-services' apply plugin: 'com.google.gms.google-services' 此代码块在浮窗中显示 配置依赖

在应用 module 的 gradle 中 dependencies 节点添加如下代码:

dependencies { //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:fcm:5.x.x' implementation 'com.google.firebase:firebase-messaging:23.0.5' } dependencies { //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:fcm:5.x.x' implementation 'com.google.firebase:firebase-messaging:23.0.5' } 此代码块在浮窗中显示 配置 google-services.json文件

参考 厂商通道参数申请指南 获取 google-services.json 文件，并配置到 app 目录下。

配置 FCM 通知图标

在 AndroidManifest.xml 中增加如下配置来设置 FCM 通知图标。

此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

D/JIGUANG-JPush: [FCMPushHelper] fcm token is success dj793yH_RO6FqNyKImQJYV:APA91bExj3PSVv50pwtl83LXVeB_HKOCSkyB6qCE12TIwIRl-RKiqCfXjvCshcqVrqn_8htlNBa8_A_8ixq7YIxfrloxig2BryZPCkunyx_z2drz0L-C2K8R7J8Yrojs61WCsF-BZj8h D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=dj793yH_RO6FqNyKImQJYV:APA91bExj3PSVv50pwtl83LXVeB_HKOCSkyB6qCE12TIwIRl-RKiqCfXjvCshcqVrqn_8htlNBa8_A_8ixq7YIxfrloxig2BryZPCkunyx_z2drz0L-C2K8R7J8Yrojs61WCsF-BZj8h, platform=8}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:dj793yH_RO6FqNyKImQJYV:APA91bExj3PSVv50pwtl83LXVeB_HKOCSkyB6qCE12TIwIRl-RKiqCfXjvCshcqVrqn_8htlNBa8_A_8ixq7YIxfrloxig2BryZPCkunyx_z2drz0L-C2K8R7J8Yrojs61WCsF-BZj8h D/JIGUANG-JPush: [FCMPushHelper] fcm token is success dj793yH_RO6FqNyKImQJYV:APA91bExj3PSVv50pwtl83LXVeB_HKOCSkyB6qCE12TIwIRl-RKiqCfXjvCshcqVrqn_8htlNBa8_A_8ixq7YIxfrloxig2BryZPCkunyx_z2drz0L-C2K8R7J8Yrojs61WCsF-BZj8h D/JIGUANG-JPush: [ActionHelper] doAction:third_action D/JIGUANG-JPush: [ThirdPushManager] doAction,action:action_register_token,bundle:Bundle[{third_key_action=action_register_token, token=dj793yH_RO6FqNyKImQJYV:APA91bExj3PSVv50pwtl83LXVeB_HKOCSkyB6qCE12TIwIRl-RKiqCfXjvCshcqVrqn_8htlNBa8_A_8ixq7YIxfrloxig2BryZPCkunyx_z2drz0L-C2K8R7J8Yrojs61WCsF-BZj8h, platform=8}],enable:true I/JIGUANG-JPush: [ThirdPushManager] uploadRegID regid:dj793yH_RO6FqNyKImQJYV:APA91bExj3PSVv50pwtl83LXVeB_HKOCSkyB6qCE12TIwIRl-RKiqCfXjvCshcqVrqn_8htlNBa8_A_8ixq7YIxfrloxig2BryZPCkunyx_z2drz0L-C2K8R7J8Yrojs61WCsF-BZj8h 此代码块在浮窗中显示 FCM 通道测试方法

1.测试前置条件

手机系统有 GooglePlay 服务且版本不低于17.3.4。 测试需要挂海外节点的VPN，手机网络可以正常访问谷歌。 若使用国内手机测试，只能退到后台测试，不能关闭后台，国内厂商对系统做了调整，关后台会杀进程。 删除 pushservice 多进程配置。

2.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：App Secret，并点击“启用”。 3.若在国内测试，需要在初始化之后设置国家码。

public class ExampleApplication extends Application { @Override public void onCreate() { super.onCreate(); JPushInterface.setDebugMode(true); // 调整点一：初始化代码前增加setAuth调用 boolean isPrivacyReady; // app根据是否已弹窗获取隐私授权来赋值 if(!isPrivacyReady){ JCollectionAuth.setAuth(context, false); // 后续初始化过程将被拦截 } JPushInterface.init(); JCoreInterface.testCountryCode("us"); // 调整点二：隐私政策授权获取成功后调用 JCollectionAuth.setAuth(context, true); //如初始化被拦截过，将重试初始化过程 } } public class ExampleApplication extends Application { @Override public void onCreate() { super.onCreate(); JPushInterface.setDebugMode(true); // 调整点一：初始化代码前增加setAuth调用 boolean isPrivacyReady; // app根据是否已弹窗获取隐私授权来赋值 if(!isPrivacyReady){ JCollectionAuth.setAuth(context, false); // 后续初始化过程将被拦截 } JPushInterface.init(); JCoreInterface.testCountryCode("us"); // 调整点二：隐私政策授权获取成功后调用 JCollectionAuth.setAuth(context, true); //如初始化被拦截过，将重试初始化过程 } } 此代码块在浮窗中显示

4.在极光后台查看推送的记录是 FCM 通道还是极光通道。

华硕厂商通道 功能描述

集成厂商通道前请确保正确集成了极光 JPush 服务。

华硕系统通道功能已经深度嵌入到极光现有JPush SDK。

如果使用自动集成，开发者无需额外集成工作，只要使用的是 Android JPush SDK v3.5.6 及其以上版本，都自动支持。 如果使用手动集成，需要在配置清单中添加 AsusPushMessageReceiver：

在华硕设备上 JPush 通道和华硕通道共存。

华硕通道初始化后，JPush 平台已经支持的功能全部支持，推送和对接都通过极光平台进行，使用方式按照极光集成步骤来即可，开发者不需要额外对接其它平台。

华硕通道开启方法

进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，点击“启用”。

注： 极光根据华硕系统版本间差异，现采取的方案是支持使用华硕服务系统，通知走华硕通道；对于不支持的机型或系统还是走极光通道。

华硕支持机型和系统说明方式 手机机型 安卓版本 系统版本 ROG2 Android 9 16.0640.1910.8 ROG3 android 10 17.0823.2007.23 ROG5 android 11 18.0810.2011.30 ROG5s android 11 18.1220.2105.29 ROG6 android 12 32.2810.2209.195 ROG6天玑版 android 12 31.0840.0840.42 荣耀通道集成指南 使用限制 设备要求：荣耀设备 Magic UI 5.0+ ，不符合系统版本要求的设备将会注册华为通道。 添加 Honor SDK 到项目中 在 third-push 目录下找到 honor 目录，从 libs 中拷贝其中的 aar 包至工程的 libs 目录下。 aar 包说明： HiPushSdk-vxxx.aar : honor 推送包 配置 mavenCentral 支持

在 Project 根目录的主 gradle 中配置 mavenCentral 支持。（新建 project 默认配置就支持）

buildscript { repositories { ... mavenCentral() ... } } allprojets { repositories { ... mavenCentral() ... } } buildscript { repositories { ... mavenCentral() ... } } allprojets { repositories { ... mavenCentral() ... } } 此代码块在浮窗中显示 添加 aar

JPush Android SDK v4.7.0 开始，需要引入荣耀厂商 aar 。

下载 极光官网 SDK 。 把 jpush-android-xxx-release/third-push/honor/libs 下的 aar 文件拷贝到应用 module/libs 下。

配置参数和依赖

在项目 module 的 build.gradle 中添加如下代码:

defaultConfig { ... manifestPlaceholders = [ ... HONOR_APPID : "您的应用对应的Honor的APP ID", // Honor平台注册的APP ID ... ] ... } dependencies { ... //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:honor:5.x.x' //引入 libs 中的 aar，如果项目中有此依赖不需要重复引用 implementation fileTree(include: ['*.jar','*.aar'], dir: 'libs') ... } defaultConfig { ... manifestPlaceholders = [ ... HONOR_APPID : "您的应用对应的Honor的APP ID", // Honor平台注册的APP ID ... ] ... } dependencies { ... //厂商版本和 JPush SDK 版本保持一致 implementation 'cn.jiguang.sdk.plugin:honor:5.x.x' //引入 libs 中的 aar，如果项目中有此依赖不需要重复引用 implementation fileTree(include: ['*.jar','*.aar'], dir: 'libs') ... } 此代码块在浮窗中显示

注1：极光集成荣耀通道在 JPush Android SDK 4.7.0 添加，对应测试的荣耀 SDK 版本为：HiPushSdk-v6.0.4.101-release.aar、HiPushSdkCommon-v6.0.4.101-release.aar。

注2：JPush Android SDK 4.8.1 升级荣耀 SDK 版本，对应版本为：HiPushSdk-6.0.4.200.aar、HiPushSdkCommon-6.0.4.200.aar。

注3：极光集成荣耀通道在 JPush Android SDK 4.8.3 添加，对应测试的荣耀 SDK 版本为：HiPushSdk-v7.0.1.103.aar(注意荣耀 SDK 只保留：HiPushSdk，原来的 HiPushSdkCommon 需要删掉)。

注4： 荣耀 Push SDK 的官方文档。

配置签名证书

在 build.gradle 中配置在荣耀后台添加的指纹证书对应的签名。

荣耀服务必须要求 app 签名才能注册成功。 可以在终端采用 keytool -list -v -keystore 获取对应的指纹证书。 如果没有签名文件或密钥口令，也可以在终端采用 keytool -list -printcert -jarfile < Apk 文件的绝对路径> 获取对应的指纹证书。 signingConfigs { release { storeFile file("release.keystore")//签名文件的path storePassword "123456" keyAlias "android.keystore" keyPassword "123456" } } buildTypes { release { minifyEnabled true proguardFiles 'proguard-rules.pro' signingConfig signingConfigs.release } debug{ minifyEnabled false signingConfig signingConfigs.release } } signingConfigs { release { storeFile file("release.keystore")//签名文件的path storePassword "123456" keyAlias "android.keystore" keyPassword "123456" } } buildTypes { release { minifyEnabled true proguardFiles 'proguard-rules.pro' signingConfig signingConfigs.release } debug{ minifyEnabled false signingConfig signingConfigs.release } } 此代码块在浮窗中显示 集成结果判断

若集成成功，日志显示如下：

[HonorPushHelper] get honor token:s18069ps301291893q1ssro2o40s1630-n262n542r9669q62o83s390306179rro-775875632-654-6105326555582-PA-0052993947080949113-5 [HonorPushHelper] get honor token:s18069ps301291893q1ssro2o40s1630-n262n542r9669q62o83s390306179rro-775875632-654-6105326555582-PA-0052993947080949113-5 此代码块在浮窗中显示 配置代码混淆

如果使用了 proguard，为了防止误报的 warning 导致无法成功编译，需要在配置文件中加入以下内容：

-ignorewarnings -keepattributes *Annotation* -keepattributes Exceptions -keepattributes InnerClasses -keepattributes Signature -keepattributes SourceFile,LineNumberTable -keep class com.hihonor.push.**{*;} -ignorewarnings -keepattributes *Annotation* -keepattributes Exceptions -keepattributes InnerClasses -keepattributes Signature -keepattributes SourceFile,LineNumberTable -keep class com.hihonor.push.**{*;} 此代码块在浮窗中显示 荣耀通道测试方法

1.进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，填写参数：App ID、Client ID、Client Secrect、App Secret，并点击“启用”。

2.杀死 App 进程后进行推送，如果能够收到推送，则表明厂商通道集成成功。



【本文地址】


今日新闻

推荐新闻

CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3