All Products
Search
Document Center

Mobile Platform as a Service:Environment configuration for the component-based method

Last Updated:Feb 10, 2026

This topic describes how to configure the development environment on different operating systems before developing client applications.

Before developing a client, you must configure your development environment:

Configure the Windows development environment

Follow these instructions to configure the Windows development environment.

Configure the Java 8 environment

The mPaaS framework supports only Java Development Kit (JDK) 8 and later.

  1. Download and install JDK 8.

  2. Set the JAVA_HOME environment variable and add its bin folder to the PATH environment variable.

  3. After the configuration is complete, run the java -version command. The JDK version information appears: java_version_cmd.png

Configure the Gradle 4.4 environment

The mPaaS framework supports only Gradle 4.4.

Use Gradle Wrapper (recommended)

  1. If your project already uses Gradle Wrapper for builds, change the version number to 4.4 in the /gradle/wrapper/gradle.properties file.

  2. If your project does not use Gradle Wrapper, ensure that your global Gradle version is 4.4. Then, run the gradle wrapper --gradle-version=4.4 command to install a Gradle wrapper. You can then build your project using ./gradlew. This method minimizes changes to your development environment.

Use standalone Gradle

  1. Download

  2. Unzip the .zip package. Set the GRADLE_HOME environment variable to the unzipped path and add its bin folder to the PATH environment variable.

  3. After the configuration is complete, run the gradle -v command. The Gradle version information appears: gradle_v_cmd.png

Install and configure Android Studio

Install Android Studio

The latest mPaaS plug-in supports only Android Studio 4.0 and later.

  • For Android Studio downloads, see Android Developers.

  • See the installation guide.

  • If you used an earlier version of Android Studio with the mPaaS plug-in installed, you must upgrade the mPaaS plug-in to the latest version after you upgrade Android Studio to 4.0 or later. For more information, see Update the mPaaS plug-in.

  • If you need an mPaaS plug-in that supports Android Studio versions earlier than 4.0, download the offline installation package and perform an offline installation. For more information about offline installation, see Install the mPaaS plug-in offline.

Install the Android SDK

Install the Android SDKs for API Level 19 and 26.

  1. In Android Studio, choose File > Settings to open the Settings dialog box.

  2. In the Android SDK dialog box, select the SDKs for API Level 19 and 26, and then click Apply to install them. install_android_sdk

Install the mPaaS plug-in

For more information about installing the mPaaS plug-in, see Install the mPaaS plug-in.

Configure the Gradle build tool

Ensure that your project uses the Gradle Wrapper for builds.

  1. In Android Studio, choose File > Settings to open the Settings dialog box.

  2. In the Gradle dialog box, select Use default gradle wrapper and click Apply. gradle

Configure the macOS development environment

Follow these instructions to configure the macOS development environment.

Configure the Java 8 environment

The mPaaS framework supports only JDK 8 and later.

  1. Download and install JDK 8.

  2. Set the JAVA_HOME environment variable and add its bin folder to the PATH environment variable.

  3. After the configuration is complete, run the java -version command. The JDK version information appears: java_version_cmd.png

Configure the Gradle 4.4 environment

The mPaaS framework supports only Gradle 4.4.

Use Gradle Wrapper (recommended)

  1. If your project already uses Gradle Wrapper for builds, change the version number to 4.4 in the /gradle/wrapper/gradle.properties file.

  2. If your project does not use Gradle Wrapper, ensure that your global Gradle version is 4.4. Then, run the gradle wrapper --gradle-version=4.4 command to install a Gradle wrapper. You can then build your project using ./gradlew. This method minimizes changes to your development environment.

Use standalone Gradle

  1. Download

  2. Unzip the .zip package. Set the GRADLE_HOME environment variable to the unzipped path and add its bin folder to the PATH environment variable.

  3. After the configuration is complete, run the gradle -v command. The Gradle version information appears:

    macOS 信息截图

Install and configure Android Studio

Install Android Studio

The latest mPaaS plug-in supports only Android Studio 4.0 and later.

  • For Android Studio downloads, see Android Developers.

  • See the installation guide.

  • If you used an earlier version of Android Studio with the mPaaS plug-in installed, you must upgrade the mPaaS plug-in to the latest version after you upgrade Android Studio to 4.0 or later. For more information, see Update the mPaaS plug-in.

  • If you need an mPaaS plug-in that supports Android Studio versions earlier than 4.0, download the offline installation package and perform an offline installation. For more information about offline installation, see Install the mPaaS plug-in offline.

Install the Android SDK

Install the Android SDKs for API Level 19 and 26.

  1. In Android Studio, choose Android Studio > Preferences to open the Preferences dialog box.

  2. In the Android SDK dialog box, select the SDKs for API Level 19 and 26, and then click Apply to install them. install_android_sdk

Install the mPaaS plug-in

For more information about installing the mPaaS plug-in, see Install the mPaaS plug-in.

Configure the Gradle build tool

Ensure that your project uses the Gradle Wrapper for builds.

  1. In Android Studio, open any Android project.

  2. Open the Preferences dialog box.

  3. In the Gradle dialog box, select Use default gradle wrapper and click Apply. use_gradle_wrapper.png

Configure the Linux development environment

This section describes how to configure the development environment on Linux. Note that Linux has many distributions and these instructions apply only to CentOS and Ubuntu.

Configure the Java 8 environment

The mPaaS framework supports only JDK 8 and later.

  1. Download and install JDK 8.

  2. Set the JAVA_HOME environment variable and add its bin folder to the PATH environment variable.

  3. After the configuration is complete, run the java -version command. The JDK version information appears: java_version_cmd.png

Configure the Gradle 4.4 environment

Use Gradle Wrapper (recommended)

  1. If your project already uses Gradle Wrapper for builds, change the version number to 4.4 in the /gradle/wrapper/gradle.properties file.

  2. If your project does not use Gradle Wrapper, ensure that your global Gradle version is 4.4. Then, run the gradle wrapper --gradle-version=4.4 command to install a Gradle wrapper. You can then build your project using ./gradlew. This method minimizes changes to your development environment.

Use standalone Gradle

  1. Download

  2. Unzip the .zip package. Set the GRADLE_HOME environment variable to the unzipped path and add its bin folder to the PATH environment variable.

  3. After the configuration is complete, run the gradle -v command. The Gradle version information appears.

Install 32-bit compatibility libraries

Linux distributions such as CentOS 6, CentOS 7, and Ubuntu do not include the ia32-lib library by default. You must install 32-bit compatibility libraries on all 64-bit Linux systems. For installation instructions, see android-sdk.

Ubuntu:
sudo apt-get install zlib1g:i386

CentOS:
yum install libstdc++.i686

Install and configure Android Studio

Install Android Studio

The latest mPaaS plug-in supports only Android Studio 4.0 and later.

  • For Android Studio downloads, see Android Developers.

  • See the installation guide.

  • If you used an earlier version of Android Studio with the mPaaS plug-in installed, you must upgrade the mPaaS plug-in to the latest version after you upgrade Android Studio to 4.0 or later. For more information, see Update the mPaaS plug-in.

  • If you need an mPaaS plug-in that supports Android Studio versions earlier than 4.0, download the offline installation package and perform an offline installation. For more information about offline installation, see Install the mPaaS plug-in offline.

Install the Android SDK

Install the Android SDKs for API Level 19 and 26.

  1. In Android Studio, choose File > Settings to open the Settings dialog box.

  2. In the Android SDK dialog box, select the SDKs for API Level 19 and 26, and then click Apply to install them. install_android_sdk.png

Install the mPaaS plug-in

For more information about installing the mPaaS plug-in, see Install the mPaaS plug-in.

Configure the Gradle build tool

Ensure that your project uses the Gradle Wrapper for builds.

  1. In Android Studio, open any Android project.

  2. Open the Settings dialog box.

  3. In the Gradle dialog box, select Use default gradle wrapper and click Apply. use_gradle_wrapper.png