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

Google released the official version of Android 12 on October 4, 2021. mPaaS adapted its base libraries in baseline 10.1.68. Versions 10.1.68.37 and later are fully compatible with Android 12. Before this adaptation, the mPaaS SDK was affected on Android 12 devices. The H5 container could not start the UC kernel.

Upgrade the SDK

To upgrade the mPaaS SDK, see Connect to or upgrade a baseline.

• If your baseline version is 10.1.68, simply upgrade to the latest version. For more information, see 10.1.68 release notes.

• If your baseline version is 10.1.60 or earlier, upgrade to 10.1.68 and then upgrade to the latest version.

Start the UC kernel

On Android 12, you must use a specific version of the UC kernel and add a configuration to enable it. Otherwise, the H5 container uses the system WebView by default.

Use a specific version of the UC kernel

Add the following dependency to the dependencies node of the build.gradle file in your main module. For the Portal & Bundle integration method, the main module is the Portal project.

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

For the Portal & Bundle integration method, you must also remove the original UC kernel from the SDK. Add the following code to the build.gradle file in 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 12

In the `config` directory within `assets`, create a custom_config.json file and add the following content:

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

Regression testing

Upgrading the UC kernel might change some browser attributes. Therefore, you must perform regression testing for all services that use the UC browser.

Handle custom libraries

The components in version 10.1.68 have custom requirements. If your dependencies include custom libraries, handle them as follows:

• If you upgrade from an earlier software development kit (SDK) version, such as 10.1.60, to version 10.1.68, your custom libraries may need to be re-customized. For assistance, contact the mPaaS technical support by joining the DingTalk group with the ID 145930007362.

• If you already use version 10.1.68, check if your custom library is included in the List of libraries updated for Android 12 below.

  • If your library is not in the list, you can continue to use it.

  • If your library is in the list, it may need to be re-customized. For assistance, search for the DingTalk group 145930007362 and contact the mPaaS technical support.

List of libraries updated for Android 12

• nebulauc

• multimediabiz