All Products
Search
Document Center

Mobile Platform as a Service:mPaaS 10.1.68 Upgrade Guide

Last Updated:Jan 29, 2026

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.

  • 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 Upgrading, 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 Upgrading, 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 Upgrading, 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 has been changed as optional.

  • MAP has been changed to TINYAPP-MAP TINY MAP.

  • TINYPROGRAM has been changed to TINYAPP.

  • MINIPROGRAM-BLUETOOTH has been deleted, and by default has been combined to TINYAPP and Mini program.

  • MINIPROGRAM-MEDIA has been changed to TINYAPP-MEDIA.

  • TINYVIDEO has been deleted. Mini program videos are not provided at the moment.

  • Add UCCORE UC Kernel. If you need to use UC core such as HTML5 containers or mini programs, add this component manually.

Component usage upgrade guide

HTML5 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

HTML5 Container

HTML5TitleView

New interfaces have been added to HTML5TitleView. 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.