全部產品
Search
文件中心

Mobile Platform as a Service:mPaaS 適配 targetSdkVersion 35

更新時間:Jun 07, 2025

從 mPaaS 10.2.3.63 起,mPaaS 增加了對 targetSdkVersion 35 的支援。如果您的應用需要將 targetSdkVersion 升級到 35,請使用 mPaaS 外掛程式將 SDK 更新到 10.2.3.63 及以上基準版本,並按照下文進行適配和迴歸相關功能。

適配 targetSdkVersion 35

前置條件

請先參考以下文檔,確保您的應用已經完成了對 targetSdkVersion 舊版本的適配:

修改 targetSdkVersion

AAR 接入方式

在工程主 module 下的 build.gradle 檔案中修改屬性 targetSdkVersion 35。

Portal & Bundle 接入方式

不支援,如需適配 targetSdkVersion 35,請將接入方式切換為 AAR 接入。

重要

伴隨著 Android 系統的不斷更新,Portal & Bundle 接入方式的適配和維護成本也在不斷提高,未來的某個時間點之後可能會徹底停止 Portal & Bundle 接入方式對 Android 新版系統的支援。推薦您儘快選擇合適的時機切換為 AAR 接入方式。

適配內容

介面變更 - 視窗邊襯區更改

運行在 Android 15 及以上裝置上將會預設以無邊框顯示,詳情請參考 官方文檔

如果您接入的組件包含了介面且因該變更而展示異常,您可在應用的 theme 中通過配置 windowOptOutEdgeToEdgeEnforcement 屬性來規避該特性生效。

如下樣本展示了如何在 theme 中進行 windowOptOutEdgeToEdgeEnforcement 屬性的配置。

  • 在 style.xml 檔案中設定如下代碼:

    <resources>
        <style name="AppTheme">
            <item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>
        </style>
    </resources>
  • 在 AndroidManifest.xml 中設定如下代碼:

    <application android:theme="@style/AppTheme">
    </application>
重要

使用該屬性需將 compileSdk 升級到 35,同時要求 gradle 最低版本為 8.7,AGP 最低版本為 8.6.0,否則可能會導致編譯失敗或其他意外問題。

迴歸測試

  • 全量迴歸且測試的裝置中必須包含 Android 15 或以上版本的裝置。

  • 迴歸測試中您需要重點關注以下組件功能(如果使用):

    組件

    驗證專案

    訊息推送

    • 自建通道收到訊息後是否能展示通知

    • 廠商通道推送訊息是否正常

    小程式

    • 全部功能

    H5 容器

    • 全部功能

    分享

    • 分享到各平台是否正常