mPaaS 10.1.68 升级指南

基于 10.1.60 版本,mPaaS 10.1.68 进行了以下更新:

  • 新增了 AAR 接入方式,更贴近原生体验。更多 AAR 接入方式的信息,请参考 原生 AAR 接入方式

  • 为单组件提供了更好的支持,提供单组件 demo,更多信息,请参考 获取代码示例

  • 优化单组件 SDK 大小,使整体应用包体积有效降低。

  • 对小程序进行更细粒度拆分,用户可根据自身需求进行选择。

  • 更新 UC 内核更新至 3.0,提供了更好的性能和更强的稳定性。

升级指南

AAR 接入方式下的升级指南

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

  1. 环境配置。

     gradle = 6.5 // 需使用 6.5 及以上版本
     com.android.tools.build:gradle:4.0.0 // 需使用 4.0.0 及以上版本
     com.android.boost.easyconfig:easyconfig:2.8.4
    重要

    如您需要设置 com.android.tools.build:gradle 为 4.2 或以上,则需要在 gradle.properties 文件进行如下配置:android.enableResourceOptimizations=false

  2. 参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。

  3. 在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK

  4. 升级成功后,查看 mpaas_packages.json 文件,如果 base_line 字段是 10.1.68 即表示升级成功。

Inside 接入方式下的升级指南

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

  1. 环境配置。

     gradle = 6.2 // 需使用 6.2 及以上版本
     com.android.tools.build:gradle:3.5.3
     com.alipay.android:android-gradle-plugin:3.5.18
     com.android.boost.easyconfig:easyconfig:2.8.4
  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. 环境配置。

     gradle = 4.4
     com.android.tools.build:gradle:3.0.1
     com.alipay.android:android-gradle-plugin:3.0.0.9.13
     com.android.boost.easyconfig:easyconfig:2.8.4
  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 参数。

 /**
 * 启动在线 url
 *
 * @param app micro app
 * @param url 在线地址
 */
public static void startUrl(MicroApplication app, String url)

 /**
 * 启动在线 url
 *
 * @param app   micro app
 * @param url   在线地址
 * @param param 启动参数
 */
public static void startUrl(MicroApplication app, String url, Bundle param)

扫一扫

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

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

参数和原 ScanService 一致。