功能和 API 概览

Android 14 面向开发者引入了强大的功能和 API。下文可帮助您了解适用于您的应用的功能并开始使用相关 API。

如需查看添加、修改和移除的 API 的详细列表，请参阅 API 差异报告。如需详细了解添加的 API，请访问 Android API 参考文档。对于 Android 14，查找在 API 级别 34 中添加的 API。如需了解平台变更可能会在哪些方面影响您的应用，请务必查看以 Android 14 为目标平台的应用和所有应用的 Android 14 行为变更。

国际化

各应用语言偏好设定

Android 14 扩展了 Android 13（API 级别 33）中引入的按应用设定语言功能，并包含以下额外功能：

• 自动生成应用的 localeConfig：从 Android Studio Giraffe Canary 7 和 AGP 8.1.0-alpha07 开始，您可以将应用配置为自动支持各应用语言偏好设定。Android Gradle 插件会根据您的项目资源生成 LocaleConfig 文件，并在最终清单文件中添加对该文件的引用，这样您就不再需要手动创建或更新该文件。AGP 使用应用模块的 res 文件夹中的资源以及任何库模块依赖项来确定要在 LocaleConfig 文件中添加的语言区域。

• 动态更新应用的 localeConfig：使用 LocaleManager 方法中的 setOverrideLocaleConfig() 和 getOverrideLocaleConfig() 可以在设备的系统设置中动态更新应用的受支持语言列表。有了这种灵活性，您可以按区域自定义支持的语言列表、运行 A/B 实验，或者如果您的应用通过服务器端推送进行本地化，则可以提供更新后的语言区域列表。

• 输入法 (IME) 的应用语言可见性：IME 可以利用 getApplicationLocales() 方法查看当前应用的语言，并将 IME 语言与该语言进行匹配。

Grammatical Inflection API

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

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

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

地区偏好设置

用户可通过地区偏好设置对温度单位、一周的第一天和编号系统进行个性化设置。居住在美国的欧洲用户可能更希望使用摄氏度，而不是华氏度，并且希望应用将星期一视为一周的开始，而不是像美国那样默认从星期日开始。

新 Android 设置菜单包含这些偏好设置，使用户能够在一个位置集中发现这些应用更改偏好设置。这些偏好设置在备份和恢复设备后也会保持不变。多个 API 和 intent（例如 getTemperatureUnit 和 getFirstDayOfWeek）会为您的应用授予读取权限来访问用户偏好设置，因此您的应用可以调整其显示信息的方式。您还可以在 ACTION_LOCALE_CHANGED 上注册 BroadcastReceiver，以便在地区偏好设置发生更改时处理语言区域配置更改。

如需找到这些设置，请打开“设置”应用，然后依次前往系统 > 语言和输入法 > 地区偏好设置。

Android 系统设置中的地区偏好设置屏幕。

Android 系统设置中的地区偏好设置温度选项。

无障碍功能

非线性字体放大至 200%

Starting in Android 14, the system supports font scaling up to 200%, providing low-vision users with additional accessibility options that align with Web Content Accessibility Guidelines (WCAG).

To prevent large text elements on screen from scaling too large, the system applies a nonlinear scaling curve. This scaling strategy means that large text doesn't scale at the same rate as smaller text. Nonlinear font scaling helps preserve the proportional hierarchy between elements of different sizes while mitigating issues with linear text scaling at high degrees (such as text being cut off or text that becomes harder to read due to an extremely large display sizes).

Test your app with nonlinear font scaling

Enable the maximum font size in a device's accessibility settings to test your app.

If you already use scaled pixels (sp) units to define text sizing, then these additional options and scaling improvements are applied automatically to the text in your app. However, you should still perform UI testing with the maximum font size enabled (200%) to ensure that your app applies the font sizes correctly and can accommodate larger font sizes without impacting usability.

To enable 200% font size, follow these steps:

1. Open the Settings app and navigate to Accessibility > Display size and text.
2. For the Font size option, tap the plus (+) icon until the maximum font size setting is enabled, as shown in the image that accompanies this section.

Use scaled pixel (sp) units for text-sizes

Remember to always specify text sizes in sp units. When your app uses sp units, Android can apply the user's preferred text size and scale it appropriately.

Don't use sp units for padding or define view heights assuming implicit padding: with nonlinear font scaling sp dimensions might not be proportional, so 4sp + 20sp might not equal 24sp.

Convert scaled pixel (sp) units

Use TypedValue.applyDimension() to convert from sp units to pixels, and use TypedValue.deriveDimension() to convert pixels to sp. These methods apply the appropriate nonlinear scaling curve automatically.

Avoid hardcoding equations using Configuration.fontScale or DisplayMetrics.scaledDensity. Because font scaling is nonlinear, the scaledDensity field is no longer accurate. The fontScale field should be used for informational purposes only because fonts are no longer scaled with a single scalar value.

Use sp units for lineHeight

Always define android:lineHeight using sp units instead of dp, so the line height scales along with your text. Otherwise, if your text is sp but your lineHeight is in dp or px, it doesn't scale and looks cramped. TextView automatically corrects the lineHeight so that your intended proportions are preserved, but only if both textSize and lineHeight are defined in sp units.

摄像头和媒体

图片 Ultra HDR

An illustration of Standard Dynamic Range (SDR) versus High Dynamic Range (HDR) image quality.

Android 14 adds support for High Dynamic Range (HDR) images that retain more of the information from the sensor when taking a photo, which enables vibrant colors and greater contrast. Android uses the Ultra HDR format, which is fully backward compatible with JPEG images, allowing apps to seamlessly interoperate with HDR images, displaying them in Standard Dynamic Range (SDR) as needed.

Rendering these images in the UI in HDR is done automatically by the framework when your app opts in to using HDR UI for its Activity Window, either through a manifest entry or at runtime by calling Window.setColorMode(). You can also capture compressed Ultra HDR still images on supported devices. With more colors recovered from the sensor, editing in post can be more flexible. The Gainmap associated with Ultra HDR images can be used to render them using OpenGL or Vulkan.

相机扩展程序中的缩放、对焦、Postview 等功能

Android 14 升级并改进了相机扩展，使应用能够处理更长的处理时间，从而支持在受支持的设备上使用弱光摄影等计算密集型算法来改进图像。在使用相机扩展功能时，这些功能可让用户获得更可靠的体验。这些改进的示例包括：

• 动态静态拍摄的处理延迟时间估算值会根据当前的场景和环境条件提供更准确的静态拍摄延迟时间估算值。调用 CameraExtensionSession.getRealtimeStillCaptureLatency() 以获取具有两种延迟时间估算方法的 StillCaptureLatency 对象。getCaptureLatency() 方法返回 onCaptureStarted 和 onCaptureProcessStarted() 之间的估计延迟时间，getProcessingLatency() 方法返回 onCaptureProcessStarted() 与最终处理后的帧可用之间的估计延迟时间。
• 支持拍摄进度回调，以便应用可以显示长时间运行的静态拍摄处理操作的当前进度。您可以使用 CameraExtensionCharacteristics.isCaptureProcessProgressAvailable 检查此功能是否可用，如果可用，请实现 onCaptureProcessProgressed() 回调，该回调会将进度（从 0 到 100）以参数形式传入。

• 特定于扩展程序的元数据，例如 CaptureRequest.EXTENSION_STRENGTH，用于调整扩展效果的程度，例如使用 EXTENSION_BOKEH 时的背景模糊处理程度。

• 相机扩展中的静态拍摄功能（用于静态拍摄）的后视图功能，相比最终图片，提供处理较少的图片。如果扩展程序延长了处理延迟时间，则可以提供浏览后图片作为占位符来改善用户体验，之后可针对最终图片关闭该功能。您可以通过 CameraExtensionCharacteristics.isPostviewAvailable 检查此功能是否可用。然后，您可以将 OutputConfiguration 传递给 ExtensionSessionConfiguration.setPostviewOutputConfiguration。

• 支持 SurfaceView，可实现更优化、更节能的预览渲染路径。

• 支持在使用扩展程序期间点按即可对焦和缩放。

传感器内缩放

当 CameraCharacteristics 中的 REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE 包含 SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW 时，您的应用可以使用高级传感器功能，通过使用 CaptureRequest 以及数据流用例设置为 CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW 的 RAW 目标，为剪裁后的 RAW 数据流提供与完整视野相同的像素。通过实现请求替换控件，更新后的摄像头让用户可在其他摄像头控件准备就绪之前实现缩放控制。

无损 USB 音频

Android 14 开始支持无损音频格式，通过 USB 有线耳机提供发烧级体验。您可以查询 USB 设备的首选混音器属性，注册监听器以监听首选混音器属性的变化，并使用 AudioMixerAttributes 类配置混音器属性。此类表示格式，例如声道掩码、采样率和混音器行为。该类允许直接发送音频，而不进行混音、音量调整或处理效果。

开发者工作效率和工具

Credential Manager

Android 14 adds Credential Manager as a platform API, with additional support back to Android 4.4 (API level 19) devices through a Jetpack Library using Google Play services. Credential Manager aims to make sign-in easier for users with APIs that retrieve and store credentials with user-configured credential providers. Credential Manager supports multiple sign-in methods, including username and password, passkeys, and federated sign-in solutions (such as Sign-in with Google) in a single API.

Passkeys provide many advantages. For example, passkeys are built on industry standards, can work across different operating systems and browser ecosystems, and can be used with both websites and apps.

For more information, see the Credential Manager and passkeys documentation and the blogpost about Credential Manager and passkeys.

健康数据共享

Health Connect 是设备端存储库，用于存储用户健康与健身数据。借助该平台，用户可以在自己喜爱的应用之间共享数据，并集中控制他们想要与这些应用共享的数据。

在搭载 Android 14 之前的 Android 版本的设备上，Health Connect 可作为应用从 Google Play 商店下载。从 Android 14 开始，Health Connect 已成为 Android 平台的一部分，可通过 Google Play 系统更新接收更新，而无需单独下载。这样，Health Connect 就可以经常更新，您的应用可以依赖于搭载 Android 14 或更高版本的设备上的 Health Connect 可用。用户可以通过设备的“设置”页面访问 Health Connect，并将隐私控制集成到系统设置中。

在搭载 Android 14 或更高版本的设备上，用户无需单独下载应用即可开始使用 Health Connect。

用户可以通过系统设置控制哪些应用可以访问其健康与健身数据。

Health Connect 在 Android 14 中包含多项新功能（例如锻炼路线），让用户可以共享锻炼路线，并在地图上直观呈现这些路线。路线是指一段时间内保存的位置列表，您的应用可以将路线插入锻炼时段，并将其关联起来。为确保用户可以完全控制这些敏感数据，用户必须允许与其他应用共享个别路由。

如需了解详情，请参阅 Health Connection 文档以及 Android Health 的新变化这篇博文。

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.

针对应用商店的改进

Android 14 introduces several PackageInstaller APIs that allow app stores to improve their user experience.

Note: If you develop a third-party app store, we would love to hear your feedback, so give these APIs a try and let us know what you think!

Request install approval before downloading

Installing or updating an app might require user approval. For example, when an installer making use of the REQUEST_INSTALL_PACKAGES permission attempts to install a new app. In prior Android versions, app stores can only request user approval after APKs are written to the install session and the session is committed.

Starting with Android 14, the requestUserPreapproval() method lets installers request user approval before committing the install session. This improvement lets an app store defer downloading any APKs until after the installation has been approved by the user. Furthermore, once a user has approved installation, the app store can download and install the app in the background without interrupting the user.

Claim responsibility for future updates

The setRequestUpdateOwnership() method allows an installer to indicate to the system that it intends to be responsible for future updates to an app it is installing. This capability enables update ownership enforcement, meaning that only the update owner is permitted to install automatic updates to the app. Update ownership enforcement helps to ensure that users receive updates only from the expected app store.

Any other installer, including those making use of the INSTALL_PACKAGES permission, must receive explicit user approval in order to install an update. If a user decides to proceed with an update from another source, update ownership is lost.

Update apps at less-disruptive times

App stores typically want to avoid updating an app that is actively in use because this leads to the app's running processes being killed, which potentially interrupts what the user was doing.

Starting with Android 14, the InstallConstraints API gives installers a way to ensure that their app updates happen at an opportune moment. For example, an app store can call the commitSessionAfterInstallConstraintsAreMet() method to make sure that an update is only committed when the user is no longer interacting with the app in question.

Seamlessly install optional splits

With split APKs, features of an app can be delivered in separate APK files, rather than as a monolithic APK. Split APKs allow app stores to optimize the delivery of different app components. For example, app stores might optimize based on the properties of the target device. The PackageInstaller API has supported splits since its introduction in API level 22.

In Android 14, the setDontKillApp() method allows an installer to indicate that the app's running processes shouldn't be killed when new splits are installed. App stores can use this feature to seamlessly install new features of an app while the user is using the app.

Note: If you distribute your app on Google Play, consider using Play Feature Delivery to allow certain features of your app to be delivered conditionally or downloaded on demand.

应用元数据软件包

从 Android 14 开始，Android 软件包安装程序可让您指定应用元数据（例如数据安全做法），以将其添加到 Google Play 等应用商店页面。

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

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.

用户体验

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.

Screenshot of custom actions on the sharesheet.

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, follow the guidance for improving rankings of your Direct Share targets. Communication apps can also report shortcut usage for outgoing and incoming messages.

Direct Share row in the sharesheet, as shown by 1

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

视频：预测性返回动画

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

大屏设备制造商按应用替换项

借助按应用替换项，设备制造商可以在大屏设备上更改应用的行为。例如，FORCE_RESIZE_APP 替换项指示系统调整应用大小以适应显示屏尺寸（避免尺寸兼容模式），即使在应用清单中设置了 resizeableActivity="false" 也是如此。

替换项旨在改善大屏设备上的用户体验。

借助新的清单属性，您可以为应用停用某些设备制造商替换项。

大屏用户按应用替换项

注意 ：此功能适用于搭载 Android 14 QPR1 或更高版本的设备。

按应用替换会更改大屏设备上应用的行为。例如，无论应用的配置如何，OVERRIDE_MIN_ASPECT_RATIO_LARGE 设备制造商替换项都会将应用宽高比设置为 16:9。

Android 14 QPR1 允许用户在大屏设备上通过新的设置菜单应用按应用替换项。

分享应用界面

注意 ：此功能适用于搭载 Android 14 QPR2 或更高版本的设备。

应用屏幕共享功能让用户能够在录制屏幕内容期间共享应用窗口，而非整个设备屏幕。

使用应用屏幕共享时，状态栏、导航栏、通知和其他系统界面元素会从共享显示屏中排除。系统只会分享所选应用的内容。

应用屏幕共享可让用户运行多个应用，但仅限单个应用共享内容，从而提高效率和隐私性。

Pixel 8 Pro 上搭载 LLM 的 Gboard 智能回复

On Pixel 8 Pro devices with the December Feature Drop, developers can try out higher-quality smart replies in Gboard powered by on-device Large Language Models (LLMs) running on Google Tensor.

This feature is available as a limited preview for US English in WhatsApp, Line, and KakaoTalk. It requires using a Pixel 8 Pro device with Gboard as your keyboard.

To try it out, first enable the feature in Settings > Developer Options > AiCore Settings > Enable Aicore Persistent.

Next, open a conversation in a supported app to see LLM-powered Smart Reply in Gboard's suggestion strip in response to incoming messages.

Gboard utilizes on-device LLMs to provide higher-quality smart replies.

Note: This feature preview will begin rolling out to devices following the December Feature Drop. If you're not seeing the new Smart Reply behavior yet, please wait a couple days and try again. Model downloads might also take some time, so charging your device on Wi-Fi overnight can help speed this up.

显卡

路径可查询和插值

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 库也为早期版本的 Android 启用了类似的 API。

使用顶点和 fragment 着色器的自定义网格

Android has long supported drawing triangle meshes with custom shading, but the input mesh format has been limited to a few predefined attribute combinations. Android 14 adds support for custom meshes, which can be defined as triangles or triangle strips, and can, optionally, be indexed. These meshes are specified with custom attributes, vertex strides, varying, and vertex and fragment shaders written in AGSL.

The vertex shader defines the varyings, such as position and color, while the fragment shader can optionally define the color for the pixel, typically by using the varyings created by the vertex shader. If color is provided by the fragment shader, it is then blended with the current Paint color using the blend mode selected when drawing the mesh. Uniforms can be passed into the fragment and vertex shaders for additional flexibility.

适用于 Canvas 的硬件缓冲区渲染程序

为协助使用 Android 的 Canvas API 通过硬件加速在 HardwareBuffer 中进行绘制，Android 14 引入了 HardwareBufferRenderer。当您的用例涉及通过 SurfaceControl 与系统合成器进行通信以实现低延迟绘制时，此 API 特别有用。