All Products
Search
Document Center

Mobile Platform as a Service:mPaaS 10.1.68 upgrade guide

Last Updated:Jul 11, 2024

Based on version 10.1.60, mPaaS 10.1.68 has been updated as follows:

  • The new method of AAR access is closer to the native experience For more information about the AAR access method, see The access method of native AAR.

  • Optimize SDK size of the single component to reduce the size of the general application packs effectively.

  • Split the mini program at the finer granularity allows users to choose according to their needs.

  • Update UC kernel to version 3.0, and provide better performance and higher stability.

Upgrading instructions

Upgrading instructions under the AAR access method

If you have a project using the access method of native AAR, complete upgrading with the following steps.

  1. Complete environment configuration.

    gradle = 6.5 // You need to use 6.5 or later versions
      com.android.tools.build:gradle:4.0.0 //You need to use 4.0.0 or later versions
     com.android.boost.easyconfig:easyconfig:2.8.4
    Important

    If you need to set com.android.tools.build:gradle to 4.2 or above, you need to configure the following in the gradle.properties file: android.enableResourceOptimizations=false.

  2. See the Upgrading the mPaaS plug-in document. Upgrade the plug-in of Android Studio mPaaS to 2.20031016 or later versions.

  3. In the current project of Android Studio, click mPaaS > Baseline Upgrading, select 10.1.68, then click OK.

  4. After upgrading, check the build.gradle file of the root directory. If the ext.mpaas_baseline field is 10.1.68, the upgrading is completed.

Upgrading instructions under the Inside access method

If you have a project based on the Inside access method, complete upgrading with the following steps.

  1. Complete environment configuration.

     gradle = 6.2 // You need to use 4.4 or later versions
     com.android.tools.build:gradle:3.5.3
     com.alipay.android:android-gradle-plugin:3.5.14
     com.android.boost.easyconfig:easyconfig:2.8.4
  2. See the Upgrading the mPaaS plug-in document. Upgrade the plug-in of Android Studio mPaaS to 2.20031016 or later versions.

  3. In the current project of Android Studio, click mPaaS > Baseline Upgrading, select 10.1.68, then click OK.

  4. After upgrading, check the mpaas_packages.json file. If the base_line field is 10.1.68, the upgrading is completed.

Upgrading instructions under the component-based access (Portal&Bundle), namely Portal Bundle

If you have a project with access based on the Portal&Bundle, complete upgrading with the following steps.

  1. Complete environment configuration.

    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. See the Upgrading the mPaaS plug-in document. Upgrade the plug-in of Android Studio mPaaS to 2.20031016 or later versions.

  3. In the current project of Android Studio, click mPaaS > Baseline Upgrading, select 10.1.68, then click OK.

  4. After upgrading, check the mpaas_packages.json file. If the base_line field is 10.1.68, the upgrading is completed.

Upgrade to the latest Gradle plug-in

The version of the Android Gradle Plugin provided by Google is 3.5.x at the moment. mPaaS also provides the plug-in of 3.5.x version as the adapter, which supports the APIs of Google Android Gradle Plugin 3.5.3 and Gradle 6.0. You can upgrade Gradle plug-ins according to your needs. See the Upgrade to the latest Gradle plug-in document.

Change in the component management

After upgrading to 10.1.68, the following components are changed. If you chose these components before, you need to execute operations again 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 and upgrade instructions

HTML5 containers

From 10.1.68 baseline, the usage of custom title bar has been changed. For more information, see Custom title bar(10.1.68).

UC core

Upgrading are made on UC core in 10.1.68 baseline. Retrieve the relevant sections such as the front-end page content completely to avoid the compatibility problems.

Component API changes

HTML5 containers

H5TitleView

Add some interfaces for H5TitleView. For more information, see Custom title bar(10.1.68).

MPNebula

Add interfaces and MicroApplication app parameters.

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

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

Scan

In the Inside or AAR mode, if not accessing to the framework, you need to use the following MPScan method to activate the standard UI of scan:

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

The parameter is in exact match with the original ScanService.