兼容性框架变更 (Android 14)

ACCESS_SHARED_IDENTITY

如果启动应用选择通过启动此 activity 并使用 ActivityOptions 的实例来共享其身份，且 ActivityOptions.setShareIdentityEnabled(boolean) 是以 true 的值调用的，或者如果启动的 activity 的 UID 与启动应用的 UID 相同，则授予对启动应用身份的访问权限。启用此变更并且满足其中某项要求后，activity 就可以分别通过 Activity.getLaunchedFromUid() 和 Activity.getLaunchedFromPackage() 访问启动应用的 UID 和软件包名称。

ANR_PRE_UDC_APIS_ON_SLOW_RESPONSES

启用后，如果应用在 Android 13（API 级别 33）或更低版本中的 API 和功能上响应缓慢，则会触发“应用无响应”(ANR) 消息。

AUTHORITY_ACCESS_CHECK_CHANGE_ID

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，允许在所有与同步相关的 API 上检查发起调用 UID 的访问权限。

CAMERA_MIC_INDICATORS_NOT_PRESENT

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

DEFAULT_RESCIND_BAL_PRIVILEGES_FROM_PENDING_INTENT_SENDER

现在，当应用使用 PendingIntent#send() 或类似方法发送 PendingIntent 时，如果它想要授予自己的后台 activity 启动待处理 intent 的启动特权，则必须选择启用。

如需详细了解此变更，请参阅 Android 14 行为变更页面中与从后台启动 activity 有关的其他限制部分。

DETACH_THROWS_ISE_ONLY

用于限制 #detachImage 抛出正确异常的标志。

#detachImage 记录为在出现错误时抛出 IllegalStateException；如果 Surface 在分离 Image 时被丢弃，则相应的原生辅助方法会抛出 RuntimeException。

这种之前未记录的异常行为会持续到 Android 13（API 级别 33）。

在 Android 13（API 级别 33）之后，原生辅助方法仅会按照文档抛出 IllegalStateExceptions。

启用此更改后，#detachImage 仅在分离映像的过程中遇到错误时抛出 IllegalStateException。对于以 Android 13（API 级别 33）及更低版本为目标平台的应用，其行为保持不变。

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% 的显示屏上运行。

ENABLE_PLATFORM_MDNS_BACKEND

以 Android 14 或更高版本为目标平台的应用使用平台集成的 mDNS 实现作为后端，而以先前版本为目标平台的应用会继续使用旧版网络服务发现 (NSD) 后端（旧版原生守护程序为 NsdManager 后端）。

ENABLE_SELF_CERTIFIED_CAPABILITIES_DECLARATION

以 Android 14 或更高版本为目标平台的应用启用了自行认证功能检查。如需了解详情，请参阅 NetworkCapabilities。

ENFORCE_PACKAGE_VISIBILITY_FILTERING

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，要求应用在清单中声明软件包可见性需求，以便访问 AccountManager API。

ENFORCE_READ_ONLY_JAVA_DCL

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，需要将所有动态加载的文件标记为只读。这可以防止动态加载的文件被恶意操作方意外覆盖。

如需详细了解此变更，请参阅 Android 14 行为变更页面中有关 更安全的动态代码加载的部分。

ENFORCE_STRICT_QUERY_BUILDER

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

EXACT_LISTENER_ALARMS_DROPPED_ON_CACHED

当调用应用进入缓存状态时，预期会收到 AlarmManager.OnAlarmListener 回调的确切闹钟会被舍弃。

如需详细了解 Android 14 中对精确闹钟的变更，请参阅 默认拒绝设定精确的闹钟。

FGS_TYPE_CHECK_FOR_INSTANT_APPS

启用后，免安装应用必须为应用清单文件中声明的所有服务指定适当的前台服务类型。

如需详细了解此变更，请参阅介绍前台服务类型变更页面。

FGS_TYPE_NONE_DEPRECATION_CHANGE_ID

启用后，以 Android 14（API 级别 34）及更高版本为目标平台且使用已废弃的 FOREGROUND_SERVICE_TYPE_NONE 类型启动前台服务的应用会导致日志中显示警告。

如需详细了解此变更，请参阅介绍前台服务类型变更页面。

FGS_TYPE_NONE_DISABLED_CHANGE_ID

启用后，以 Android 14（API 级别 34）及更高版本为目标平台且使用已废弃的 FOREGROUND_SERVICE_TYPE_NONE 类型启动前台服务的应用会导致异常。

如需详细了解此变更，请参阅介绍前台服务类型变更页面。

FGS_TYPE_PERMISSION_CHANGE_ID

启用后，如果应用以 Android 14（API 级别 34）及更高版本为目标平台，且在启动前台服务时没有与该前台服务类型相关联的必要权限，则会导致 SecurityException。

如需详细了解此变更，请参阅介绍前台服务类型变更页面。

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 指南。

IMPLICIT_INTENTS_ONLY_MATCH_EXPORTED_COMPONENTS

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，必须导出组件，才能通过隐式 intent 调用这些组件。如果某个组件未导出和调用，则将从接收器列表中被移除。这专门适用于 activity 和广播。

如需详细了解此变更，请参阅 Android 14 行为变更页面中 与隐式 intent 和待处理 intent 有关的限制部分。

MEDIA_PROJECTION_PREVENTS_REUSING_CONSENT

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，应用必须在每次 MediaProjection 捕获会话之前征得用户同意。

如需详细了解此变更，请参阅 Android 14 行为变更页面中有关 每次 MediaProjection 捕获会话都需要征得用户同意的部分。

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_CAMERA_RESIZABLE_AND_SDK_CHECK

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

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

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

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_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_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。

RATE_LIMIT_TOASTS

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

REJECT_NEGATIVE_NETWORK_ESTIMATES

启用后，会要求估算的网络字节数为非负数。

REQUIRE_NETWORK_CONSTRAINT_FOR_NETWORK_JOB_WORK_ITEMS

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，如果所包含的 JobWorkItem 指示网络使用情况，则要求托管作业指定网络约束条件。

REQUIRE_NETWORK_PERMISSIONS_FOR_CONNECTIVITY_JOBS

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，要求应用在安排具有连接约束条件的作业时同时指定 INTERNET 和 ACCESS_NETWORK_STATE 权限。

THROW_ON_INVALID_DATA_TRANSFER_IMPLEMENTATION

对于以 Android 14（API 级别 34）及更高版本为目标平台的应用，如果应用在指定用户发起的数据传输作业时未正确实现所有必要的数据传输 API，系统会抛出异常。

如需详细了解此变更，请参阅介绍如何 将前台服务迁移到用户发起的数据传输作业的页面。

USE_EXPERIMENTAL_COMPONENT_ALIAS

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