步骤 4 mPaaS 10.2.3 支持无线保镖&蓝盾切换(可选)

背景

无线保镖客户端 SDK 与无线保镖图片搭配作为 mPaaS 的基础依赖能力之一,在 mPaaS 产品中广泛使用,为了进一步提升 mPaaS 产品在各类场景下的兼容性以及满足更高的合规等方面的要求,mPaaS 提供蓝盾能力作为无线保镖能力的替代方案,以支持无线保镖无法满足的场景。

现状

目前 mPaaS 已在 Android 10.2.3.23 及以上的基线版本中完成支持无线保镖切换蓝盾的适配和测试工作,使用 10.1.68 基线或更早的基线请升级到 10.2.3 最新版本。

升级基线

将基线版本升级到 10.2.3.23 及以上。

当前基线为 10.1.68 主基线

请先参考 mPaaS 10.2.3 升级指南 升级到 10.2.3 最新基线并进行相关适配。

当前基线为定制基线

如果您使用的是定制基线,请搜索群号 41708565 加入钉钉群或提交工单咨询对应的售后及技术支持人员,是否可切换到 10.2.3 基线。

升级工具链&切换蓝盾

安装 Android Studio Flamingo | 2022.2.1 及以上版本和 mPaaS 插件 3.0.230609 及以上。

移除无线保镖组件

app modulebuild.gradle 中通过 gradle exclude 移除 securityguard-build 依赖库。

configurations.all {
    exclude group: 'com.alipay.android.phone.thirdparty', module:
            'securityguard-build'
}

添加蓝盾组件

添加蓝盾组件 SDK 依赖。

implementation 'com.mpaas.android:blueshield'//蓝盾SDK依赖

添加日志组件 SDK 依赖。

implementation 'com.mpaas.android:logging'//日志组件SDK依赖

升级 easyconfig 插件依赖。

classpath 'com.android.boost.easyconfig:easyconfig:2.8.0'

生成蓝盾图片(适用于私有云场景)

如果您从 mPaaS 控制台下载的 .config 文件中的 absBase64Code 值为空,则需进行下面 生成蓝盾图片 的操作。

重要

如果您在公有云环境下,从 mPaaS 控制台下载的 .config 文件中的 absBase64Code 值为空,请确认下载前已上传签名正确的 APK 并重新下载。详情请参考 填写配置信息,并上传签名 APK

按下图步骤填写相关信息进行操作即可生成蓝盾图片:

image.png

image.png

上图中的重点输入项说明:

  • Release Apk : 接入 mPaaS 的工程打包出的 release apk 包,需要进行签名。

  • MD5: release apk 包上传之后会自动获取填入,即 apk 包的 public md5 key

  • mPaaS config File: mPaaS 控制台点击下载配置即可下 .config 文件并传入。

  • appSecret:mPaaS 控制台查看,如下图位置。

    image.png

  • 其他项 appId、packageName、outPath 传入以上信息后会自动识别填入。

最后将生成的图片添加到工程的 assets 目录下。

检查蓝盾图片是否配置成功

将 apk 包拖到 Android Studio 中看 apk 的 assets 目录里面是否有 abs_1222.jpg ,如有,则蓝盾图片配置成功。

image.png

配置切换蓝盾

AndroidManifest.xml 文件中添加 meta-data

 <!--value值说明:antGroup是蓝盾-->
        <meta-data
            android:name="mpaas_security_mode"
            android:value="antGroup"/>
说明

mpaas_security_mode 是 RPC 加签使用的工具的选项。

支持蓝盾更新的库清单

  • 移动网关

  • 移动调度中心

  • 数据同步

  • 多媒体

  • 小程序

  • 定位服务

  • 统一存储

  • 部分内部依赖组件

  • 蚂蚁动态卡片

测试验证范围

在完成切换蓝盾后,根据上述变更清单对 App 进行回归测试。