本文介紹了使用者在使用 mPaaS 10.1.68 版本基準時,需要為 Android 12 進行的適配工作。
Google已於 2021 年 10 月 4 日發布 Android 12 正式版。mPaaS 作為基礎庫,已在 10.1.68 基準上進行了適配。 10.1.68.37 及之後的版本已經完成了對 Android 12 的適配。在 mPaaS 適配之前,在 Android 12 裝置上,mPaaS SDK 受到的影響為:H5 容器無法啟動 UC 核心。
升級 SDK
使用 接入/升級基準 來升級 mPaaS SDK 。
如果基準版本為 10.1.68,只需升級到最新版本即可。可參考 10.1.68 發布說明。
如果基準版本為 10.1.60 或以下版本,請升級至 10.1.68,並更新至最新版本。
啟動 UC 核心
在 Android 12 系統上需要使用特定版本的 UC 核心,並添加配置來開啟 UC 核心。若不進行以下適配,在 Android 12 系統上 H5 容器將預設啟用系統 WebView。
使用特定版本的 UC 核心
在主 module (Protal&Bundle 接入方式下在 Portal 工程中)的 build.gradle
中的 dependencies
節點下添加依賴:
implementation('com.alipay.android.phone.wallet:nebulaucsdk-build:999.3.22.2.30.211011154625@aar') {
force = true
}
Protal&Bundle 接入方式還需要移除 SDK 中原本的 UC 核心,在主 module (Protal&Bundle 接入方式在 Portal 工程中)的 build.gradle
中添加以下內容:
mpaascomponents {
excludeDependencies = [
"com.alipay.android.phone.wallet:nebulaucsdk-build"
]
}
添加配置在 Android 12 上開啟 UC 核心
在 assets 中 config 目錄下建立 custom_config.json
檔案,並在檔案中添加以下內容:
[
{
"value":"{\"h5_enableExternalWebView\":\"YES\",\"h5_externalWebViewSdkVersion\":{\"min\":11,\"max\":31}}",
"key":"h5_webViewConfig"
}
]
迴歸測試
升級 UC 核心可能會伴隨部分瀏覽器特性而發生改動,請對使用 UC 瀏覽器的相關業務進行迴歸測試。
定製庫處理
10.1.68 版本各組件併入了定製化的需求,如果您的依賴中包含定製庫,則需要按以下情況處理:
如果您是從低版本 SDK(例如 10.1.60)升級至 10.1.68 版本,您的定製庫可能需要基於新版本進行重新定製,請搜尋群號 41708565 加入DingTalk群諮詢 mPaaS 技術服務人員。
如果您已使用 10.1.68 版本,則只需更新部分組件。參見下文的 適配 Android 12 更新的庫清單,檢查您的定製庫是否包含在其中。
如果不包含,您可繼續使用該定製庫。
如果包含,您的定製庫可能需要重新定製,請搜尋群號 41708565 加入DingTalk群諮詢 mPaaS 技術服務人員。
適配 Android 12 更新的庫清單
nebulauc
multimediabiz