全部产品
云市场

管理组件依赖

更新时间:2020-04-27 19:38:38

升级 IDEA 插件

说明:如果已是最新版本可跳过此升级。

为了更便捷地升级 mPaaS SDK 基线和组件,您需要先升级 mPaaS IDEA 插件至最新版本。

  1. 在 Android Studio 中选择 Preferences > Plugins
  2. 搜索关键字 mPaaS,在下方结果中找到 mPaaS Android Plugin,并点击其右侧的 Update 进行升级。
  3. 按照提示重启 Android Studio。

管理组件依赖

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

说明:如果您在创建 mPaaS 工程时已选择过需要使用的组件,您仍可以按照下文步骤增删组件。

使用 IDEA 插件增删依赖步骤为:

  1. 在 Android Studio 中选择 mPaaS > 组件管理,如果您此前未使用过 IDEA 插件管理组件依赖,您会先进入 选择 mPaaS 基线版本 来选择版本。
    Select Baseline
  2. 随后您将看到组件列表。
    Components Manager
  3. 您可以根据需要增删组件,install 为添加,uninstall 为删除,框架和必备组件无法被删除。

首次使用插件管理依赖

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

  1. 检查 mPaaS Inside 工程根目录 build.gradle 文件,确保包含以下依赖且不低于以下版本。
    1. buildscript {
    2. ...
    3. dependencies {
    4. classpath 'com.android.boost.easyconfig:easyconfig:2.3.8'
    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. 如果由于库冲突导致编译失败,您可以 移除 mPaaS 组件单个依赖

升级 SDK 版本

  1. 在 Android Studio 中选择 mPaaS > 基线升级,您将看到当前 SDK 版本信息。
  2. 点击版本下拉框,选择一个新版本,然后点击 OK 按钮,即可升级 mPaaS SDK 版本。
    Baseline Update

升级单个组件

新版

  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 支持人员确认,重新定制或确认无需重新定制后,您可按照上文添加定制依赖。