mPaaS 10.1.68 适配 Android 12

本文介绍了用户在使用 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