基於 10.1.60 版本,mPaaS 10.1.68 進行了以下更新:
新增了 AAR 接入方式,更貼近原生體驗。更多 AAR 接入方式的資訊,請參考 原生 AAR 接入方式。
最佳化單組件 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 一致。