mPaaS 适配 targetSdkVersion 36

更新时间:
复制 MD 格式

从 mPaaS 国际版基线 mpaas-baseline-10.2.3.global:4起,新增对 targetSdkVersion 36 的支持。若需升级至该版本,请使用 mPaaS 插件将 SDK 更新至此基线或更高版本,并按下文指引完成适配与功能回归。

重要

当前仅在国际版基线完成适配,后续将同步至主基线。

适配 targetSdkVersion 36

前置条件

请先参考以下文档,确保您的应用已经完成了 targetSdkVersion 旧版本的适配:

修改 targetSdkVersion

AAR 接入方式

在工程主 module 的 build.gradle 文件中,将 targetSdkVersion 属性修改为 36。

Portal & Bundle 接入方式

Portal&Bundle 接入方式不支持 targetSdkVersion 36,如需适配请切换为 AAR 接入。

重要

鉴于 Portal&Bundle 的适配维护成本随 Android 系统更新而增加,且未来可能停止支持新版系统,建议您尽快择机切换至 AAR 接入。

适配内容

大屏设备上应用的自适应布局

针对以 Android 16(API 级别 36)为目标平台的应用,在最小宽度 ≥ 600dp 的显示屏上,屏幕方向、尺寸调整能力及宽高比限制将不再生效。应用会填满整个显示窗口,无论宽高比或用户偏好的屏幕方向如何,均不会启用竖屏黑边模式。详情请参阅 官方文档。

请在 AndroidManifest.xml 中声明 PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY 属性,以暂时停用该特性。

<application ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
</application>

回归测试

  • 全量回归且测试的设备中必须包含 Android 16 或以上版本的设备。

  • 回归测试中您需要重点关注以下组件功能(如果使用):

    组件

    验证项目

    小程序

    • 全部功能

    H5 容器

    • 全部功能

    扫一扫

    • 页面回退功能是否正常

    开放平台人脸

    • 全屏展示是否正常

    私有云人脸

    • 全屏展示是否正常