基于 10.1.60 版本,mPaaS 10.1.68 进行了以下更新:
新增了 AAR 接入方式,更贴近原生体验。更多 AAR 接入方式的信息,请参考 原生 AAR 接入方式。
为单组件提供了更好的支持,提供单组件 demo,更多信息,请参考 获取代码示例。
优化单组件 SDK 大小,使整体应用包体积有效降低。
对小程序进行更细粒度拆分,用户可根据自身需求进行选择。
更新 UC 内核更新至 3.0,提供了更好的性能和更强的稳定性。
升级指南
AAR 接入方式下的升级指南
如果您已有采用原生 AAR 接入方式的工程,请按照以下步骤完成升级。
环境配置。
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
。参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。
在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK。
升级成功后,查看
mpaas_packages.json
文件,如果base_line
字段是10.1.68
即表示升级成功。
Inside 接入方式下的升级指南
如果您已有基于 Inside 接入方式的工程,请按照以下步骤完成升级。
环境配置。
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
参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。
在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK。
升级成功后,查看
mpaas_packages.json
文件,如果base_line
字段是10.1.68
即表示升级成功。
组件化接入方式(Portal Bundle)下的升级指南
如果您已有基于 Portal&Bundle 接入方式的工程,请按照以下步骤完成升级。
环境配置。
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
请参考 更新 mPaaS 插件 文档,升级 Android Studio mPaaS 插件到 2.20031016 或以上。
在 Android Studio 中的当前工程下,点击菜单 mPaaS > 基线升级,选择 10.1.68,并点击 OK。
升级成功后,查看
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 一致。