全部产品

mPaaS 10.1.68 升级指南

更新时间:2020-09-24 14:08:45

关于 mPaaS 10.1.68

  • 新增了 AAR 接入方式,更贴近原生体验。更多 AAR 接入方式的信息,请参考 原生 AAR 接入方式
  • 为单组件提供了更好的支持,提供单组件 demo,更多信息,请参考 获取代码示例
  • 优化单组件 SDK 大小,使整体应用包体积有效降低。
  • 对小程序进行更细粒度拆分,用户可根据自身需求进行选择。
  • 更新 UC 内核更新至 3.0,提供了更好的性能和更强的稳定性。

升级指南

AAR 接入方式下的升级指南

如果您已有采用原生 AAR 接入方式的工程,请按照以下步骤完成升级。

  1. 环境配置。
    1. gradle = 6.5 // 需使用 5.0 及以上版本
    2. com.android.tools.build:gradle:4.0.0 // 需使用 3.4.0 及以上版本
    3. com.android.boost.easyconfig:easyconfig:2.4.3
  2. 参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。
  3. 在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK
  4. 升级成功后,查看根目录的 build.gradle 文件,如果 ext.mpaas_baseline 字段是 10.1.68 即表示升级成功。

Inside 接入方式下的升级指南

如果您已有基于 Inside 接入方式的工程,请按照以下步骤完成升级。

  1. 环境配置。

    1. gradle = 6.2 // 需使用 4.4 及以上版本
    2. com.android.tools.build:gradle:3.5.3
    3. com.alipay.android:android-gradle-plugin:3.5.4
    4. com.android.boost.easyconfig:easyconfig:2.4.3
  2. 参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。

  3. 在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK
  4. 升级成功后,查看 mpaas_packages.json 文件,如果 base_line 字段是 10.1.68 即表示升级成功。

组件化接入方式(Portal Bundle)下的升级指南

如果您已有基于 Portal&Bundle 接入方式的工程,请按照以下步骤完成升级。

  1. 环境配置。
    1. gradle = 4.4
    2. com.android.tools.build:gradle:3.0.1
    3. com.alipay.android:android-gradle-plugin:3.0.0.8.3
    4. com.android.boost.easyconfig:easyconfig:2.4.3
  2. 请参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。
  3. 在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK
  4. 升级成功后,查看 mpaas_packages.json 文件,如果 base_line 字段是 10.1.68 即表示升级成功。

升级到最新的 Gradle 插件

目前 Google 官方提供的 Android Gradle Plugin 是 3.5.x 版本。mPaaS 也提供了 3.5.x 版本的插件作为适配,可支持 Google Android Gradle Plugin 3.5.3 和 Gradle 6.0 的 API。您可根据需要,参考 升级到最新的 Gradle 插件 文档升级 Gradle 插件。

组件管理变更

在更新至 10.1.68 之后,以下组件发生了变更,如您之前有选择这些组件,则需要按照以下改动重新操作。
更多信息,请参考 组件管理

  • FRAMEWORK 框架 已变更为可选项。
  • MAP 地图 已变更为 TINYAPP-MAP 小程序地图
  • TINYPROGRAM 小程序 已变更为 TINYAPP 小程序
  • MINIPROGRAM-BLUETOOTH 小程序蓝牙 已删除,默认合并至 TINYAPP小程序 中。
  • MINIPROGRAM-MEDIA 小程序多媒体 已变更为TINYAPP-MEDIA 小程序多媒体
  • TINYVIDEO 小程序视频 已删除,目前暂时不提供小程序视频。
  • 新增 UCCORE UC内核,之前如果您用到 UC 内核,例如用到了 H5 容器或是小程序,请手动添加该组件。

组件使用升级指南

H5 容器

从 10.1.68 基线开始自定义标题栏的使用方法有了变化,更多信息请参见 自定义导航栏(10.1.68)

UC 内核

在 10.1.68 基线中对 UC 内核进行了升级,请全面回归前端页面内容等相关部分,以免出现兼容性问题。

组件 API 变更

H5 容器

H5TitleView

H5TitleView 新增了部分接口,更多信息请参见 自定义导航栏(10.1.68)

MPNebula

新增接口,增加 MicroApplication app 参数。

  1. /**
  2. * 启动在线 url
  3. *
  4. * @param app micro app
  5. * @param url 在线地址
  6. */
  7. public static void startUrl(MicroApplication app, String url)
  8. /**
  9. * 启动在线 url
  10. *
  11. * @param app micro app
  12. * @param url 在线地址
  13. * @param param 启动参数
  14. */
  15. public static void startUrl(MicroApplication app, String url, Bundle param)

扫一扫

在 Inside 或 AAR 模式下,如未接入框架,需改用 MPScan 以下方法启动扫一扫标准 UI:

  1. startMPaasScanActivity(Activity activity, ScanRequest scanRequest, ScanCallback scanCallback);

参数和原 ScanService 一致。