管理组件依赖

为了更便捷地升级 mPaaS SDK 基线和管理组件依赖，您需要先升级 Android Studio mPaaS 插件至最新版本。关于更新 mPaaS 插件的更多信息，请参见 更新 mPaaS 插件。

添加组件依赖

为了使用 mPaaS 组件，您需要在 mPaaS Inside 工程中添加对应组件的依赖。

操作步骤

  1. 在 Android Studio 中选择 mPaaS > mPaaS Inside 接入，在弹出的接入面板中，点击 配置/更新组件 下的 开始配置。
  2. 在弹出的组件管理窗口中，点击按钮安装需要的组件。
    • 对于未安装的组件，相应的按钮会显示 未安装。点击该按钮会安装该组件。
    • 对于已经安装的组件，按钮会显示 已安装。此时再点击该按钮将会卸载该组件。

后续步骤

如果您此前未使用过 Android Studio mPaaS 插件管理组件依赖，首次使用 组件管理 功能添加完组件后，您还需要检查或修改以下配置。

  1. 检查 mPaaS Inside 工程根目录 build.gradle 文件，确保包含以下依赖且不低于以下版本。
    1. buildscript {
    2.  ...
    3.  dependencies {
    4.      classpath 'com.android.boost.easyconfig:easyconfig:2.5.0'
    5.  }
    6. }

  2. 检查工程主 module 下的 build.gradle 文件，确保包含以下内容。

    1. apply plugin: 'com.alipay.portal'
    2. portal {
    3.  allSlinks true
    4.  mergeAssets true
    5. }
    6. apply plugin: 'com.alipay.apollo.baseline.update'
    7. mpaascomponents{
    8.  excludeDependencies=[]
    9. }

  3. 若需要在子 module 中调用 mPaaS 组件 API，则在工程子 module 下的 build.gradle 文件中添加：

    1. apply plugin: 'com.alipay.apollo.baseline.update'
  4. 如果旧依赖中有为您定制的库，您还需要 添加定制依赖。
  5. 如果由于库冲突导致编译失败，您可以 解决依赖冲突。

升级基线

  1. 在 Android Studio 中点击 mPaaS > mPaaS Inside 接入，在弹出的接入面板中，点击 接入/升级基线 下的 开始配置。
  2. 点击版本下拉框，选择一个新版本，然后点击 OK 按钮，即可升级基线。

升级单个组件

新版

  1. 在 Android Studio 中选择 mPaaS > 组件升级，您将看到组件列表。
  2. 查看组件状态，进行升级操作，若右上角有提示可更新，那么点击之后就能更新了。
    组件升级

旧版

  1. 在 Android Studio 中选择 mPaaS > 组件升级，您将看到组件列表。
  2. 查看组件状态，进行升级操作。
    • 若为 最新版，则说明该组件无需升级。
    • 否则说明该组件有新版本。您可以点击状态按钮，升级该组件。
      Components Update

添加定制依赖

  • 如果您首次使用 组件管理 管理组件但未升级 SDK，您只需将定制库写在工程主 module 下 build.gradle 文件中的 dependencies 节点下，例如：
    1. bundle 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.180322162837@jar'
    2. manifest 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.180322162837:AndroidManifest@xml'
  • 如果您首次使用 组件管理 管理组件且升级了 SDK，或使用 基线升级 升级了 SDK，您的定制库可能需要基于新版本重新定制，请 提交工单 或联系 mPaaS 支持人员确认，重新定制或确认无需重新定制后，您可按照上文添加定制依赖。