mPaaS 10.1.68 适配 Android 13

谷歌已于 2022 年 8 月 16 日发布 Android 13 正式版。mPaaS 作为基础库，已在 10.1.68 基线上进行了相关适配。在 mPaaS 适配之前，在 Android 13 设备上使用 mPaaS SDK 时 H5 容器和小程序将无法启用 UC 内核。

升级 SDK

使用 接入/升级基线 来升级 mPaaS SDK 。

启用 UC 内核

在 Android 13 系统上需要使用特定版本的 UC 内核，并添加配置来开启 UC 内核。若不进行以下适配，在 Android 13 系统上 H5 容器、小程序将默认启用系统 WebView，可能出现部分页面白屏或 API 异常等问题。

implementation('com.alipay.android.phone.wallet:nebulaucsdk-build:999.3.22.2.51.220908200129@aar') {
    force = true
}

Portal&Bundle 接入方式还需要移除 SDK 中原本的 UC 内核，在主 module （Portal&Bundle 接入方式在 Portal 工程中）的 build.gradle 中添加以下内容：

mpaascomponents {
    excludeDependencies = [
            "com.alipay.android.phone.wallet:nebulaucsdk-build"
    ]
}

添加配置在 Android 13 上开启 UC 内核

在 assets 中 config 目录下创建 custom_config.json 文件，并在文件中添加以下内容：

[
  {
    "value":"{\"h5_enableExternalWebView\":\"YES\",\"h5_externalWebViewSdkVersion\":{\"min\":11,\"max\":33}}",
    "key":"h5_webViewConfig"
  },
  {
  "key":"h5_useLastCommitUrl",
  "value":"YES"
  }
]

回归测试

升级 UC 内核可能会伴随部分浏览器特性而发生改动，请对 H5 容器、小程序等使用 UC 浏览器的相关业务进行回归测试。

安全保障

基于 mPaaS 框架开发 App 时，使用 H5 容器/小程序的 App 会较多使用 JSAPI，建议在打开 URL 时以及使用 JSAPI 时对 URL 进行校验，确保是 App 业务内的 URL 才能进行加载打开或限制 URL 的 JSAPI 调用范围和权限，以防因为未鉴权造成问题。

1. 设置 JSAPI 鉴权

2. 设置 URL 白名单

定制库处理

10.1.68 版本各组件并入了定制化的需求，如果您的依赖中包含定制库，则需要按以下情况处理：

如果您是从低版本 SDK（例如 10.1.60）升级至 10.1.68 版本，您的定制库可能需要基于新版本进行重新定制，请搜索群号 41708565 加入钉钉群咨询 mPaaS 支持人员。