mPaaS 10.1.68 升级指南

关于 mPaaS 10.1.68

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

升级指南

AAR 接入方式下的升级指南

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

1. 环境配置。

        
   
         
    gradle = 6.5 // 需使用 5.0 及以上版本
         
    com.android.tools.build:gradle:4.0.0 // 需使用 3.4.0 及以上版本
         
    com.android.boost.easyconfig:easyconfig:2.5.0
        

   注意：如您需要设置 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 // 需使用 4.4 及以上版本
         
    com.android.tools.build:gradle:3.5.3
         
    com.alipay.android:android-gradle-plugin:3.5.14
         
    com.android.boost.easyconfig:easyconfig:2.5.0
        

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.5.0
        

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 一致。