本文介紹了在不同系統下開發客戶端應用前所需要完成的環境配置。
在進行客戶端開發之前,您首先需要配置開發環境:
配置 Windows 開發環境
參考以下說明配置 Windows 開發環境。
配置 Java 8 環境
mPaaS 框架只支持 JDK 8 及以上版本。
下載并安裝 JDK 8。
配置
JAVA_HOME
環境變量,并將JAVA_HOME
下的 bin 路徑添加到PATH
環境變量中。正確配置后,在命令行執行
java -version
命令,您將看到 JDK 版本等信息:
配置 Gradle 4.4 環境
mPaaS 框架只支持 Gradle 4.4。
使用 Gradle Wrapper(推薦)
如果您的項目原先已經使用 Gradle Wrapper 進行構建,則建議在項目目錄
/gradle/wrapper/gradle.properties
下把版本號修改為 4.4。如果您的項目沒有使用 Gradle Wrapper,建議先使用全局的 Gradle(4.4)版本,然后調用
gradle wrapper --gradle-version=4.4
安裝一個 gradle wrapper。完成上述步驟后,您只需要使用./gradlew
的形式構建,這樣的方式能最小的影響您的開發環境。
使用獨立 gradle
下載 。
解壓
.zip
包,然后將解壓路徑配置為GRADLE_HOME
環境變量,并將GRADLE_HOME
下的 bin 路徑添加到PATH
環境變量中。正確配置后,在命令行執行
gradle -v
命令,您將看到 Gradle 版本等信息:
安裝并配置 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 為 19 和 26 的 Android SDK。
在 Android Studio 中,通過 File > Settings 打開設置對話框。
如下圖所示,在 Android SDK 對話框中,勾選 API Level 為 19 和 26 的 SDK,然后點擊 Apply 按鈕進行安裝:
安裝 mPaaS 插件
關于更多安裝 mPaaS 插件的信息,請參見 安裝 mPaaS 插件。
配置 Gradle 構建工具
您需要確保工程構建時使用 Gradle Wrapper。
在 Android Studio 中,通過 File > Settings 打開設置對話框。
如下圖所示,在 Gradle 對話框中,勾選 Use default gradle wrapper,然后點擊 Apply 按鈕:
配置 macOS 開發環境
按照以下描述配置 macOS 開發環境。
配置 Java 8 環境
mPaaS 框架只支持 JDK 8 及以上版本。
下載并安裝 JDK 8。
配置
JAVA_HOME
環境變量,并將JAVA_HOME
下的 bin 路徑添加到PATH
環境變量中。正確配置后,在命令行執行
java -version
命令,您將看到 JDK 版本等信息:
配置 Gradle 4.4 環境
mPaaS 框架只支持 Gradle 4.4。
使用 Gradle Wrapper(推薦)
如果您的項目原先已經使用 Gradle Wrapper 進行構建,則建議在項目目錄
/gradle/wrapper/gradle.properties
下把版本號修改為 4.4。如果您的項目沒有使用 Gradle Wrapper,建議先使用全局的 Gradle(4.4)版本,然后調用
gradle wrapper --gradle-version=4.4
安裝一個 gradle wrapper。完成上述步驟后,您只需要使用./gradlew
的形式構建,這樣的方式能最小的影響您的開發環境。
使用獨立 Gradle
下載 。
解壓
.zip
包,然后將解壓路徑配置為GRADLE_HOME
環境變量,并將GRADLE_HOME
下的 bin 路徑添加到PATH
環境變量中。正確配置后,在命令行執行
gradle -v
命令,您將看到 Gradle 版本等信息:
安裝并配置 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 為 19 和 26 的 Android SDK。
在 Android Studio 中,通過 Android Studio > Preferences 打開設置對話框。
如下圖所示,在 Android SDK 對話框中,勾選 API Level 為 19 和 26 的 SDK,然后點擊 Apply 按鈕進行安裝:
安裝 mPaaS 插件
關于更多安裝 mPaaS 插件的信息,請參見 安裝 mPaaS 插件。
配置 Gradle 構建工具
您需要確保工程構建時使用 Gradle Wrapper。
在 Android Studio 中打開任意一個 Android 工程。
打開設置對話框。
如下圖所示,在 Gradle 對話框中,勾選 Use default gradle wrapper,然后點擊 Apply:
配置 Linux 開發環境
按照以下說明配置 Linux 開發環境。說明:Linux 操作系統版本較多,本文僅適用于 CentOS 和 Ubuntu 版本。
配置 Java 8 環境
mPaaS 框架只支持 JDK 8 及以上版本。
下載并安裝 JDK 8。
配置
JAVA_HOME
環境變量,并將JAVA_HOME
下的 bin 路徑添加到PATH
環境變量中。正確配置后,在命令行執行
java -version
命令,您將看到 JDK 版本等信息:
配置 Gradle 4.4 環境
使用 Gradle Wrapper(推薦)
如果您的項目原先已經使用 Gradle Wrapper 進行構建,則建議在項目目錄
/gradle/wrapper/gradle.properties
下把版本號修改為 4.4。如果您的項目沒有使用 Gradle Wrapper,建議先使用全局的 Gradle(4.4)版本,然后調用
gradle wrapper --gradle-version=4.4
安裝一個 gradle wrapper。完成上述步驟后,您只需要使用./gradlew
的形式構建,這樣的方式能最小的影響您的開發環境。
使用獨立 gradle
下載 。
解壓
.zip
包,然后將解壓路徑配置為GRADLE_HOME
環境變量,并將GRADLE_HOME
下的 bin 路徑添加到PATH
環境變量中。正確配置后,在命令行執行
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 為 19 和 26 的 Android SDK。
在 Android Studio 中,通過 File > Settings 打開設置對話框。
如下圖所示,在 Android SDK 對話框中,勾選 API Level 為 19 和 26 的 SDK,然后點擊 Apply 按鈕進行安裝:
安裝 mPaaS 插件
關于更多安裝 mPaaS 插件的信息,請參見 安裝 mPaaS 插件。
配置 Gradle 構建工具
您需要確保工程構建時使用 Gradle Wrapper。
在 Android Studio 中打開任意一個 Android 工程。
打開設置對話框。
如下圖所示,在 Gradle 對話框中,勾選 Use default gradle wrapper,然后點擊 Apply 按鈕: