Mobile Platform as a Service:Adapt mPaaS 10.1.68 for Android 13

Google released the official version of Android 13 on August 16, 2022. The mPaaS 10.1.68 baseline is now adapted for this version. Without this adaptation, H5 containers and miniapps cannot enable the UC kernel on Android 13 devices.

Upgrade the SDK

To upgrade the mPaaS SDK, see Add/Upgrade baseline.

Enable the UC kernel

On Android 13, you must use a specific version of the UC kernel and add a configuration to enable it. If you do not perform this adaptation, H5 containers and miniapps on Android 13 will use the system WebView by default. This may cause issues such as blank pages or abnormal API calls.

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

For the Portal & Bundle integration method, also remove the original UC kernel from the SDK. Add the following content to the build.gradle file of the main module (the Portal project):

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

Add a configuration to enable the UC kernel on Android 13

Create a custom_config.json file in the `assets/config` folder, and add the following content:

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

Regression testing

An upgrade to the UC kernel can alter browser attributes, which requires regression testing for dependent services such as H5 containers and miniapps.

Security assurance

When developing an app on the mPaaS frame, be aware that apps using H5 containers or miniapps frequently use JSAPIs. To prevent authentication issues, verify URLs when they are opened or when JSAPIs are used. This ensures that only internal business URLs can be loaded and limits the scope and permissions of JSAPI calls.

1. Configure JSAPI authentication

2. Configure a URL whitelist

Handle custom libraries

When upgrading from an earlier SDK version, such as 10.1.60, to version 10.1.68, you may need to re-customize your custom libraries. For assistance, search for group number 145930007362 to join the DingTalk group and contact the mPaaS technical support.