mPaaS 10.1.68 适配 Android 13

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

注意

请将基线版本升级到 10.1.68.52 或以上。

启用 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
}

mPaaS Inside 和 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 版本,您的定制库可能需要基于新版本进行重新定制,请 提交工单 或联系 mPaaS 支持人员确认。

阿里云首页 移动开发平台 mPaaS 相关技术圈