mPaaS 适配 targetSdkVersion 35

从 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 容器

    • 全部功能

    分享

    • 分享到各平台是否正常