切换工作空间（Workspace）

应用开发过程中，常会有更换应用环境信息或多套环境（即工作空间，Workspace）并行研发的需求。mPaaS 提供的工具可帮助您在开发过程中方便地进行环境切换。根据切换环境的需求不同，分为以下两种方式：

• 静态环境切换
• 动态环境切换

静态环境切换

前置条件

您已有 基于 mPaaS 框架 开发的 APP。更多信息参见 基于 mPaaS 框架 > 快速开始。

公有云

在公有云环境中，切换工作空间的步骤如下：

1. 确保工程根目录 build.gradle 文件中，有如下依赖：

   说明：因功能迭代，以下依赖的版本可能会不断增大。

    classpath 'com.alipay.android:android-gradle-plugin:3.0.0.9.13'
    // 版本号必须大于 2.1.0
    classpath 'com.android.boost.easyconfig:easyconfig:2.4.8'

2. 确保主工程（android main module） 的 build.gradle 中有如下配置（请注意顺序）：

    apply plugin: 'com.alipay.portal'
    //位于 com.alipay.portal 之后即可
    apply plugin: 'com.alipay.apollo.baseline.update'

3. 从控制台下载对应工作空间（Workspace）的 .config 配置文件。更多信息，请参考 在控制台创建应用 > 下载配置文件。

4. 将下载的 .config 配置文件添加到主工程（android main module）路径下。注意：仅保留对应工作空间的配置文件即可。如下图所所示：

   

专有云

在专有环境中，切换工作空间的步骤如下：

1. 确保工程根目录 build.gradle 文件中，有如下依赖：

   说明：因功能迭代，以下依赖的版本可能会不断增大。

    classpath 'com.alipay.android:android-gradle-plugin:3.0.0.9.13'
    // 版本号必须大于 2.1.0
    classpath 'com.android.boost.easyconfig:easyconfig:2.4.8'

2. 确保主工程（android main module） 的 build.gradle 中有如下配置（需注意顺序）：

    apply plugin: 'com.alipay.portal'
    //位于 com.alipay.portal 之后即可
    apply plugin: 'com.alipay.apollo.baseline.update'

3. 从控制台下载对应工作空间的 .config 配置文件。更多信息参考 在控制台创建应用 > 下载配置文件。

4. 将下载的 .config 配置文件添加到主工程（android main module）路径下。注意：仅保留对应工作空间的配置文件即可。如下图所所示：

   

5. 使用 mPaaS 插件生成 yw_1222.jpg 加密图片。更多信息参见 加密图片（专有云）。

注意事项

easyconfig 工作原理：

1. 能够修改AndroidManifest workspace 相关的 meta 属性。
2. 修改 assets 下的 mpaas.properties 文件。
3. 如果 mPaaS 工程配置文件中包涵 base64 属性且属性不为空，会生成无线保镖加密图片 yw_1222.jpg。

动态环境切换

动态环境切换指客户端不重新打包的情况下，通过修改手机设置中环境选项，动态修改应用的环境信息。

由于 mPaaS 安全验签机制的限制，更新环境配置信息会修改无线保镖验签 yw_1222.jpg 图片，因此动态切换环境有两个限制：

• 仅适用于开发阶段：动态切换环境仅适用于开发阶段，上线前请注意删除对应的配置（Release 包会报 RuntimeException 异常）。

• mPaaS 控制台需关闭网络请求验签开关，否则会因验签图片信息不对导致请求失败。

  

添加动态环境切换 SDK

1. 在 portal 工程主 module 下面的 build.gradle 配置文件中的 dependencies 中添加以下依赖：

   dependencies {
    ···
    bundle 'com.mpaas.mocksettings:mocksettings-build:1.0.0.200421111458@jar'
    manifest 'com.mpaas.mocksettings:mocksettings-build:1.0.0.200421111458:AndroidManifest@xml'
    ····
   }

2. 将 portal 工程主 module 下面的 AndroidManifest.xml 中的 application 修改为如下配置：

   <application
        android:name="com.alipay.mobile.quinox.MockSettingsLauncherApplication"
        android:debuggable="true"
        ···
        >
        ···
   </application>

动态切换

1. 扫描二维码下载 mPaaS 设置 APP。

   

   安装完成后，显示 mPaaS 设置 APP 的图标如下：

   

2. 将 mPaaS 控制台下载的 config 文件放入手机 SD 卡中。

3. 添加环境。通过 mPaaS 设置 APP 将 config 文件添加到列表中。

   1. 打开 mPaaS 设置 App。

   2. 点击 环境列表 页面底部的 添加环境配置文件。

      

   3. 找到要添加的环境配置文件。

      

   4. 依次将两个文件（正式环境和测试环境）添加至环境列表。

      

4. 切换环境。

   1. 选择上图中的一个环境，点击 切换，将其选中为当前环境。

      

   2. 然后启动该环境所对应的 APP，测试请求可正常发送，说明环境切换成功。

      

      此时若切换到另一个环境，再重启前一个环境所对应的 APP，由于新的环境内没有对应的 operationType，所以系统会报 3000 异常，这是已成功切换到另一个环境后的正常结果。