全部产品
云市场
云游戏

mPaaS Inside/组件化接入方式下的环境配置

更新时间:2020-06-23 14:24:14

在进行客户端开发之前,您首先需要配置开发环境:

配置 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. 下载 Gradle 4.4.zip
  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 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 工程,添加、删除和升级 mPaaS 组件,构建工程等。安装步骤如下:

  1. 在 Android Studio 中,通过 File > Settings 打开设置对话框。
  2. 点击左侧 Plugins,然后点击右上方的 function,并在下拉菜单中选择 Manage Plugin Repositories
    Manage Plugin Repositories
  3. 在弹出的 Custom Plugin Repositories 窗口中,点击 + 按钮,在新增的行中输入 https://mulei.oss-cn-hangzhou.aliyuncs.com/updatePlugins.xml,然后点击 OK
    说明:对于个别版本的 Android studio,可能需要在输入仓库地址后,鼠标单击下方空白区域(或按 Enter 键)后,再点击 OK 进行添加,否则可能出现添加失败,无法连接的情况。
    Custom Plugin Repositories
  4. 返回 Plugins 窗口后,在 Marketplace 选项卡下搜索 mpaas。在搜索结果中,点击搜索到的 mPaaS 插件下方的 Install 安装该插件。
    install
  5. 等待插件安装结束,重启 Android Studio 后,您将在顶部的菜单中看到 mPaaS 插件:
    mpaas_plugin

配置 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. 下载 Gradle 4.4.zip
  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 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 工程,添加、删除和升级 mPaaS 组件,构建工程等。安装步骤如下:

  1. 在 Android Studio 中,通过 Android Studio > Preferences 打开设置对话框。
  2. 点击左侧 Plugins,然后点击右上方的 function,并在下拉菜单中选择 Manage Plugin Repositories
    manage plugin repositories
  3. 在弹出的 Custom Plugin Repositories 窗口中,点击 + 按钮,在新增的行中输入 https://mulei.oss-cn-hangzhou.aliyuncs.com/updatePlugins.xml,然后点击 OK
    Custom Plugin Repositories
  4. 返回 Plugins 窗口后,在 Marketplace 选项卡下搜索 mpaas。在搜索结果中,点击搜索到的 mPaaS 插件下方的 Install 安装该插件。
    install
  5. 等待插件安装结束,重启 Android Studio 后,您将在顶部的菜单中看到 mPaaS 插件:
    mpaas_plugin

配置 Gradle 构建工具

您需要确保工程构建时使用 Gradle Wrapper

  1. 在 Android Studio 中打开任意一个 Android 工程。
  2. 打开设置对话框。
  3. 如下图所示,在 Gradle 对话框中,勾选 Use default gradle wrapper,然后点击 Apply
    use_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. 下载 Gradle 4.4.zip
  2. 解压 .zip 包,然后将解压路径配置为 GRADLE_HOME 环境变量,并将 GRADLE_HOME 下的 bin 路径添加到 PATH 环境变量中。
  3. 正确配置后,在命令行执行 gradle -v 命令,您将看到 Gradle 版本等信息:
    gradle_v_cmd.png

安装 32 位兼容库

CentOS 6、CentOS 7、Ubuntu 等 Linux 发行版默认去除 ia32-lib。所有 64 位 Linux 系统都需安装 32 位兼容库。参照 android-sdk 中的安装方法:

  1. Ubuntu:
  2. sudo apt-get install zlib1g:i386
  3. CentOS:
  4. yum install libstdc++.i686

安装并配置 Android Studio

安装 Android Studio

最新版 mPaaS 插件仅支持 4.0 版本的 Android Studio。

安装 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 工程,添加、删除和升级 mPaaS 组件,构建工程等。安装步骤如下:

  1. 打开 Android Studio 设置对话框。
  2. 点击左侧 Plugins,然后点击下方 Browse repositories 按钮。
    Browse repositories.png
  3. 点击下方 Manage repositories 按钮。
    Manage repositories.png
  4. 点击 + 按钮。
    Custom repositories.png
  5. 在弹出框 Repository URL 中填入 https://mulei.oss-cn-hangzhou.aliyuncs.com/updatePlugins.xml,然后点击 OK 按钮。
    OK
  6. 点击 Custom Plugin Repositories 对话框 OK 按钮,回到 Browse repositories 对话框。
  7. 在 Browse repositories 对话框左上方的搜索框中输入 mPaaS。等待搜索结束后,点击搜索到的 mPaaS 插件,然后点击插件右侧的 Install 安装该插件。
    install
  8. 等待插件安装结束,重启 Android Studio,您将看到 mPaaS 插件:
    mpaas_plugin.png

配置 Gradle 构建工具

您需要确保工程构建时使用 Gradle Wrapper

  1. 在 Android Studio 中打开任意一个 Android 工程。
  2. 打开设置对话框。
  3. 如下图所示,在 Gradle 对话框中,勾选 Use default gradle wrapper,然后点击 Apply 按钮:
    use_gradle_wrapper.png