兼容性框架变更 (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) 及更高版本为目标的应用，如果需要，允许安全活动显示在远程设备上。

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) 及更高版本为目标的应用，允许网页内容根据应用主题应用浅色或深色样式，并且在适当情况下，WebView 尝试通过算法变暗来使网页内容变暗。有关详细信息，请参阅 setAlgorithmicDarkeningAllowed(boolean)。

ENABLE_TOUCH_OPAQUE_ACTIVITIES

对于在 Android 13 (API 级别 33) 或更高版本上运行的应用，使活动在其任务边界内消耗所有触摸事件。

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 媒体功能的支持。应用应在其清单中声明其支持的媒体功能，但此标志可用于强制应用不支持 HEVC，从而在访问 HEVC 编码媒体时强制转码。设置此标志会覆盖应用的任何操作系统级别默认值。默认情况下禁用此标志，这意味着操作系统默认值优先。如果此标志和 FORCE_ENABLE_HEVC_SUPPORT 都已启用，则操作系统将忽略这两个标志。

FORCE_ENABLE_HEVC_SUPPORT

强制启用应用支持 HEVC 媒体功能。应用应在其清单中声明其支持的媒体功能，但此标志可用于强制应用支持 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 的当前值以及等于或低于 M 的目标 SDK，并将活动视为不可调整大小。在这种情况下，相机旋转和裁剪的值将仅取决于考虑当前显示旋转所需的补偿。

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

当对某个应用包启用此变更时，应用清单中给定的最小宽高比将被覆盖为最大的已启用宽高比，除非应用的清单值更高。

OVERRIDE_MIN_ASPECT_RATIO_LARGE

当同时启用 OVERRIDE_MIN_ASPECT_RATIO 时，为此软件包启用此变更会将活动的最小宽高比设置为 OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE 定义的大值。

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

当同时启用 OVERRIDE_MIN_ASPECT_RATIO 时，为此软件包启用此变更会将活动的最小宽高比设置为 OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE 定义的中等值。

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

当同时启用 OVERRIDE_MIN_ASPECT_RATIO 时，此变更会将任何其他强制活动最小宽高比为特定值（例如 OVERRIDE_MIN_ASPECT_RATIO_LARGE 和 OVERRIDE_MIN_ASPECT_RATIO_MEDIUM）的变更限制为也具有纵向方向的活动。

RATE_LIMIT_TOASTS

启用对 Toast.show() 调用次数的速率限制，以防止在有限时间内给用户带来过多 Toast 提示。在特定时间范围内尝试显示超出允许数量的 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 时未指定端口索引，即使设备本身已启用 MEP eUICC，系统也会通过始终使用端口索引 0 来保留现有行为。

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”软件包使用组件别名。