在 2025 年发布 Android 16 时，我们分享了对设备生态系统的愿景，即应用能够无缝适应任何屏幕，无论是手机、可折叠设备、平板电脑、桌面设备、车载显示屏还是 XR 设备。用户希望应用能够在任何地方正常运行。无论是在平板电脑上执行多任务处理、展开设备以便舒适地阅读，还是在桌面窗口化模式环境中运行应用，用户都希望界面能够填满可用的显示空间并适应设备姿态。

我们对屏幕方向和尺寸可调整性 API 进行了重大更改，以方便实现自适应行为，同时提供临时选择退出功能，帮助您完成过渡。我们已经看到，许多开发者在以 API 级别 36 为目标平台时成功适应了这一过渡。

现在，随着 Android 17 Beta 版的发布，我们将进入自适应路线图的下一阶段：Android 17（API 级别 37）移除了开发者对大屏设备（sw > 600 dp）的屏幕方向和尺寸可调整性限制的选择停用功能 。当您以目标 API 级别 37 为目标平台时，您的应用必须能够适应各种显示尺寸。

这些行为变更可确保 Android 生态系统在所有设备外形规格上提供一致的优质体验。

Android 17 中的变更

以 Android 17 为目标平台的应用必须确保与 Android 16 中引入的清单属性和运行时 API 的淘汰兼容。我们知道，对于某些应用来说，这可能是一次重大过渡，因此我们在本文后面部分提供了最佳实践和工具，帮助您避免日后出现常见问题。

自 Android 16 以来，我们没有引入任何新变更，但开发者无法再选择停用。提醒您：当您的应用在大屏设备上运行时（其中 大屏设备是指显示屏的较小尺寸大于或等于 600 dp），系统会忽略以下清单属性和 API：

注意 ：如前文所述，这些变更不适用于小于 sw 600 dp 的屏幕或根据 android:appCategory 标志归类为游戏的应用。

此外，用户保留控制权。在宽高比设置中，用户可以明确选择使用应用请求的行为。

准备应用

应用需要支持横向和纵向布局，以适应用户可以选择使用应用的各种宽高比的显示尺寸，包括可调整大小的窗口，因为将无法再将宽高比和屏幕方向限制为纵向或横向。

测试应用

第一步是使用这些变更测试应用，确保应用在各种显示尺寸下都能正常运行。

在 Android Studio 中使用 Android 17 Beta 1 和 Pixel Tablet 及 Pixel Fold 系列模拟器，并设置 targetSdkPreview = “CinnamonBun”。或者，如果您的应用尚未以目标 API 级别 36 为目标平台，您可以启用 UNIVERSAL_RESIZABLE_BY_DEFAULT 标志来使用 应用兼容性框架。

我们提供了其他工具来确保布局能够正确适应。您可以使用 Compose 界面检查自动审核界面并获取建议，使界面更具自适应性，并使用 DeviceConfigurationOverride在测试中模拟特定的显示特征。

对于历史上限制屏幕方向和宽高比的应用，我们通常会看到以下问题：相机预览倾斜或方向错误、布局拉伸、按钮无法访问，或在处理配置变更时用户状态丢失。

接下来，我们来看看解决这些常见问题的一些策略。

确保相机兼容性

在横向可折叠设备上或在多窗口模式、窗口化模式或连接的显示屏等场景中进行宽高比计算时，常见的问题是相机预览显示拉伸、旋转或裁剪。

确保相机预览不会拉伸或旋转。

此问题通常出现在大屏设备和可折叠设备上，因为应用假定相机功能（如宽高比和传感器方向）与设备功能（如设备屏幕方向和自然屏幕方向）之间存在固定关系。

为确保相机预览能够正确适应任何窗口大小或屏幕方向，请考虑以下四种解决方案：

解决方案 1：Jetpack CameraX（首选） 

最简单且最可靠的解决方案是使用 Jetpack CameraX 库。其 PreviewView 界面元素旨在自动处理所有预览复杂性：

• PreviewView 会正确调整传感器方向、设备旋转和缩放
• PreviewView 会保持相机图像的宽高比，通常通过居中和裁剪 (FILL_CENTER) 来实现
• 您可以根据需要将缩放类型设置为 FIT_CENTER，以便在预览中添加信箱模式

如需了解详情，请参阅 CameraX 文档中的 实现预览。

解决方案 2：CameraViewfinder 

如果您使用的是现有的 Camera2 代码库，则 CameraViewfinder 库（向后兼容到 API 级别 21）是另一种现代解决方案。它通过使用 TextureView 或 SurfaceView 并为您应用所有必要的转换（宽高比、缩放和旋转），简化了摄像头画面的显示。

如需了解详情，请参阅 相机取景器简介博文和 相机预览开发者指南。

解决方案 3：手动 Camera2 实现 

如果您无法使用 CameraX 或 CameraViewfinder，则必须手动计算屏幕方向和宽高比，并确保在每次配置变更时更新计算结果：

• 从 CameraCharacteristics 获取相机传感器方向（例如 0、90、180、270 度）
• 获取设备的当前显示屏旋转角度（例如 0、90、180、270 度）
• 使用相机传感器方向和显示屏旋转角度值来确定 SurfaceView 或 TextureView 所需的转换
• 确保输出 Surface 的宽高比与相机预览的宽高比一致，以防止失真

重要提示 ：请注意，相机应用可能在屏幕的一部分中运行，无论是在多窗口模式还是窗口化模式下，还是在连接的显示屏上。因此，不应使用屏幕尺寸来确定相机取景器的尺寸；请改用 窗口指标。否则，您可能会遇到相机预览拉伸的问题。

如需了解详情，请参阅 相机预览开发者指南和 在不同外形规格上使用相机应用视频。

解决方案 4：使用 intent 执行基本相机操作 

如果您不需要太多相机功能，一个简单明了的解决方案是使用设备的默认相机应用执行拍照或录制视频等基本相机操作。在这种情况下，您可以直接使用 Intent，而不是与相机库集成，以便更轻松地进行维护和适应。

如需了解详情，请参阅 相机 intent。

避免界面拉伸或按钮无法访问

如果您的应用假定特定的设备屏幕方向或显示屏宽高比，那么当应用现在在各种屏幕方向或窗口大小中使用时，可能会遇到问题。

确保按钮、文本字段和其他元素在大屏幕上不会拉伸。

您可能已将按钮、文本字段和卡片设置为 fillMaxWidth 或 match_parent。在手机上，这看起来很棒。但是，在横向平板电脑或可折叠设备上，界面元素会拉伸到整个大屏幕。在 Jetpack Compose 中，您可以使用 widthIn 修饰符为组件设置最大宽度，以避免内容拉伸：

  Box(
    contentAlignment = Alignment.Center,
    modifier = Modifier.fillMaxSize()
) {
    Column(
        modifier = Modifier
            .widthIn(max = 300.dp) // Prevents stretching beyond 300dp
            .fillMaxWidth()        // Fills width up to 300dp
            .padding(16.dp)
    ) {
        // Your content
    }
}

如果用户在可折叠设备或平板电脑上以横向屏幕方向打开您的应用，屏幕底部的保存 或登录 等操作按钮可能会在屏幕外呈现。如果容器不可滚动，用户可能会无法继续操作。在 Jetpack Compose 中，您可以向组件添加 verticalScroll 修饰符：

  Column(
    modifier = Modifier
        .fillMaxSize()
        .verticalScroll(rememberScrollState())
        .padding(16.dp)
)

通过将最大宽度限制与垂直滚动相结合，您可以确保应用保持功能正常且可用，无论应用窗口大小变得多宽或多窄。

请参阅我们关于 构建自适应布局的指南。

在配置变更时保留状态

移除屏幕方向和宽高比限制意味着应用的窗口大小会更频繁地发生变化。用户可能会旋转设备、折叠/展开设备，或在分屏模式或窗口化模式下动态调整应用的大小。

默认情况下，这些配置变更会销毁并重新创建 activity。如果您的应用无法正确管理此生命周期事件，用户将获得令人沮丧的体验：滚动位置重置为顶部、填写一半的表单被清除，并且导航历史记录丢失。为确保提供无缝的自适应体验，您的应用必须在这些配置变更期间保留状态。使用 Jetpack Compose 时，您可以选择不重新创建，而是允许窗口大小更改重新组合界面，以反映新的可用空间量。

请参阅我们关于 保存界面状态的指南。

在 2027 年 8 月之前以 API 级别 37 为目标平台

如果您的应用之前在以 API 级别 36 为目标平台时选择停用了这些变更，那么只有在您的应用以 API 级别 37 为目标平台后，才会受到 Android 17 停用移除的影响。为帮助您提前规划并对应用进行必要的调整，以下是这些变更生效的时间表：

• Android 17：对于以 API 级别 37 为目标 API 级别的应用 ，上述变更将成为大屏设备（最小屏幕宽度 > 600 dp）的基准体验。开发者无法选择停用。

以特定 API 级别为目标平台的截止日期因应用商店而异。对于 Google Play，新应用和更新必须以 API 级别 37 为目标平台，这使得此行为在 2027 年 8 月分发时成为强制性要求。

为 Android 17 做好准备

如需了解 Android 17 中影响应用的所有变更，请参阅Android 17 变更页面。如需测试应用，请下载 Android 17 Beta 1 并更新到 targetSdkPreview = “CinnamonBun”，或使用 应用兼容性框架 启用特定变更。

Android 的未来是自适应的，我们随时为您提供帮助。在为 Android 17 做好准备时，我们建议您查看我们关于 构建自适应布局的指南和 大屏设备质量指南。这些资源旨在帮助您自信地处理多种外形规格和窗口大小。

不要等待。立即开始为 Android 17 做好准备！