全部产品

mPaaS 10.1.60 升级指南

更新时间:2020-11-23 12:01:42

关于 mPaaS 10.1.60 正式版

  • 10.1.60 基线已适配 Android 10
  • 10.1.60 基线新增加了 小程序组件 正式版。小程序正式版拥有更加完善的 API,且在稳定性、兼容性等方面有了大幅提高。关于小程序升级请参见 小程序升级说明,关于小程序 IDE 新增调试、预览、发布等功能的详情请参见 小程序 IDE
  • 10.1.60 基线对 H5 容器 整体进行大幅优化,提供了更加简化的接入流程,持续补强能力,在兼容性、稳定性等方面有显著提高。关于 H5 容器和离线包升级,请参见 H5 容器升级说明
  • 10.1.60 基线中,消息推送新增加了对 OPPO 和 vivo 渠道推送的支持。
  • 10.1.60 基线新增加了对 社交分享 组件的管理支持,提供了简化的接入流程。关于社交分享的升级,请参见 迁移到 10.1.60 基线
  • 10.1.60 基线新增加 智能投放 组件。智能投放提供了在应用内个性化投放广告的能力,支持针对定向人群进行个性化广告投放,帮助 APP 运营人员精准、及时触达用户,详情请参见 智能投放
  • 10.1.60 基线的整体组件的兼容性、稳定性都有了大幅提高,功能也有着显著提升,具体的发布说明请参见 Android SDK 发布说明

mPaaS 10.1.60 正式版升级指南

操作步骤

  1. 升级 Android Studio mPaaS 插件到 v2.19123015 或以上。
    关于更新 mPaaS 插件,参见 更新 mPaaS 插件
  2. 在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.60,并点击 OK
  3. 升级成功后,查看 mpaas_packages.json 中,”base_line” 字段是 10.1.60 即表示升级成功。
    10.1.60
说明:10.1.60-beta 基线转为正式版也需要按上述操作。

组件使用升级指南

10.1.60 基线中的 H5 容器、小程序和社交分享组件在接入、使用等方面做了大幅调整。如您接入了上述组件,需详细阅读下列说明:

  • 阅读 H5 容器升级说明 了解 H5 容器和离线包升级的更多信息。
  • 阅读 小程序升级说明 了解小程序升级的更多信息。
  • 社交分享 SDK 接入方式升级。阅读 迁移到 10.1.60 基线 了解 社交分享 组件升级的更多信息。
    说明
    • 从 10.1.60 开始,分享 SDK 使用 mPaaS 插件进行管理。如果需要安装分享组件,请参见 迁移到 10.1.60 基线 进行操作。
    • 如未使用插件进行分享 SDK 的接入,则会导致分享 SDK 的升级与问题修复不能得到及时更新。

组件 API 变更

mPaaS 组件从 10.1.32 基线开始起添加了适配层,建议您使用含有适配层的 API,具体可参考以下各组件文档中的旧版本升级注意事项:

  • 移动分析:
    • 新增适配器,简化使用,参见 自定义事件日志
    • 部分 API 废弃,您需使用新的 API,参见 移动分析,否则可能导致编译失败。
  • 移动推送:新增适配器,简化使用,参见 移动推送
  • 移动同步:新增适配器,简化使用,参见 移动同步
  • 热修复:新增适配器,简化使用,参见 热修复 SDK
  • 版本升级:新增适配器,简化使用,参见 版本升级
  • 开关配置:新增适配器,简化使用,参见 开关配置
  • H5 容器:
    • 新增适配器,简化使用,参见 H5 容器 SDK 10.1.32
    • 容器配置方法变更,如果升级前为 10.0.18 版本,您需使用新的容器配置方法,参见 容器配置 10.1.32,否则您的容器配置将无法生效。
    • 10.1.60 基线变更参考 升级说明
  • 小程序:
    • 先进行 H5 容器升级。
    • 升级变更信息 升级说明
说明:强烈建议您修改代码,使用中间层(适配器)方法而非直接使用底层方法,因为某些底层方法可能会在将来的版本中发生变更或废弃。如果您继续使用,在将来的更新中可能需要花费更多的时间进行适配。

定制依赖处理

查看所有 build.gradledependencies 的依赖配置,确认是否配置有 mPaaS 组件的 bundle 依赖。若有依赖,且是从低版本 SDK(例如 10.1.32)升级至 10.1.60 版本,您的定制库可能需要基于新版本重新定制,否则可能会出现不兼容等问题,请 提交工单 或联系 mPaaS 支持人员确认。