华为 HMS Core Push 3.0+ 集成小结

      Push 推送拉活一直对应用起着重要作用；目前国内 Android 推送平台并未完全达成一致，小菜应需求尝试接入 华为厂商 Push 并简单记录接入过程中遇到的各类问题；

推送集成

1. 环境搭建

      集成厂商 Push 首先需要配置平台环境，官网介绍足够清晰，其中需要注意的是生成签名证书指纹，官网采用 Windows 环境下生成配置 SHA256，Mac 环境下亦是如此；

1. 生成打包需要的 key 文件；
2. 【终端】-> keytool -list -v -keystore <key 文件> 即可；

3. 将获取的 SHA256 配置在相应位置即可；

2. 获取 Token

      Push Token 在每台设备每个应用都是唯一存在的，但也并非一直不变，再如下情况下可能会变更，所以小菜建议每次使用最新的 Token 进行处理；

      在 EMUI10.0 及以上版本的华为设备上，getToken 接口直接获取 Token，低于该版本时通过 onNewToken 获取 Token，注意 getToken 方法中传递的 Context 必须为 Activity；

private void getToken() {
    new Thread() {
        @Override
        public void run() {
            try {
                String appId = AGConnectServicesConfig.fromContext(FloatWindowActivity.this).getString("client/app_id");
                pushtoken = HmsInstanceId.getInstance(FloatWindowActivity.this).getToken(appId, "HCM");
                if (!TextUtils.isEmpty(pushtoken)) {
                    Log.i(TAG, "get token:" + pushtoken);
                    showLog(pushtoken);
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }.start();
}

@Override
public void onNewToken(String s) {
    super.onNewToken(s);
    Log.i(TAG, "receive token:" + s);
}

3. 透传类消息推送

      集成过推送的朋友都了解，推送分为 通知类消息 和 透传类消息，透传类消息 虽到达率没有 通知类消息 高，但使用更加灵活，小菜简单尝试一下；

      华为透传类消息通过继承的 HmsMessageService 接收，在 onMessageReceived 方法中进行内容的解析，在后台发送时可以设置固定的 key-value 方式也可以设置自定义参数，小菜采用更通用的自定义消息内容方式，组织一个 json 串进行解析；

      需要注意的是，透传类消息通过 onMessageReceived 接收到内容之后并不会展示 Notification，需要我们自行处理；小菜在Android 8.0 适配小博客中有简单介绍，此处不做赘述；

public class HWPushService extends HmsMessageService {
    private static final String TAG = "HWPushService";

    @Override
    public void onNewToken(String s) {
        super.onNewToken(s);
        if (!Empty.check(s)) {
            SpSetting.setHWToken(s);
        }
    }

    @Override
    public void onMessageReceived(RemoteMessage message) {
        if (message.getData().length() > 0) {
            if (message.getData() != null) {
                // 解析 json 并弹出 Notification 或其他
                PushManager.handlePushMessage(getApplicationContext(), message.getData());
            }
        }
    }
}

4. 通知类消息推送

      通知类消息 再集成 SDK 后可以直接使用，到达率较高，可以设置打开首页或其他操作，但使用上并没有那么灵活；通知类消息 发送之后会自动打开 Notification，且送达的时机我们无法获取，其点击事件我们也无法灵活操作；

      小菜尝试多次后，发现可以设置通知动作为打开应用，app 页面为自定义页面，我们可以通过打开新的页面来操作点击事件；

1. 添加 DeepLink 打开页面 Activity；

public class HWNotifyActivity extends BaseActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Intent intent = getIntent();
        if (null != intent) {
            String dataStr = intent.getDataString();
            Log.e("===DeepLink===", dataStr);
            int indexStart = dataStr.indexOf("{");
            int indexEnd = dataStr.lastIndexOf("}")+1;
            String paramsStr = dataStr.substring(indexStart, indexEnd);
            // 解析 json 并处理业务逻辑
        }
    }
}

2. 在 AndroidManifest 中注册 HWNotifyActivity，并自由设置 host/path/scheme 参数；

<activity android:name=".HWNotifyActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data
            android:host="com.ace.ace_demo02"
            android:path="/deeplink"
            android:scheme="pushscheme" />
    </intent-filter>
</activity>

3. 按照 host/path/scheme 配置的参数发送打开 app 页面路径；

5. 通知类消息点击

      小菜在测试 通知类消息 解析时采用两种方式：

1. 根据 intent.getData().getQueryParameter(“params”) 方式获取每个拼接参数；此方法是根据 & 进行区分，但如果小菜测试数据中包含 & 时，无法完全解析；

// 测试数据
pushscheme://com.ace.ace_demo02/deeplink?name=和尚&age=12

pushscheme://com.ace.ace_demo02/deeplink?name=和尚&age=12&url=http://www.baidu.com?name=和尚&age=12

Log.e("===DeepLink===", "==name=="+intent.getData().getQueryParameter("name"));
Log.e("===DeepLink===", "==age=="+intent.getData().getQueryParameter("age"));
Log.e("===DeepLink===", "==url=="+intent.getData().getQueryParameter("url"));

2. 将 params 设置为一个 json 格式体，只解析当前一个参数，获取 json 之后根据业务逻辑进行处理；这样就可以实现和 透传类消息 相同的点击事件类；

// 测试数据
pushscheme://com.ace.ace_demo02/deeplink?params={
  "id": "01",
  "name": "和尚",
  "age": "123",
  "url": "http://www.baidu.com?name=和尚&age=12"
}

int indexStart = dataStr.indexOf("{");
int indexEnd = dataStr.lastIndexOf("}")+1;
String paramsStr = dataStr.substring(indexStart, indexEnd);
JSONObject json_test = getJsonItemInnerConfig(this, paramsStr);
Log.e("===DeepLink===", "==c=name=="+json_test.optString("name"));
Log.e("===DeepLink===", "==c=age=="+json_test.optString("age"));
Log.e("===DeepLink===", "==c=url=="+json_test.optString("url"));

      小菜刚接入华为 HMS Core Push，接入方法简单而实用，其他高级的方式小菜暂未涉及，有待进一步研究，如有错误请多多指导！

来源： 阿策小和尚