兼容性框架变更 (Android 13)

ACCOUNT_ACCESS_CHECK_CHANGE_ID

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，可在所有同步相关的 API 上针对调用 UID 启用帐户访问检查。

ALLOW_COPY_SOLID_COLOR_VIEW

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，即使启动画面仅显示纯色，也允许应用接收 SplashScreen.OnExitAnimationListener.onSplashScreenExit(SplashScreenView) 回调。

ALLOW_SECURE_ACTIVITY_DISPLAY_ON_REMOTE_DEVICE

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，允许在需要时在远程设备上显示安全 Activity。

BORINGLAYOUT_FALLBACK_LINESPACING

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，为 BoringLayout 启用回退文本行间距（行高）。

CALL_REDIRECTION_AUDIO_MODES

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，允许使用音频模式进行通话音频重定向。

CAMERA_MIC_INDICATORS_NOT_PRESENT

表明此设备支持摄像头和麦克风指示器。如果存在则返回 false，因为如果未找到该变更 ID，CompatChanges#isChangeEnabled 方法将返回 true。

CLEAR_SHOW_FORCED_FLAG_WHEN_LEAVING

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，防止 SHOW_FORCED 标志生效，除非调用者当前处于焦点状态。

DEFER_BOOT_COMPLETED_BROADCAST_CHANGE_ID

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，推迟 LOCKED_BOOT_COMPLETED 和 BOOT_COMPLETED 广播，直到 UID 中的任何进程首次启动。

DISALLOW_DEADLINES_FOR_PREFETCH_JOBS

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，不允许为预取任务（使用 JobInfo.Builder.setPrefetch(boolean)）设置截止日期（使用 JobInfo.Builder.setOverrideDeadline(long)）。预取任务旨在接近下一次应用启动时运行，因此不允许有截止日期。但是，系统不会丢弃或取消任何之前已安排好截止日期的预取任务。

应用无法维持一个永久安排且带有截止日期的预取任务。带有截止日期的预取任务会运行，但受此限制的应用将无法安排新的带截止日期的预取任务。如果通过使用 JobService.jobFinished(JobParameters, boolean) 或 JobService.onStopJob(JobParameters) 的返回值来重新安排任务并传入 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%。

DOWNSCALE_30

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 30% 的屏幕上。

DOWNSCALE_35

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 35% 的屏幕上。

DOWNSCALE_40

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 40% 的屏幕上。

DOWNSCALE_45

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 45% 的屏幕上。

DOWNSCALE_50

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 50% 的屏幕上。

DOWNSCALE_55

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 55% 的屏幕上。

DOWNSCALE_60

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 60% 的屏幕上。

DOWNSCALE_65

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 65% 的屏幕上。

DOWNSCALE_70

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 70% 的屏幕上。

DOWNSCALE_75

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 75% 的屏幕上。

DOWNSCALE_80

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 80% 的屏幕上。

DOWNSCALE_85

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 85% 的屏幕上。

DOWNSCALE_90

当同时启用了 DOWNSCALED 时，为软件包启用此更改会强制应用认为它正在运行在垂直和水平分辨率为实际显示屏 90% 的屏幕上。

DUMP_IGNORES_SPECIAL_ARGS

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，如果使用某些特殊参数调用 dumpsys activity，则不会调用 dump(String, FileDescriptor, PrintWriter, String[])。

DYNAMIC_RECEIVER_EXPLICIT_EXPORT_REQUIRED

启用后，要求应用在代码中为非受保护的广播注册接收器时，显式设置 Context.RECEIVER_EXPORTED 或 Context.RECEIVER_NOT_EXPORTED。

要了解更多信息，请参阅关于更安全地导出上下文注册接收器的部分。

ENABLE_PENDING_INTENT_BAL_OPTION

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，防止 PendingIntent 被滥用以启动后台活动。

ENABLE_SIMPLIFIED_DARK_MODE

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，允许 Web 内容根据应用的主题应用浅色或深色样式，并允许 WebView 在适当的情况下通过算法变暗来尝试加深 Web 内容。详情请参阅 setAlgorithmicDarkeningAllowed(boolean)。

ENABLE_TOUCH_OPAQUE_ACTIVITIES

对于在 Android 13（API 级别 33）或更高版本上运行的应用，使 Activity 在其任务范围内消耗所有触摸事件。

ENABLE_USE_EXACT_ALARM

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，允许特定类型的应用使用 Manifest.permission.USE_EXACT_ALARM 来安排精确闹钟。

ENFORCE_INTENTS_TO_MATCH_INTENT_FILTERS

组件将停止接收来自外部调用者的、与其声明的 Intent 过滤器不匹配的 Intent。当应用在其清单中注册导出的组件并添加 Intent 过滤器时，该组件可以被任何 Intent 启动，即使是不匹配 Intent 过滤器的 Intent。事实证明，许多开发者认为这一点违反直觉。如果在启动组件时未检查 Intent，在某些情况下，这可能允许第三方应用触发仅限内部使用的功能。

ENFORCE_STRICT_QUERY_BUILDER

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

FORCE_DISABLE_HEVC_SUPPORT

强制停用应用支持 HEVC 媒体能力。应用应在 manifest 中声明其支持的媒体能力，但此标记可用于强制应用不支持 HEVC，从而在访问 HEVC 编码的媒体时强制进行转码。设置此标记会覆盖任何操作系统级别的应用默认设置。它默认禁用，这意味着操作系统默认设置优先。如果同时启用此标记和 FORCE_ENABLE_HEVC_SUPPORT，操作系统会忽略这两个标记。

FORCE_ENABLE_HEVC_SUPPORT

强制启用应用支持 HEVC 媒体能力。应用应在 manifest 中声明其支持的媒体能力，但此标记可用于强制应用支持 HEVC，从而在访问 HEVC 编码的媒体时避免转码。设置此标记会覆盖任何操作系统级别的应用默认设置。它默认禁用，这意味着操作系统默认设置优先。如果同时启用此标记和 FORCE_DISABLE_HEVC_SUPPORT，操作系统会忽略这两个标记。

FORCE_NON_RESIZE_APP

强制应用此项的软件包不可调整大小。

FORCE_RESIZE_APP

强制所应用的包可调整大小。我们只允许在全屏窗口模式下调整大小，但不会强制应用进入可调整大小的多窗口模式。

GET_API_SIGNATURES_FROM_UICC_PORT_INFO

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，允许一张 SIM 卡同时激活多个 ICCID。此支持由多配置启用 (MEP) 提供。

GWP_ASAN

在应用中启用抽样原生内存错误检测。

要了解有关使用 GWP-ASan 的更多信息，请参阅 GWP-ASan 指南。

ICC_CLOSE_CHANNEL_EXCEPTION_ON_FAILURE

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，每当 ICC 关闭通道操作失败时，现在都会抛出异常。

MEDIA_CONTROL_SESSION_ACTIONS

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，基于 Notification.MediaStyle 通知的媒体控件现在拥有基于媒体会话 PlaybackState 的操作，而不是基于通知本身的操作。

要了解有关此项更改的更多信息，请参阅 Android 13 行为变更页面中关于媒体控件变更的部分。

NATIVE_HEAP_ZERO_INIT

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

NATIVE_MEMTAG_ASYNC

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

NATIVE_MEMTAG_SYNC

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

NOTIFICATION_LOG_ASSISTANT_CANCEL

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，使监听器能够理解助手提供的更具体的通知取消原因，而不是使用更通用的 REASON_LISTENER_CANCEL。

NOTIFICATION_PERM_CHANGE_ID

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，启用与通知运行时权限相关的行为变更。

要了解有关此项更改的更多信息，请参阅关于新的 通知运行时权限的页面。

NOTIFICATION_TRAMPOLINE_BLOCK_FOR_EXEMPT_ROLES

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，出于用户体验和性能方面的考虑，来自广播接收器或服务以响应通知和通知操作点击而启动的 Activity，对于先前豁免的角色持有者（浏览器）将被阻止。

OVERRIDABLE_COMPONENT_CALLBACKS

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，registerComponentCallbacks(ComponentCallbacks) 会将 ComponentCallbacks 添加到 Activity 或 ContextWrapper.getBaseContext()，而不是总是添加到 getApplicationContext()。

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

启用后，此变更 ID 会强制应用此项的软件包忽略 android:resizeableActivity 的当前值，以及目标 SDK 等于或低于 M 的情况，并将 Activity 视为不可调整大小。在这种情况下，相机旋转和裁剪的值将仅取决于考虑到当前显示旋转所需的补偿。

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

启用后，此变更 ID 会强制应用此项的软件包覆盖默认的相机旋转和裁剪行为，并始终返回 CaptureRequest.SCALER_ROTATE_AND_CROP_NONE。默认行为以及所有可能的覆盖组合在下表中进行了讨论。

OVERRIDE_MIN_ASPECT_RATIO

此变更是所有强制给定最小宽高比变更的总闸。启用此变更允许应用以下最小宽高比：

• OVERRIDE_MIN_ASPECT_RATIO_LARGE
• OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
• OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

当为某个应用包启用此变更后，除非应用 manifest 中的值更高，否则 manifest 中给出的最小宽高比将被覆盖为已启用的最大宽高比因子。

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

RATE_LIMIT_TOASTS

启用对 Toast.show() 调用次数的速率限制，以防止在有限时间内给用户显示过多消息而造成负担。任何在特定时间内尝试显示超过允许数量的 Toast 都会导致该 Toast 被丢弃。

REQUEST_LISTENING_MUST_MATCH_PACKAGE

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，调用 TileService.requestListeningState(Context, ComponentName) 时会检查调用包 (UID) 和目标 ComponentName 的包是否匹配。系统还会检查所使用的上下文是否可以代表当前用户执行操作。

RETURN_ADVANCED_VIDEO_PROFILES

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，控制 getAll(String, int) 返回的视频配置文件的类型。

SHOULD_RESOLVE_PORT_INDEX_FOR_APPS

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，允许 SIM 卡在不同端口上启用多配置启用 (MEP)。为了保持与运营商应用的向后兼容性，当以 API 级别 32 或更低级别为目标的应用在未指定端口索引的情况下调用 switchToSubscription 或下载 API 时，系统通过始终使用端口索引 0 来保留现有行为，即使设备本身已启用 MEP eUICC。

SWITCH_WITHOUT_PORT_INDEX_EXCEPTION_ON_DISABLE

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，每当调用 switchToSubscription() 而未传入 portIndex 来禁用订阅时，系统都会抛出异常。

THROW_ON_INVALID_PRIORITY_VALUE

对于以 Android 13（API 级别 33）及更高版本为目标平台的应用，当应用使用 JobInfo.Builder.setPriority(int) 提供无效优先级值时，系统会抛出异常。旧版应用可能错误地使用了此 API，因此如果它们继续使用该 API，调用将静默失败。

USE_EXPERIMENTAL_COMPONENT_ALIAS

启用后，系统允许 "android" 包使用组件别名。