本文介绍了用户在使用 mPaaS 10.1.68 版本基线时,需要为 Android 12 进行的适配工作。
谷歌已于 2021 年 10 月 4 日发布 Android 12 正式版。mPaaS 作为基础库,已在 10.1.68 基线上进行了适配。 10.1.68.37 及之后的版本已经完成了对 Android 12 的适配。在 mPaaS 适配之前,在 Android 12 设备上,mPaaS SDK 受到的影响为:H5 容器无法启动 UC 内核。
升级 SDK
使用 接入/升级基线 来升级 mPaaS SDK 。
如果基线版本为 10.1.68,只需升级到最新版本即可。可参考 10.1.68 发布说明。
如果基线版本为 10.1.60 或以下版本,请升级至 10.1.68,并更新至最新版本。
启动 UC 内核
在 Android 12 系统上需要使用特定版本的 UC 内核,并添加配置来开启 UC 内核。若不进行以下适配,在 Android 12 系统上 H5 容器将默认启用系统 WebView。
使用特定版本的 UC 内核
在主 module (Protal&Bundle 接入方式下在 Portal 工程中)的 build.gradle
中的 dependencies
节点下添加依赖:
implementation('com.alipay.android.phone.wallet:nebulaucsdk-build:999.3.22.2.30.211011154625@aar') {
force = true
}
Protal&Bundle 接入方式还需要移除 SDK 中原本的 UC 内核,在主 module (Protal&Bundle 接入方式在 Portal 工程中)的 build.gradle
中添加以下内容:
mpaascomponents {
excludeDependencies = [
"com.alipay.android.phone.wallet:nebulaucsdk-build"
]
}
添加配置在 Android 12 上开启 UC 内核
在 assets 中 config 目录下创建 custom_config.json
文件,并在文件中添加以下内容:
[
{
"value":"{\"h5_enableExternalWebView\":\"YES\",\"h5_externalWebViewSdkVersion\":{\"min\":11,\"max\":31}}",
"key":"h5_webViewConfig"
}
]
回归测试
升级 UC 内核可能会伴随部分浏览器特性而发生改动,请对使用 UC 浏览器的相关业务进行回归测试。
定制库处理
10.1.68 版本各组件并入了定制化的需求,如果您的依赖中包含定制库,则需要按以下情况处理:
如果您是从低版本 SDK(例如 10.1.60)升级至 10.1.68 版本,您的定制库可能需要基于新版本进行重新定制,请搜索群号 41708565 加入钉钉群咨询 mPaaS 支持人员。
如果您已使用 10.1.68 版本,则只需更新部分组件。参见下文的 适配 Android 12 更新的库清单,检查您的定制库是否包含在其中。
如果不包含,您可继续使用该定制库。
如果包含,您的定制库可能需要重新定制,请搜索群号 41708565 加入钉钉群咨询 mPaaS 支持人员。
适配 Android 12 更新的库清单
nebulauc
multimediabiz