兼容性框架变更 (Android 15)

CAMERA_MIC_INDICATORS_NOT_PRESENT

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

CHECK_PARAMS_IN_IS_SESSION_CONFIGURATION_SUPPORTED

启用后，isSessionConfigurationSupported 还会检查会话参数的兼容性（如果 HAL 支持）。

DEFAULT_RESCIND_BAL_PRIVILEGES_FROM_PENDING_INTENT_CREATOR

启用后，PendingIntent 的创建者默认会阻止后台 activity 启动。

如需详细了解此变更，请参阅 Android 15 行为变更页面中 与安全后台 activity 启动有关的部分。

DEPRECATE_UI_FONT

启用后，当应用在搭载 Android 15 或更高版本的设备上运行时，elegantTextHeight TextView 属性默认变为 true，从而将默认使用的紧凑型字体替换为更易于阅读的字体，以用于一些具有较大垂直指标的脚本。

如需详细了解此变更，请参阅 Android 15 行为变更页面中关于 elegantTextHeight 属性默认值为 true 的部分。

DOWNSCALED

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

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

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

DOWNSCALED_INVERSE

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

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

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

DOWNSCALE_30

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

DOWNSCALE_35

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

DOWNSCALE_40

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

DOWNSCALE_45

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

DOWNSCALE_50

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

DOWNSCALE_55

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

DOWNSCALE_60

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

DOWNSCALE_65

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

DOWNSCALE_70

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

DOWNSCALE_75

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

DOWNSCALE_80

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

DOWNSCALE_85

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

DOWNSCALE_90

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

DO_NOT_CLONE_IN_ARRAYS_AS_LIST

启用后，在使用 Arrays.asList(...).toArray() 时，所得数组的组件类型现在是 Object，而不是底层数组元素的类型。因此，以下代码会抛出 ClassCastException：

String[] elements = (String[]) Arrays.asList("one", "two").toArray();

在这种情况下，为了在生成的数组中保留 String 作为组件类型，您可以改用 Collection.toArray(Object[])：

String[] elements = Arrays.asList("two", "one").toArray(new String[0]);

如需详细了解此变更，请参阅 Android 15 行为变更页面中有关 OpenJDK API 变更的部分。

ENABLE_BUNDLE_LAUNCH_ACTIVITY_ITEM

启用后，为防止任何现有应用在非 SDK 使用 ClientTransaction#getActivityToken() 时出现应用兼容性问题，仅允许捆绑 LaunchActivityItem。

ENABLE_MATCH_LOCAL_NETWORK

启用后，应用默认会从本地网络接收网络回调。以 Android 14（API 级别 34）或更低版本为目标平台的应用仍需向 NetworkRequest 的 NetworkCapabilities 添加 NetworkCapabilities.NET_CAPABILITY_LOCAL_NETWORK，才能从本地网络接收 ConnectivityManager.NetworkCallback。

ENABLE_STRICT_FORMATTER_VALIDATION

启用后，在使用 String.format() 和 Formatter.format() API 时，对实参索引、标志、宽度和精度的验证会更加严格。

如需详细了解此变更，请参阅 Android 15 行为变更页面中有关 OpenJDK API 变更的部分。

ENFORCE_EDGE_TO_EDGE

启用后，在搭载 Android 15 或更高版本的设备上，应用默认会以无边框模式显示。

如需详细了解此变更，请参阅 Android 15 行为变更页面中有关 全屏强制执行的部分。

ENFORCE_STRICT_QUERY_BUILDER

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

FGS_BOOT_COMPLETED_RESTRICTIONS

启用后，禁止从 BOOT_COMPLETED 广播启动前台服务（以下类型除外）：

• ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION
• ServiceInfo.FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
• ServiceInfo.FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
• ServiceInfo.FOREGROUND_SERVICE_TYPE_HEALTH
• ServiceInfo.FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
• ServiceInfo.FOREGROUND_SERVICE_TYPE_SPECIAL_USE

如需详细了解此变更，请参阅 Android 15 行为变更页面中 与 BOOT_COMPLETED 广播接收器启动前台服务有关的限制部分。

FGS_INTRODUCE_TIME_LIMITS

启用后，某些类型的前台服务会有时间限制。如果违规类型的前台服务未在分配的时间限制内停止，则会通过 Service.onTimeout(int, int) 收到回调，然后必须在几秒钟内停止。如果应用未能做到这一点，系统会将其声明为 ANR。

如需详细了解此变更，请参阅 Android 15 行为变更页面中有关 数据同步和 媒体处理前台服务类型的超时行为的部分。

FGS_SAW_RESTRICTIONS

启用后，除非系统警报窗口已具有系统叠加窗口，否则会针对所有类型停用系统警报窗口中的前台服务后台启动。

如需详细了解此变更，请参阅 Android 15 行为变更页面中 与应用持有 SYSTEM_ALERT_WINDOW 权限时启动前台服务有关的限制部分。

FORCE_DISABLE_HEVC_SUPPORT

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

FORCE_ENABLE_HEVC_SUPPORT

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

FORCE_NON_RESIZE_APP

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

FORCE_RESIZE_APP

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

GWP_ASAN

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

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

IS_DEVICE_OWNER_USER_AWARE

启用后，isDeviceOwnerApp(String) 方法将使用上下文中所含的用户。对于以 Android 14（API 级别 34）或更低版本为目标平台的应用，将使用调用进程的用户 (Process.myUserHandle())。

MANAGE_GLOBAL_ZEN_VIA_IMPLICIT_RULES

启用后，应用将无法再更改设备上“请勿打扰”(DND) 的全局状态或政策（无论是通过修改用户设置还是关闭“请勿打扰”模式）。应用必须提供 AutomaticZenRule，系统会将其与现有的“最严格的政策胜出”方案相结合，形成全局政策。

如需详细了解此变更，请参阅 Android 15 行为变更页面中关于 应用何时可以修改“请勿打扰”模式的全局状态的变更的部分。

NATIVE_HEAP_ZERO_INIT

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

NATIVE_MEMTAG_ASYNC

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

NATIVE_MEMTAG_SYNC

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

OVERRIDE_ANY_ORIENTATION

启用后，此变更允许应用以下屏幕方向替换，无论 activity 请求的屏幕方向如何：

• OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE
• OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR
• OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

OVERRIDE_ANY_ORIENTATION_TO_USER

启用后，启用 SCREEN_ORIENTATION_USER，该属性会替换 activity 请求的任何屏幕方向。如果启用了此替换项，则可以替换固定屏幕方向的应用，使其在大屏设备上全屏显示。ignoreOrientationRequest

OVERRIDE_CAMERA_COMPAT_DISABLE_FREEFORM_WINDOWING_TREATMENT

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

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

使用此标志可针对对处理效果不佳的应用停用兼容性处理。

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

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

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

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

OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION

启用后，可确保用户在启动 MediaProjection 会话时可以选择捕获单个应用或整个屏幕，从而替换 MediaProjectionConfig#createConfigForDefaultDisplay 的使用。

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

为应用启用 SCREEN_ORIENTATION_REVERSE_LANDSCAPE。除非还启用了 OVERRIDE_ANY_ORIENTATION，否则只有当 activity 指定横屏方向时，系统才会使用 SCREEN_ORIENTATION_REVERSE_LANDSCAPE。启用此变更有助于您测试应用在以下设备上的行为差异：横向屏幕方向对应于 Surface.ROTATION_90 的设备，以及横向屏幕方向对应于 Surface.ROTATION_270 的设备。

OVERRIDE_LAYOUT_IN_DISPLAY_CUTOUT_MODE

启用后，会覆盖刘海屏模式行为中的布局。仅当未强制执行全屏显示时，此设置才会生效。

OVERRIDE_MIN_ASPECT_RATIO

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

• OVERRIDE_MIN_ASPECT_RATIO_LARGE
• OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
• OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

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

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

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

OVERRIDE_MIN_ASPECT_RATIO_LARGE

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

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

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

OVERRIDE_MIN_ASPECT_RATIO_ONLY_FOR_CAMERA

启用后，限制强制应用指定最小宽高比的处理，以便仅在应用连接到相机时应用这些处理。

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

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

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

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

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

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

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

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

PARSE_CONTENT_DISPOSITION_USING_RFC_6266

启用后，允许解析符合 RFC 6266 的 Content-Disposition 标头。具体而言，这有助于解析可以使用不同字符编码的 filename* 值。

RATE_LIMIT_TOASTS

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

STREAM_INT_DIFFERS_FROM_NEXT_INT

启用后，Random.ints() 方法现在返回的数字序列与 Random.nextInt() 方法返回的数字序列不同。这是 https://bugs.openjdk.org/browse/JDK-8301574 中的更改所致。

如需详细了解此变更，请参阅 Android 15 行为变更页面中有关 OpenJDK API 变更的部分。

USE_EXPERIMENTAL_COMPONENT_ALIAS

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

USE_NEW_ISO_LOCALE_CODES

启用后，希伯来语、意第绪语和印度尼西亚语的语言代码不再转换为其过时的形式（希伯来语：iw、意第绪语：ji 和印度尼西亚语：in）。

如需详细了解此变更，请参阅 Android 15 行为变更页面中有关 OpenJDK API 变更的部分。