华为厂商通道集成

准备工作

• 已经按照对应版本的接入文档（3.x：Android SDK接入（3.x）；4.x：Android SDK接入（4.x））完成了移动推送SDK的接入。

• 已经在华为开发者联盟注册了应用，如果没注册请登录华为开发者联盟，注册您的应用。然后在应用信息中获取APP ID和Client Secret。

  

• 已经在华为开发者联盟配置SHA256证书指纹。如未配置请参见华为官方文档配置AppGallery Connect。

• 已经在EMAS控制台配置了推送密钥，如未配置，请登录EMAS移动推送控制台，设置您的华为推送密钥（AppID、AppSecret、默认回执ID），设置方法参见配置厂商通道密钥。

  说明

  EMAS控制台配置华为推送参数时需要的AppSecret是华为开发者联盟应用信息的Client Secret。

第一步：将SDK添加到您的应用

dependencyResolutionManagement {
  repositories {
    maven {
      url 'https://developer.huawei.com/repo/'
    }
  }
}

allprojects {
  repositories {
    maven {
      url 'https://developer.huawei.com/repo/'
    }
  }
}

dependencies {
    implementation 'com.aliyun.ams:alicloud-android-third-push:x.x.x'
    implementation 'com.aliyun.ams:alicloud-android-third-push-huawei:x.x.x'
}

第二步：配置使用SDK

<meta-data
	android:name="com.huawei.hms.client.appid"
 	android:value="appid=您的华为AppID" />

// 注册方法会自动判断是否支持华为系统推送，如不支持会跳过注册。
HuaWeiRegister.register(application);

// 注册方法会自动判断是否支持华为系统推送，如不支持会跳过注册。
HuaWeiRegister.register(application)

# 华为通道
-keep class com.huawei.** {*;}
-dontwarn com.huawei.**

第三步：接入验证

CloudPushService pushService = PushServiceFactory.getCloudPushService();
//仅适用于Debug包，正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG);      

val pushService = PushServiceFactory.getCloudPushService()
//仅适用于Debug包，正式包不需要此行
pushService.setLogLevel(CloudPushService.LOG_DEBUG)

第四步：回执配置

请参见厂商通道消息回执最佳实践中的华为配置指引，完成回执配置。

后续步骤

SDK 3.x：厂商通道通知点击后的业务逻辑通过辅助弹窗处理，接入方式请参见辅助弹窗接入（3.x）。

SDK 4.x：仍需配置辅助弹窗 Activity 作为厂商通知点击的中转入口，业务处理改到 MessageReceiver.onNotificationOpened 或 AliyunMessageIntentService.onNotificationOpened，不再实现 onSysNoticeOpened 等旧版业务回调。请按辅助弹窗接入（4.x）完成点击处理。

厂商通道常见问题

• 华为通道注册时返回6003：证书指纹配置不对应，请再次进行“华为厂商通道集成”

• Android端厂商通道和弹窗问题的排查步骤

• Android端厂商通道SDK与其他厂商SDK冲突

• Android端厂商通道收到推送通知后单击通知无法打开相应Activity

• Android端辅助弹窗启动报解析body异常

• 在集成移动推送厂商通道后显示"register not in main process，return"

按需获取厂商 Token（4.x）

从对应厂商扩展包 4.0.0 起，可通过 getToken 读取本地最近一次保存的华为 Token。此接口用于按需查询 Token，属于可选功能。

所属类：com.alibaba.sdk.android.push.huawei.HuaWeiRegister。

接口定义

public static String getToken(Context context);

参数：context（Context），传入有效的应用上下文，推荐使用 ApplicationContext。示例中的 context 为应用已获取的有效 Context。

返回值：String；本地未保存 Token 或 context 为 null 时返回 null，Kotlin 按 String? 处理。此接口读取本地缓存，不刷新 Token。Token 的上报结果请结合 SDK 上报日志和控制台设备信息检查。

代码示例

String token = HuaWeiRegister.getToken(context);
if (token == null || token.isEmpty()) {
    // 尚未保存华为 Token，可在厂商通道取得并保存 Token 后再次查询。
} else {
    // 按业务需要使用已保存的 token。
}

val token: String? = HuaWeiRegister.getToken(context)
if (token.isNullOrEmpty()) {
    // 尚未保存华为 Token，可在厂商通道取得并保存 Token 后再次查询。
} else {
    // 按业务需要使用已保存的 token。
}