应用屏幕方向、宽高比和尺寸调整

Android 应用可在各种设备上运行:手机、平板电脑、可折叠设备、ChromeOS 设备、车载设备、电视,甚至 XR 设备。为了适应这种多样化的环境,您的应用应支持所有设备外形规格和显示大小。

Android 16(API 级别 36)使应用能够通过替换屏幕方向、宽高比和尺寸可调整性方面的应用限制,来适应不同的外形规格和显示屏尺寸。这些替换设置适用于最小宽度 >= 600dp 的设备,这些设备定义了以下内容:

  • 平板电脑
  • 大屏可折叠设备的内部显示屏
  • 窗口化模式(在所有设备规格上)

以目标 API 级别 36 为目标平台的应用可调整大小,并能够进入多窗口模式(相当于 resizeableActivity="true"),如果显示屏的最小宽度 >= 600dp。

在 Android 16 之前,应用在展开的大屏设备上会显示黑边,但如果以 Android 16 为目标平台,则会全屏显示。与黑边模式相比,应用在全屏模式下会显示更多新闻内容。
图 1. 之前在大屏设备上以黑边模式运行的 Developer News 新闻信息流(左侧)在以 Android 16 为目标平台时会全屏运行(右侧)。

Android 16 强制执行一致的自适应应用设计模型,该模型通过遵循用户对设备屏幕方向、宽高比和显示大小的偏好设置来优化用户体验。

更改

对于以 Android 16(API 级别 36)为目标平台且在大屏设备上运行的应用,系统会忽略以下清单属性和 API:

属性或 API 忽略的值
screenOrientation portrait,landscape,reversePortrait,reverseLandscape,sensorPortrait,sensorLandscape,userPortrait,userLandscape
resizeableActivity 全部
minAspectRatio 全部
maxAspectRatio 全部
setRequestedOrientation()

getRequestedOrientation()
portrait,landscape,reversePortrait,reverseLandscape,sensorPortrait,sensorLandscape,userPortrait,userLandscape

例外情况

Android 16 变更的例外情况包括:

  • 小于 sw600dp 的显示屏(大多数手机、翻盖式设备和大屏可折叠设备的外屏)

  • 游戏(基于 android:appCategory 标志)

    使用 Android App Bundle 和 Play 应用签名功能发布游戏,让 Google Play 能够管理该标志并自动提供 app bundle 的优势。另请参阅应用清单概览。

  • 用户在宽高比设置中选择启用应用的默认行为

选择停用

如需停用 API 级别 36 的行为,请声明 PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY 清单属性。

如需针对特定 activity 选择停用,请在 <activity> 元素中设置该属性:

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

如需为整个应用停用此功能,请在 <application> 元素中设置该属性:

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

如果您的应用以 Android 16(API 级别 36)或更高版本为目标平台,此属性不会锁定显示方向,也不会阻止屏幕在大屏幕上旋转。

测试

如需测试您的应用是否受 Android 16 变更的影响,请在 Android Studio 中使用 Pixel Tablet 和 Pixel Fold 系列模拟器,并在应用的模块 build.gradle 文件中设置 targetSdkPreview = "Baklava"。

或者,您也可以在测试设备上使用应用兼容性框架,方法是启用 UNIVERSAL_RESIZABLE_BY_DEFAULT 标志(请参阅兼容性框架工具)。

您可以使用 Espresso 测试框架和 Jetpack Compose 测试 API 自动执行测试。

实施指南

限制设备屏幕方向、宽高比或应用尺寸调整的应用在 Android 16 上可能会遇到显示问题,例如布局重叠。为了在手机、可折叠设备、平板电脑、ChromeOS 设备等设备上提供最佳用户体验,请将应用构建为自适应应用。

准备情况核对清单

请使用以下核对清单,确保您的应用已准备好应对 Android 16 的变更:

  • 避免拉伸界面组件:专为标准纵向手机屏幕设计的布局可能无法适应其他宽高比。例如,填充整个显示屏宽度的界面元素在横向模式下可能会出现拉伸。为组件添加最大宽度,以避免拉伸。
  • 启用布局滚动:如果布局无法滚动,用户可能无法访问在横屏模式下位于屏幕外的按钮或其他界面元素。启用应用布局滚动功能,以验证无论显示屏高度如何,所有内容都可访问。
  • 验证相机在纵向和横向模式下的兼容性:如果相机取景器预览假定相对于摄像头感应具有特定的宽高比和方向,则可能会在不符合要求的显示屏上导致预览画面拉伸或翻转。验证取景器是否会随着屏幕方向的变化而正确旋转。 使取景器能够适应与传感器宽高比不同的界面宽高比。
  • 在窗口大小发生变化时保留状态:移除屏幕方向和宽高比限制可能会导致应用窗口大小频繁发生变化,以响应用户偏好的应用使用方式,例如旋转、折叠或展开设备,或在多窗口模式或桌面窗口化模式下调整应用大小。配置变更(例如屏幕方向变更和窗口大小调整)会导致重新创建 activity(默认情况下)。为了帮助提供最佳用户体验,请保留应用状态,以便应用保留数据(例如表单输入),并且用户可以保持上下文。
  • 使用窗口大小类别:支持不同的窗口大小和宽高比,而无需针对特定设备进行自定义。假设窗口大小会频繁变化。使用窗口大小类别来描述窗口尺寸,然后应用适当的自适应布局。
  • 构建自适应布局:在窗口大小类别中,自适应布局会根据显示尺寸的变化进行调整,以始终打造最佳的应用呈现效果。

如需查看在 Compose 中构建自适应布局的实操指南,请参阅使用 Jetpack Compose 构建自适应应用 Codelab。如果您要迁移使用视图的应用,请参阅 Compose 采用策略。

时间轴

  • Android 16 (2025):对于以目标 API 级别 36 为目标平台的应用,支持所有屏幕方向和宽高比以及应用大小调整功能是大屏设备(最小屏幕宽度 >= 600dp)的基准体验。不过,开发者可以选择停用。
目标 API 级别 适用设备 允许开发者选择停用
36 (Android 16) 大屏设备(最小屏幕宽度 >= 600dp) 是

以特定 API 级别为目标的截止日期因应用商店而异。自 2026 年 8 月起,Google Play 将要求应用以 API 级别 36 为目标 API 级别。

其他资源