Mobile Platform as a Service：mPaaS 10.1.68 適配 Android 13

Google已於 2022 年 8 月 16 日發布 Android 13 正式版。mPaaS 作為基礎庫，已在 10.1.68 基準上進行了相關適配。在 mPaaS 適配之前，在 Android 13 裝置上使用 mPaaS SDK 時 H5 容器和小程式將無法啟用 UC 核心。

升級 SDK

使用 接入/升級基準 來升級 mPaaS SDK 。

啟用 UC 核心

在 Android 13 系統上需要使用特定版本的 UC 核心，並添加配置來開啟 UC 核心。若不進行以下適配，在 Android 13 系統上 H5 容器、小程式將預設啟用系統 WebView，可能出現部分頁面白屏或 API 異常等問題。

implementation('com.alipay.android.phone.wallet:nebulaucsdk-build:999.3.22.2.51.220908200129@aar') {
    force = true
}

Portal&Bundle 接入方式還需要移除 SDK 中原本的 UC 核心，在主 module （Portal&Bundle 接入方式在 Portal 工程中）的 build.gradle 中添加以下內容：

mpaascomponents {
    excludeDependencies = [
            "com.alipay.android.phone.wallet:nebulaucsdk-build"
    ]
}

添加配置在 Android 13 上開啟 UC 核心

在 assets 中 config 目錄下建立 custom_config.json 檔案，並在檔案中添加以下內容：

[
  {
    "value":"{\"h5_enableExternalWebView\":\"YES\",\"h5_externalWebViewSdkVersion\":{\"min\":11,\"max\":33}}",
    "key":"h5_webViewConfig"
  },
  {
  "key":"h5_useLastCommitUrl",
  "value":"YES"
  }
]

迴歸測試

升級 UC 核心可能會伴隨部分瀏覽器特性而發生改動，請對 H5 容器、小程式等使用 UC 瀏覽器的相關業務進行迴歸測試。

安全保障

基於 mPaaS 架構開發 App 時，使用 H5 容器/小程式的 App 會較多使用 JSAPI，建議在開啟 URL 時以及使用 JSAPI 時對 URL 進行校正，確保是 App 業務內的 URL 才能進行載入開啟或限制 URL 的 JSAPI 呼叫範圍和許可權，以防因為未鑒權造成問題。

1. 設定 JSAPI 鑒權

2. 設定 URL 白名單

定製庫處理

10.1.68 版本各組件併入了定製化的需求，如果您的依賴中包含定製庫，則需要按以下情況處理：

如果您是從低版本 SDK（例如 10.1.60）升級至 10.1.68 版本，您的定製庫可能需要基於新版本進行重新定製，請搜尋群號 41708565 加入DingTalk群諮詢 mPaaS 技術服務人員。