全部產品
Search
文件中心

:組件化接入方式下的環境配置

更新時間:Jul 13, 2024

本文介紹了在不同系統下開發用戶端應用前所需要完成的環境配置。

在進行用戶端開發之前,您首先需要配置開發環境:

配置 Windows 開發環境

參考以下說明配置 Windows 開發環境。

配置 Java 8 環境

mPaaS 架構只支援 JDK 8 及以上版本

  1. 下載並安裝 JDK 8

  2. 配置 JAVA_HOME 環境變數,並將 JAVA_HOME 下的 bin 路徑添加到 PATH 環境變數中。

  3. 正確配置後,在命令列執行 java -version 命令,您將看到 JDK 版本等資訊: java_version_cmd.png

配置 Gradle 4.4 環境

mPaaS 架構只支援 Gradle 4.4

使用 Gradle Wrapper(推薦)

  1. 如果您的專案原先已經使用 Gradle Wrapper 進行構建,則建議在專案目錄/gradle/wrapper/gradle.properties 下把版本號碼修改為 4.4

  2. 如果您的專案沒有使用 Gradle Wrapper,建議先使用全域的 Gradle(4.4)版本,然後調用 gradle wrapper --gradle-version=4.4 安裝一個 gradle wrapper。完成上述步驟後,您只需要使用 ./gradlew 的形式構建,這樣的方式能最小的影響您的開發環境。

使用獨立 gradle

  1. 下載 。

  2. 解壓 .zip 包,然後將解壓路徑配置為 GRADLE_HOME 環境變數,並將 GRADLE_HOME 下的 bin 路徑添加到 PATH 環境變數中。

  3. 正確配置後,在命令列執行 gradle -v 命令,您將看到 Gradle 版本等資訊: gradle_v_cmd.png

安裝並配置 Android Studio

安裝 Android Studio

最新版 mPaaS 外掛程式僅支援 4.0 及以上版本的 Android Studio。

  • 關於 Android Studio 下載,請參見 Android Developers

  • 安裝指南

  • 如果您之前使用的是低版本 Android Studio 並已經安裝了 mPaaS 外掛程式,那麼在您從低版本 Android Studio 升級至 4.0 或更新版本的 Android Studio 之後,您只需要升級 mPaaS 外掛程式至最新版本即可。詳情請參見 更新 mPaaS 外掛程式

  • 如果您需要支援 4.0 之前版本 Android Studio 的 mPaaS 外掛程式,請在下載離線安裝包後,採用離線安裝形式安裝。更多關於離線安裝的指導說明,請參考 離線安裝 mPaaS 外掛程式

安裝 Android SDK

您需要安裝 API Level 為 1926 的 Android SDK。

  1. 在 Android Studio 中,通過 File > Settings 開啟設定對話方塊。

  2. 如下圖所示,在 Android SDK 對話方塊中,勾選 API Level 為 1926 的 SDK,然後點擊 Apply 按鈕進行安裝: install_android_sdk

安裝 mPaaS 外掛程式

關於更多安裝 mPaaS 外掛程式的資訊,請參見 安裝 mPaaS 外掛程式

配置 Gradle 構建工具

您需要確保工程構建時使用 Gradle Wrapper

  1. 在 Android Studio 中,通過 File > Settings 開啟設定對話方塊。

  2. 如下圖所示,在 Gradle 對話方塊中,勾選 Use default gradle wrapper,然後點擊 Apply 按鈕: gradle

配置 macOS 開發環境

按照以下描述配置 macOS 開發環境。

配置 Java 8 環境

mPaaS 架構只支援 JDK 8 及以上版本

  1. 下載並安裝 JDK 8

  2. 配置 JAVA_HOME 環境變數,並將 JAVA_HOME 下的 bin 路徑添加到 PATH 環境變數中。

  3. 正確配置後,在命令列執行 java -version 命令,您將看到 JDK 版本等資訊: java_version_cmd.png

配置 Gradle 4.4 環境

mPaaS 架構只支援 Gradle 4.4

使用 Gradle Wrapper(推薦)

  1. 如果您的專案原先已經使用 Gradle Wrapper 進行構建,則建議在專案目錄/gradle/wrapper/gradle.properties 下把版本號碼修改為 4.4

  2. 如果您的專案沒有使用 Gradle Wrapper,建議先使用全域的 Gradle(4.4)版本,然後調用 gradle wrapper --gradle-version=4.4 安裝一個 gradle wrapper。完成上述步驟後,您只需要使用 ./gradlew 的形式構建,這樣的方式能最小的影響您的開發環境。

使用獨立 Gradle

  1. 下載 。

  2. 解壓 .zip 包,然後將解壓路徑配置為 GRADLE_HOME 環境變數,並將 GRADLE_HOME 下的 bin 路徑添加到 PATH 環境變數中。

  3. 正確配置後,在命令列執行 gradle -v 命令,您將看到 Gradle 版本等資訊:

    macOS 資訊截圖

安裝並配置 Android Studio

安裝 Android Studio

最新版 mPaaS 外掛程式僅支援 4.0 及以上版本的 Android Studio。

  • 關於 Android Studio 下載,請參見 Android Developers

  • 安裝指南

  • 如果您之前使用的是低版本 Android Studio 並已經安裝了 mPaaS 外掛程式,那麼在您從低版本 Android Studio 升級至 4.0 或更新版本的 Android Studio 之後,您只需要升級 mPaaS 外掛程式至最新版本即可。詳情請參見 更新 mPaaS 外掛程式

  • 如果您需要支援 4.0 之前版本 Android Studio 的 mPaaS 外掛程式,請在下載離線安裝包後,採用離線安裝形式安裝。更多關於離線安裝的指導說明,請參考 離線安裝 mPaaS 外掛程式

安裝 Android SDK

您需要安裝 API Level 為 1926 的 Android SDK。

  1. 在 Android Studio 中,通過 Android Studio > Preferences 開啟設定對話方塊。

  2. 如下圖所示,在 Android SDK 對話方塊中,勾選 API Level 為 1926 的 SDK,然後點擊 Apply 按鈕進行安裝: install_android_sdk

安裝 mPaaS 外掛程式

關於更多安裝 mPaaS 外掛程式的資訊,請參見 安裝 mPaaS 外掛程式

配置 Gradle 構建工具

您需要確保工程構建時使用 Gradle Wrapper

  1. 在 Android Studio 中開啟任意一個 Android 工程。

  2. 開啟設定對話方塊。

  3. 如下圖所示,在 Gradle 對話方塊中,勾選 Use default gradle wrapper,然後點擊 Applyuse_gradle_wrapper.png

配置 Linux 開發環境

按照以下說明配置 Linux 開發環境。說明:Linux 作業系統版本較多,本文僅適用於 CentOS 和 Ubuntu 版本。

配置 Java 8 環境

mPaaS 架構只支援 JDK 8 及以上版本

  1. 下載並安裝 JDK 8

  2. 配置 JAVA_HOME 環境變數,並將 JAVA_HOME 下的 bin 路徑添加到 PATH 環境變數中。

  3. 正確配置後,在命令列執行 java -version 命令,您將看到 JDK 版本等資訊: java_version_cmd.png

配置 Gradle 4.4 環境

使用 Gradle Wrapper(推薦)

  1. 如果您的專案原先已經使用 Gradle Wrapper 進行構建,則建議在專案目錄/gradle/wrapper/gradle.properties 下把版本號碼修改為 4.4

  2. 如果您的專案沒有使用 Gradle Wrapper,建議先使用全域的 Gradle(4.4)版本,然後調用 gradle wrapper --gradle-version=4.4 安裝一個 gradle wrapper。完成上述步驟後,您只需要使用 ./gradlew 的形式構建,這樣的方式能最小的影響您的開發環境。

使用獨立 gradle

  1. 下載 。

  2. 解壓 .zip 包,然後將解壓路徑配置為 GRADLE_HOME 環境變數,並將 GRADLE_HOME 下的 bin 路徑添加到 PATH 環境變數中。

  3. 正確配置後,在命令列執行 gradle -v 命令,您將看到 Gradle 版本等資訊。

安裝 32 位相容庫

CentOS 6、CentOS 7、Ubuntu 等 Linux 發行版預設去除 ia32-lib。所有 64 位元 Linux 系統都需安裝 32 位相容庫。參照 android-sdk 中的安裝方法。

Ubuntu:
sudo apt-get install zlib1g:i386

CentOS:
yum install libstdc++.i686

安裝並配置 Android Studio

安裝 Android Studio

最新版 mPaaS 外掛程式僅支援 4.0 及以上版本的 Android Studio。

  • 關於 Android Studio 下載,請參見 Android Developers

  • 安裝指南

  • 如果您之前使用的是低版本 Android Studio 並已經安裝了 mPaaS 外掛程式,那麼在您從低版本 Android Studio 升級至 4.0 或更新版本的 Android Studio 之後,您只需要升級 mPaaS 外掛程式至最新版本即可。詳情請參見 更新 mPaaS 外掛程式

  • 如果您需要支援 4.0 之前版本 Android Studio 的 mPaaS 外掛程式,請在下載離線安裝包後,採用離線安裝形式安裝。更多關於離線安裝的指導說明,請參考 離線安裝 mPaaS 外掛程式

安裝 Android SDK

您需要安裝 API Level 為 1926 的 Android SDK。

  1. 在 Android Studio 中,通過 File > Settings 開啟設定對話方塊。

  2. 如下圖所示,在 Android SDK 對話方塊中,勾選 API Level 為 1926 的 SDK,然後點擊 Apply 按鈕進行安裝: install_android_sdk.png

安裝 mPaaS 外掛程式

關於更多安裝 mPaaS 外掛程式的資訊,請參見 安裝 mPaaS 外掛程式

配置 Gradle 構建工具

您需要確保工程構建時使用 Gradle Wrapper

  1. 在 Android Studio 中開啟任意一個 Android 工程。

  2. 開啟設定對話方塊。

  3. 如下圖所示,在 Gradle 對話方塊中,勾選 Use default gradle wrapper,然後點擊 Apply 按鈕: use_gradle_wrapper.png