功能和 API 概览

Android 14 面向开发者引入了一些出色的新功能和 API。以下几部分内容可帮助您了解适用于您的应用的功能并开始使用相关 API。

有关新增、修改和移除的 API 的详细列表，请参阅 API 差异报告。如需详细了解新的 API，请访问 Android API 参考文档，新 API 会突出显示以方便查看。此外，如需了解平台变更可能会在哪些方面影响您的应用，请务必查看会影响以 Android 14 为目标平台的应用和所有应用的 Android 14 行为变更。

国际化

各应用语言偏好设定

Android 14 expands on the per-app language features that were introduced in Android 13 (API level 33) with these additional capabilities:

• Automatically generate an app's localeConfig: Starting with Android Studio Giraffe Canary 7 and AGP 8.1.0-alpha07, you can configure your app to support per-app language preferences automatically. Based on your project resources, the Android Gradle plugin generates the LocaleConfig file and adds a reference to it in the final manifest file, so you no longer have to create or update the file manually. AGP uses the resources in the res folders of your app modules and any library module dependencies to determine the locales to include in the LocaleConfig file.

• Dynamic updates for an app's localeConfig: Use the setOverrideLocaleConfig() and getOverrideLocaleConfig() methods in LocaleManager to dynamically update your app's list of supported languages in the device's system settings. Use this flexibility to customize the list of supported languages per region, run A/B experiments, or provide an updated list of locales if your app utilizes server-side pushes for localization.

• App language visibility for input method editors (IMEs): IMEs can utilize the getApplicationLocales() method to check the language of the current app and match the IME language to that language.

语法变化 API

有 30 亿人在使用区分性别的语言，此类语言的语法类别（例如名词、动词、形容词和介词）会根据您交谈所涉及的人或物的性别而变化。传统上，许多区分性别的语言使用阳性语法性别作为默认或通用性别。

以错误的语法性别来称呼用户，例如以阳性语法性别来称呼女性，可能会对她们的表现和态度产生负面影响。相比之下，界面语言如果能正确反映用户的语法性别，就可以提高用户互动度，并提供更个性化、更自然的用户体验。

为帮助您针对区分性别的语言构建以用户为中心的界面，Android 14 引入了语法变化 API，让您无需重构应用便能添加对语法性别的支持。

地区偏好设置

Regional preferences enable users to personalize temperature units, the first day of the week, and numbering systems. A European living in the United States might prefer temperature units to be in Celsius rather than Fahrenheit and for apps to treat Monday as the beginning of the week instead of the US default of Sunday.

New Android Settings menus for these preferences provide users with a discoverable and centralized location to change app preferences. These preferences also persist through backup and restore. Several APIs and intents—such as getTemperatureUnit and getFirstDayOfWeek— grant your app read access to user preferences, so your app can adjust how it displays information. You can also register a BroadcastReceiver on ACTION_LOCALE_CHANGED to handle locale configuration changes when regional preferences change.

To find these settings, open the Settings app and navigate to System > Languages & input > Regional preferences.

Regional preferences screen in Android system settings.

Temperature options for regional preferences in Android system settings.

无障碍

非线性字体放大至 200%

从 Android 14 开始，系统支持字体放大高达 200%，为弱视用户提供了符合网络内容无障碍指南 (WCAG) 的其他无障碍功能选项。

为防止屏幕上的大文本元素过于放大，系统会采用非线性放大曲线。这种放大策略意味着大号文本的放大比例不会与较小的文本相同。非线性字体放大有助于保持不同大小元素之间的比例层次结构，同时缓解高级别线性文本放大存在的问题（例如文本被截断或文本因非常大的显示大小而难以阅读）。

使用非线性字体放大测试应用

在设备的无障碍设置中启用最大字号，以测试应用。

如果您已使用放大像素 (sp) 单位来定义文本大小，这些额外的选项和放大方面的改进将自动应用于应用中的文本。不过，您仍应在启用最大字号 (200%) 的情况下执行界面测试，确保应用能够正确应用字号，并且能够在不影响易用性的情况下适应较大的字号。

要启用 200% 字号，请按以下步骤操作：

1. 打开“设置”应用，然后依次前往无障碍 > 显示大小和文字。
2. 在字号选项中，点按加号 (+) 图标，直到启用最大字号设置，如本部分随附的图片所示。

针对文本大小使用放大像素 (sp) 单位

请务必始终以 sp 为单位指定文本大小。当应用使用 sp 单位时，Android 可以应用用户的首选文本大小，并相应地进行缩放。

不要为内边距或视图高度使用 sp 单位：使用非线性字体放大 sp 尺寸可能并不成比例，因此 4sp + 20sp 可能并不等于 24sp。

转换放大像素 (sp) 单位

使用 TypedValue.applyDimension() 从 sp 单位转换为像素，并使用 TypedValue.deriveDimension() 将像素转换为 sp。这些方法会自动应用适当的非线性放大曲线。

避免使用 Configuration.fontScale 或 DisplayMetrics.scaledDensity 对等式进行硬编码。由于字体放大现在是非线性的，因此这些字段不再准确。

用户体验

Sharesheet 自定义操作和经过改进的排名系统

Android 14 updates the system sharesheet to support custom app actions and more informative preview results for users.

Add custom actions

With Android 14, your app can add custom actions to the system sharesheet it invokes. To customize actions with sharesheets, create your custom ChooserAction using ChooserAction.Builder and specify a list of your ChooserActions as the Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS of the Intent created with Intent.createChooser.

Improve ranking of Direct Share targets

Android 14 uses more signals from apps to determine the ranking of the direct share targets to provide more helpful results for the user. To provide the most useful signal for ranking, report the shortcut usage by calling pushDynamicShortcut with a corresponding shortcut when user sends a message to a contact, and attach the corresponding capability "actions.intent.SEND_MESSAGE" to that shortcut by calling ShortcutInfoCompat.Builder#addCapabilityBinding("actions.intent.SEND_MESSAGE").

支持内置和自定义预测性返回动画

视频：预测性返回动画

Android 13 在开发者选项背后引入了预测性“返回主屏幕”动画。在已启用开发者选项的受支持应用中使用时，滑回手势会显示动画，表明返回手势会使应用退回到主屏幕。

Android 14 包含针对“预测性返回”的多项改进和新指南：

• 您可设置 android:enableOnBackInvokedCallback=true，以便为每个 activity 选择启用预测性返回系统动画，而不是为整个应用选择启用。
• 我们添加了新的系统动画，以配合 Android 13 中的“返回主屏幕”动画。新的系统动画是跨 activity 和跨任务的，您可在迁移到预测性返回后自动获得该动画。
• 我们为底部动作条、侧边动作条和搜索添加了新的 Material 组件动画。
• 我们制作了有关如何创建自定义应用内动画和转换的设计指南。
• 我们添加了许多新 API 来支持自定义的应用内转换动画：
  • handleOnBackStarted、handleOnBackProgressed、handleOnBackCancelled in OnBackPressedCallback
  • onBackStarted、onBackProgressed、onBackCancelled in OnBackAnimationCallback
  • 对于在用户滑回时进行响应的转换，请使用 overrideActivityTransition 而不是 overridePendingTransition。

在此 Android 14 预览版中，所有预测性返回功能都是位于开发者选项背后。请参阅与将您的应用迁移到预测性返回有关的开发者指南，以及与创建自定义应用内转换有关的开发者指南。

针对应用商店的改进

Android 14 引入了多个新的 PackageInstaller API，可帮助应用商店改善其用户体验。

注意：如果您开发了第三方应用商店，我们非常希望听取您的反馈，因此不妨试用这些 API，并将您的想法告诉我们！

下载之前请求批准安装

安装或更新应用可能需要用户批准。例如，当使用 REQUEST_INSTALL_PACKAGES 权限的安装程序尝试安装新应用时。在之前的 Android 版本中，只有在将 APK 写入安装会话并且提交会话后，应用商店才能请求用户批准。

从 Android 14 开始，requestUserPreapproval() 方法可让安装程序在提交安装会话之前请求用户批准。此项改进可让应用商店将任何 APK 的下载操作推迟到用户批准安装之后。此外，用户批准安装后，应用商店可以在后台下载并安装应用，而不会干扰用户。

承担未来更新的责任

借助新的 setRequestUpdateOwnership() 方法，安装程序可以向系统表明它打算负责将被安装的应用未来的更新。此功能可实现更新所有权强制执行，即仅允许更新所有者为应用安装自动更新。更新所有权强制执行有助于确保用户仅收到来自预期应用商店的更新。

任何其他安装程序（包括使用 INSTALL_PACKAGES 权限的安装程序）都必须获得用户的明确批准，才能安装更新。如果用户决定继续从其他来源安装更新，则会失去更新所有权。

在干扰性更低的情况下更新应用

应用商店通常希望避免更新正在使用的应用，因为这会导致应用正在运行的进程被终止，而这可能会中断用户正在执行的操作。

从 Android 14 开始，InstallConstraints API 让安装程序可以确保其应用更新在适当的时机进行。例如，应用商店可以调用 commitSessionAfterInstallConstraintsAreMet() 方法来确保仅在用户不再与相应应用互动时才进行更新。

无缝安装可选拆分

借助拆分 APK，应用的功能可以通过单独的 APK 文件提供，而不是以单体式 APK 的形式提供。借助拆分 APK，应用商店可以优化不同应用组件的提供。例如，应用商店可能会根据目标设备的属性进行优化。自在 API 级别 22 中引入以来，PackageInstaller API 一直支持拆分。

在 Android 14 中，setDontKillApp() 方法可让安装程序指明在安装新的拆分项时应用的运行进程不应终止。应用商店可以使用此功能，在用户使用应用时无缝安装应用的新功能。

注意：如果您在 Google Play 上分发应用，请考虑使用 Play Feature Delivery，以便允许应用的某些功能可按条件分发或按需下载。

检测用户何时截取设备屏幕截图

To create a more standardized experience for detecting screenshots, Android 14 introduces a privacy-preserving screenshot detection API. This API lets apps register callbacks on a per-activity basis. These callbacks are invoked, and the user is notified, when the user takes a screenshot while that activity is visible.

Note: The callback doesn't provide an image of the actual screenshot. It's up to your app to determine what appeared on the screen when the user took a screenshot.

图形

路径现在可查询和插值

Android 的 Path API 是一种强大且灵活的机制，可用于创建和渲染矢量图形，能够描边或填充路径，根据线段、二次曲线或立方曲线构建路径，执行布尔运算以获取更复杂的形状，或同时执行所有这些操作。但是无法了解 Path 对象中实际包含的内容；该对象的内部信息在创建后对于调用方是不透明的。

如需创建 Path，您可以调用 moveTo()、lineTo() 和 cubicTo() 等方法来添加路径片段。但无法询问该路径有哪些片段，因此您必须在创建时保留该信息。

从 Android 14 开始，您可以查询路径以了解其内部内容。首先，您需要使用 Path.getPathIterator API 获取 PathIterator 对象：

Kotlin

val path = Path().apply {
    moveTo(1.0f, 1.0f)
    lineTo(2.0f, 2.0f)
    close()
}
val pathIterator = path.pathIterator

Java

Path path = new Path();
path.moveTo(1.0F, 1.0F);
path.lineTo(2.0F, 2.0F);
path.close();
PathIterator pathIterator = path.getPathIterator();

接下来，您可以调用 PathIterator 逐个遍历片段，并检索每个片段的所有必要数据。以下示例使用了 PathIterator.Segment 对象，它会为您打包数据：

Kotlin

for (segment in pathIterator) {
    println("segment: ${segment.verb}, ${segment.points}")
}

Java

while (pathIterator.hasNext()) {
    PathIterator.Segment segment = pathIterator.next();
    Log.i(LOG_TAG, "segment: " + segment.getVerb() + ", " + segment.getPoints());
}

PathIterator 还有一个非分配版 next()，您可以在其中传入缓冲区来保存点数据。

查询 Path 数据的一个重要用例是插值。例如，您可能想在两个不同的路径之间添加动画（或变形）。为了进一步简化该用例，Android 14 针对 Path 还有一个新的 interpolate() 方法。假设两个路径具有相同的内部结构，interpolate() 方法会使用该插值结果创建一个新的 Path。以下示例返回了一个形状介于 path 和 otherPath 之间的一半（线性插值为 0.5）的路径：

Kotlin

val interpolatedResult = Path()
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, .5f, interpolatedResult)
}

Java

Path interpolatedResult = new Path();
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, 0.5F, interpolatedResult);
}

Jetpack graphics-path 库现已发布 Alpha 版，它也为早期版本的 Android 提供了类似的 API。

核心功能

OpenJDK 17 更新

Android 14 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases, including both library updates and Java 17 language support for app and platform developers.

The following features and improvements are included:

• Updated approximately 300 java.base classes to Java 17 support.
• Text Blocks, which introduce multi-line string literals to the Java programming language.
• Pattern Matching for instanceof, which allows an object to be treated as having a specific type in an instanceof without any additional variables.
• Sealed classes, which allow you restrict which classes and interfaces can extend or implement them.

Thanks to Google Play system updates (Project Mainline), over 600 million devices are enabled to receive the latest Android Runtime (ART) updates that include these changes. This is part of our commitment to give apps a more consistent, secure environment across devices, and to deliver new features and capabilities to users independent of platform releases.

Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.