mPaaS 10.1.68 Upgrade Guide

mPaaS 10.1.68 includes the following updates from version 10.1.60:

• Introduces the AAR connection type for a more native-like experience. For more information about the AAR connection type, see Native AAR connection type.

• Improves support for individual components and includes a demo for a single component. For more information, see Get code samples.

• Optimizes the size of single-component SDKs to reduce the overall application package size.

• Splits Mini Programs into finer granularity, which lets you select components as needed.

• Upgrades the UC kernel to version 3.0 for improved performance and stability.

Upgrade guide

Upgrade guide for the AAR connection type

If you have a project that uses the native AAR connection type, follow these steps to upgrade.

1. Configure the environment.

    gradle = 6.5 // Use version 6.5 or later.
    com.android.tools.build:gradle:4.0.0 // Use version 4.0.0 or later.
    com.android.boost.easyconfig:easyconfig:2.8.4

   Important

   To set com.android.tools.build:gradle to 4.2 or later, configure the gradle.properties file as follows: android.enableResourceOptimizations=false.

2. Upgrade the mPaaS plugin for Android Studio to 2.20031016 or later. For more information, see Update the mPaaS plugin.

3. In your current project in Android Studio, choose mPaaS > Baseline Upgrade, select 10.1.68, and then click OK.

4. After the upgrade is complete, check the mpaas_packages.json file. The upgrade is successful if the base_line field is set to 10.1.68.

Upgrade guide for the Inside connection type

If you have a project that uses the Inside connection type, follow these steps to upgrade.

1. Configure the environment.

    gradle = 6.2 // Use version 6.2 or later.
    com.android.tools.build:gradle:3.5.3
    com.alipay.android:android-gradle-plugin:3.5.18
    com.android.boost.easyconfig:easyconfig:2.8.4

2. Upgrade the mPaaS plugin for Android Studio to 2.20031016 or later. For more information, see Update the mPaaS plugin.

3. In your current project in Android Studio, choose mPaaS > Baseline Upgrade, select 10.1.68, and then click OK.

4. After the upgrade is complete, check the mpaas_packages.json file. The upgrade is successful if the base_line field is set to 10.1.68.

Upgrade guide for the component-based (Portal & Bundle) connection type

If you have a project that uses the Portal&Bundle connection type, follow these steps to upgrade.

1. Configure the environment.

    gradle = 4.4
    com.android.tools.build:gradle:3.0.1
    com.alipay.android:android-gradle-plugin:3.0.0.9.13
    com.android.boost.easyconfig:easyconfig:2.8.4

2. Upgrade the mPaaS plugin for Android Studio to 2.20031016 or later. For more information, see Update the mPaaS plugin.

3. In your current project in Android Studio, choose mPaaS > Baseline Upgrade, select 10.1.68, and then click OK.

4. After the upgrade is complete, check the mpaas_packages.json file. The upgrade is successful if the base_line field is set to 10.1.68.

Upgrade to the latest Gradle plugin

The official Android Gradle Plugin from Google is version 3.5.x. mPaaS provides a compatible 3.5.x plugin that supports the APIs of Google Android Gradle Plugin 3.5.3 and Gradle 6.0. You can upgrade the Gradle plugin as needed. For more information, see Upgrade to the latest Gradle plugin.

Component management changes

After you upgrade to 10.1.68, the following components are changed. If you previously selected any of these components, you must reconfigure them according to the following changes. For more information, see Component management.

• FRAMEWORK is now optional.

• MAP is changed to TINYAPP-MAP Mini Program Map.

• TINYPROGRAM Mini Program is changed to TINYAPP Mini Program.

• MINIPROGRAM-BLUETOOTH Mini Program Bluetooth is deleted. It is merged into TINYAPP Mini Program by default.

• MINIPROGRAM-MEDIA Mini Program Media is changed to TINYAPP-MEDIA Mini Program Media.

• TINYVIDEO Mini Program Video is deleted. The Mini Program video feature is temporarily unavailable.

• Adds the UCCORE UC Kernel component. If you used the UC kernel before, such as in an H5 container or a Mini Program, you must add this component manually.

Component usage upgrade guide

H5 Container

Starting from baseline 10.1.68, the method for using custom title bars has changed. For more information, see Custom navigation bars (10.1.68).

UC Kernel

The UC kernel is upgraded in baseline 10.1.68. You must fully test all relevant parts, such as frontend page content, to avoid compatibility issues.

Component API changes

H5 Container

H5TitleView

New interfaces have been added to H5TitleView. For more information, see Custom navigation bars (10.1.68).

MPNebula

New interfaces are added that include the MicroApplication app parameter.

 /**
 * Starts an online URL.
 *
 * @param app The micro application.
 * @param url The online URL.
 */
public static void startUrl(MicroApplication app, String url)

 /**
 * Starts an online URL.
 *
 * @param app   The micro application.
 * @param url   The online URL.
 * @param param The startup parameters.
 */
public static void startUrl(MicroApplication app, String url, Bundle param)

Scan

In Inside or AAR mode, if you do not use the framework, you can use the following MPScan method to start the standard Scan UI:

startMPaasScanActivity(Activity activity, ScanRequest scanRequest, ScanCallback scanCallback);

The parameters are the same as those for the original ScanService.