兼容性框架变更 (Android 16)

图 1. 开发者选项中的“应用兼容性变更”屏幕列出了您可以开启或关闭的变更。

本页将介绍 Android 16 兼容性框架中包含的可切换变更。在准备支持 Android 16 和以该平台为目标平台时，请将此列表与开发者选项和 ADB 命令结合使用，以测试和调试您的应用。

以下是您可以使用兼容性框架工具进行的操作：

  • 在不实际更改应用的 targetSdkVersion 的情况下测试针对性的变更。您可以使用切换开关强制启用特定的针对性行为变更，以评估对现有应用的影响。
  • 仅针对特定变更进行测试。您可以使用切换开关停用除要测试的变更之外的所有针对性变更，而不必一次处理所有针对性变更。
  • 通过 adb 管理切换开关。您可以使用 adb 命令在自动测试环境中启用和停用可切换的变更。
  • 使用标准变更 ID 更快地进行调试。每个可切换的变更都具有唯一 ID 和名称，可用于在日志输出中快速调试根本原因。

如需详细了解如何针对每个用例使用相应工具，请参阅兼容性框架工具。

兼容性框架中包含的行为变更

此部分的列表中介绍了 Android 16 相关变更的兼容性框架中包含的可切换变更，以及有助于进行常规应用测试的可切换变更。

您可以按默认状态过滤变更列表。

Android 16 兼容性框架中包含的可切换变更

CAMERA_MIC_INDICATORS_NOT_PRESENT

变更 ID：162547999
默认状态：对所有应用都处于停用状态。

表示此设备支持摄像头和麦克风指示灯。如果存在该变更 ID，值为 false，因为如果不存在，CompatChanges#isChangeEnabled 方法会返回 true。

DOWNSCALED

变更 ID：168419799
默认状态：对所有应用都处于停用状态。

此变更是所有按应用缩小缓冲区的变更的把关程序。启用此变更可应用以下缩放比例：

为某个应用软件包启用此变更后，系统会按照已启用的最大缩放比例强制调整该应用的大小。例如，如果同时启用了 80% 和 70%（DOWNSCALE_80 和 DOWNSCALE_70），则系统会使用 80%。 如果同时启用此更改和 DOWNSCALED_INVERSE，则 DOWNSCALED_INVERSE 优先，并且系统会以相反的方式应用缩放比例。

DOWNSCALED_INVERSE

变更 ID：273564678
默认状态：对所有应用都处于停用状态。

此变更是所有按应用反向缩小缓冲区的变更的把关程序。启用此变更可反向应用以下缩放比例（即，系统会改为放大分辨率）：

为某个应用软件包启用此变更后，系统会按照已启用的最小缩放比例强制调整该应用的大小。例如，如果同时启用了 80% 和 70%（DOWNSCALE_80 和 DOWNSCALE_70），则系统会使用 80%，因为在反向应用时，80% 的缩放比例等于 125%，这小于反向应用 70% 缩放比例时应用的 142.86% 缩放比例。如果同时启用此更改和 DOWNSCALED，则 DOWNSCALED_INVERSE 优先，并且缩放比例会以相反的方式应用。

DOWNSCALE_30

变更 ID：189970040
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 30% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 333.33% 的显示屏上运行。

DOWNSCALE_35

变更 ID：189969749
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 35% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 285.71% 的显示屏上运行。

DOWNSCALE_40

变更 ID：189970038
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 40% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 250% 的显示屏上运行。

DOWNSCALE_45

变更 ID：189969782
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 45% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 222.22% 的显示屏上运行。

DOWNSCALE_50

变更 ID：176926741
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 50% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 200% 的显示屏上运行。

DOWNSCALE_55

变更 ID：189970036
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 55% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 181.82% 的显示屏上运行。

DOWNSCALE_60

变更 ID：176926771
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 60% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 166.67% 的显示屏上运行。

DOWNSCALE_65

变更 ID：189969744
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 65% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 153.85% 的显示屏上运行。

DOWNSCALE_70

变更 ID：176926829
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 70% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 142.86% 的显示屏上运行。

DOWNSCALE_75

变更 ID：189969779
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 75% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 133.33% 的显示屏上运行。

DOWNSCALE_80

变更 ID：176926753
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 80% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 125% 的显示屏上运行。

DOWNSCALE_85

变更 ID：189969734
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 85% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横向及纵向分辨率为实际显示屏的 117.65% 的显示屏上运行。

DOWNSCALE_90

变更 ID：182811243
默认状态：对所有应用都处于停用状态。

如果同时还启用了 DOWNSCALED，则为软件包启用此变更便会强制应用假定自己是在一部横屏及竖屏分辨率为实际显示屏的 90% 的显示屏上运行。如果同时还启用了 DOWNSCALED_INVERSE，则为软件包启用此变更便会强制应用假定自己是在一部横屏及竖屏分辨率为实际显示屏的 111.11% 的显示屏上运行。

ENFORCE_STRICT_QUERY_BUILDER

变更 ID：143231523
默认状态：对所有应用都处于停用状态。

启用后，SQLiteQueryBuilder 会根据恶意参数验证所有 CalendarProvider2 查询选择。

FORCE_DISABLE_HEVC_SUPPORT

变更 ID：174227820
默认状态：对所有应用都处于停用状态。

强制应用停止支持 HEVC 媒体功能。 应用应在其清单中声明支持的媒体功能，但此标志可用于强制应用停止支持 HEVC，从而在访问以 HEVC 编码的媒体时强制执行转码。设置此标志会替换应用的任何操作系统级默认值。该变更默认处于停用状态，这意味着操作系统默认值优先。如果同时启用此标志和 FORCE_ENABLE_HEVC_SUPPORT，操作系统会忽略这两个标志。

FORCE_ENABLE_HEVC_SUPPORT

变更 ID：174228127
默认状态：对所有应用都处于停用状态。

强制应用支持 HEVC 媒体功能。应用应在其清单中声明其支持的媒体功能，但此标志可用于强制应用支持 HEVC，从而在访问以 HEVC 编码的媒体时避免转码。设置此标志会替换应用的任何操作系统级默认值。该变更默认处于停用状态，这意味着操作系统默认值优先。如果同时启用此标志和 FORCE_DISABLE_HEVC_SUPPORT，操作系统会忽略这两个标志。

FORCE_NON_RESIZE_APP

变更 ID：181146395
默认状态：对所有应用都处于停用状态。

强制使应用此变更的软件包无法调整尺寸。

FORCE_RESIZE_APP

变更 ID：174042936
默认状态：对所有应用都处于停用状态。

强制使应用该变更的软件包可调整大小。我们只允许在全屏窗口模式下调整显示尺寸，但不强制应用进入可调整显示尺寸的多窗口模式。

GWP_ASAN

变更 ID：145634846
默认状态：对所有应用都处于停用状态。

在应用中启用采样原生内存 bug 检测。

如需详细了解如何使用 GWP-ASan，请参阅 GWP-ASan 指南。

NATIVE_HEAP_ZERO_INIT

变更 ID：178038272
默认状态：对所有应用都处于停用状态。

启用原生堆内存分配的自动零值初始化。

NATIVE_MEMTAG_ASYNC

变更 ID：145772972
默认状态：对所有应用都处于停用状态。

在此过程中启用异步 (ASYNC) 内存标记检查。 此标志仅影响支持 ARM 内存标记扩展 (MTE) 的硬件。

NATIVE_MEMTAG_SYNC

变更 ID：177438394
默认状态：对所有应用都处于停用状态。

在此进程中启用同步 (SYNC) 内存标记检查。 此标志仅影响支持 ARM 内存标记扩展 (MTE) 的硬件。如果同时启用 NATIVE_MEMTAG_ASYNC 和此选项，那么此选项优先，并会在同步模式下启用 MTE。

OVERRIDE_ANY_ORIENTATION

变更 ID：265464455
默认状态：对所有应用都处于停用状态。

启用此变更后，无论 activity 请求的屏幕方向如何，系统都会应用以下屏幕方向替换项：

OVERRIDE_ANY_ORIENTATION_TO_USER

变更 ID：310816437
默认状态：对所有应用都处于停用状态。

启用后，系统会启用 SCREEN_ORIENTATION_USER，该属性会替换 activity 请求的任何屏幕方向。通过此替换项，您可以在启用了 ignoreOrientationRequest 的大屏设备上将固定屏幕方向应用替换为全屏。

OVERRIDE_CAMERA_COMPAT_DISABLE_FREEFORM_WINDOWING_TREATMENT

变更 ID：314961188
默认状态：对所有应用都处于停用状态。

启用后，对于固定屏幕方向的应用，在自由形式窗口模式下，系统会将应用了此替换项的软件包从相机兼容性处理中排除。

在自由形式窗口模式下，兼容性处理会通过将应用窗口信箱化并将相机特性更改为应用在纵向设备上通常预期的特性来模拟在纵向设备上运行：后置摄像头和前置摄像头的传感器旋转角度分别为 90 度和 270 度，并将显示屏旋转角度设为 0。

使用此标志可针对对兼容性处理不太敏感的应用停用兼容性处理。

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

变更 ID：191514214
默认状态：对所有应用都处于停用状态。

启用后，此变更会强制使应用该变更的软件包：忽略 android:resizeableActivity 的当前值，以 Android 6.0（API 级别 23）或更低版本为目标，并将该 activity 视为无法调整尺寸。在这种情况下，鉴于当前显示屏旋转情况，摄像头画面旋转和剪裁的值仅取决于所需的补偿值。

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

变更 ID：189229956
默认状态：对所有应用都处于停用状态。

启用后，此变更会强制使应用该变更的软件包替换默认的摄像头画面旋转和剪裁行为，并始终返回 CaptureRequest.SCALER_ROTATE_AND_CROP_NONE。

OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION

变更 ID：316897322
默认状态：对所有应用都处于停用状态。

启用后，系统会确保在用户发起 MediaProjection 会话时，向用户显示选择捕获单个应用或整个屏幕的选项，从而替换 MediaProjectionConfig#createConfigForDefaultDisplay 的使用方式。

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

变更 ID：266124927
默认状态：对所有应用都处于停用状态。

为应用启用 SCREEN_ORIENTATION_REVERSE_LANDSCAPE。除非同时启用 OVERRIDE_ANY_ORIENTATION，否则只有当 activity 指定横屏时，系统才会使用 SCREEN_ORIENTATION_REVERSE_LANDSCAPE。启用此更改有助于您测试应用行为，了解横向屏幕方向对应于 Surface.ROTATION_90 的设备与对应于 Surface.ROTATION_270 的设备之间的差异。

OVERRIDE_LAYOUT_IN_DISPLAY_CUTOUT_MODE

变更 ID：332679525
默认状态：对所有应用都处于停用状态。

启用后，会覆盖刘海屏模式下的布局行为。只有在未强制执行边到边模式时，此设置才会应用。

OVERRIDE_MIN_ASPECT_RATIO

变更 ID：174042980
默认状态：对所有应用都处于停用状态。

此变更是所有强制采用指定最小宽高比的变更的把关程序。启用此变更可应用以下最小宽高比：

为应用软件包启用此变更后，系统会将应用清单文件中指定的最小宽高比替换为已启用的最大宽高比（除非应用清单文件中指定的值更高）。

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

变更 ID：218959984
默认状态：对所有应用都处于停用状态。

启用后，会替换纵向全屏模式下的最小宽高比限制，以便使用所有可用的屏幕空间。

OVERRIDE_MIN_ASPECT_RATIO_LARGE

变更 ID：180326787
默认状态：对所有应用都处于停用状态。

如果同时还启用了 OVERRIDE_MIN_ASPECT_RATIO，则为软件包启用此变更便会将相应 activity 的最小宽高比设为 OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE 定义的较大值。

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

变更 ID：180326845
默认状态：对所有应用都处于停用状态。

如果同时还启用了 OVERRIDE_MIN_ASPECT_RATIO，则为软件包启用此变更便会将相应 activity 的最小宽高比设为 OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE 定义的中等值。

OVERRIDE_MIN_ASPECT_RATIO_ONLY_FOR_CAMERA

变更 ID：325586858
默认状态：对所有应用都处于停用状态。

启用后，会限制强制应用指定最小宽高比的处理，使其仅在应用连接到相机时应用。

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

变更 ID：203647190
默认状态：对所有应用均启用。

如果同时还启用了 OVERRIDE_MIN_ASPECT_RATIO，则此变更会限制有以下作用的任何其他变更：强制将相应 activity 的最小宽高比设为某个值（例如 OVERRIDE_MIN_ASPECT_RATIO_LARGE 和 OVERRIDE_MIN_ASPECT_RATIO_MEDIUM），而让这些变更仅作用于还包含纵向屏幕方向的 activity。

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

变更 ID：236283604
默认状态：对所有应用都处于停用状态。

启用后，此更改会将应用到的软件包从设备制造商可以设置的忽略屏幕方向限制中排除。

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

变更 ID：265451093
默认状态：对所有应用都处于停用状态。

为应用启用 SCREEN_ORIENTATION_NOSENSOR。除非同时启用 OVERRIDE_ANY_ORIENTATION，否则只有当 activity 未指定任何其他固定屏幕方向时，系统才会使用 SCREEN_ORIENTATION_NOSENSOR。

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

变更 ID：265452344
默认状态：对所有应用都处于停用状态。

为应用启用 SCREEN_ORIENTATION_PORTRAIT。除非同时启用 OVERRIDE_ANY_ORIENTATION，否则只有当 activity 未指定任何其他固定屏幕方向时，系统才会使用 SCREEN_ORIENTATION_PORTRAIT。

RATE_LIMIT_TOASTS

变更 ID：174840628
默认状态：无法切换此变更的状态。它只由兼容性框架记录。

对 Toast.show() 调用的次数施加调用频率限制，防止在有限时间内向用户显示过多消息框。如果尝试显示的消息框数超出特定时间范围内允许的数量，会导致消息框被丢弃。

STPE_SKIP_MULTIPLE_MISSED_PERIODIC_TASKS

变更 ID：288912692
默认状态：对以 Android 16 或更高版本为目标平台的应用处于启用状态。

启用后，当应用返回到有效的生命周期时，系统会立即执行最多一次 scheduleAtFixedRate 的错过执行。

如需详细了解此变更，请参阅 Android 16 行为变更页面中关于 固定速率工作调度优化的部分。

UNIVERSAL_RESIZABLE_BY_DEFAULT

变更 ID：357141415
默认状态：对以 Android 16 或更高版本为目标平台的应用处于启用状态。

启用此功能后，系统会在大屏设备（宽度大于 600dp 的屏幕）上忽略应用屏幕方向、可调整大小和宽高比约束条件。

如需详细了解此变更，请参阅 Android 16 行为变更页面中关于 自适应布局的部分。

USE_EXPERIMENTAL_COMPONENT_ALIAS

变更 ID：196254758
默认状态：对所有应用都处于停用状态。

启用后，系统将允许“android”软件包使用组件别名。