功能和 API 概览

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

如需查看添加、修改和移除的 API 的详细列表，请参阅 API 差异报告。如需详细了解添加的 API，请访问 Android API 参考文档。对于 Android 14，查找在 API 级别 34 中添加的 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.

Grammatical Inflection API

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

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

为帮助您针对区分性别的语言构建以用户为中心的界面，Android 14 引入了 Grammatical Inflection 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%

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

标准动态范围 (SDR) 与高动态范围 (HDR) 图片质量的示意图。

Android 14 增加了对高动态范围 (HDR) 图片的支持，此类图片可在拍照时保留来自传感器的更多信息，从而实现鲜艳的色彩和更高的对比度。Android 采用 Ultra HDR 格式，这种格式可完全向后兼容 JPEG 图片，允许应用与 HDR 图片无缝互操作，从而根据需要以标准动态范围 (SDR) 显示图片。

当您的应用为其 Activity 窗口选择使用 HDR 界面（通过清单条目或在运行时通过调用 Window.setColorMode()）时，框架会自动在 HDR 界面中呈现这些图片。您还可以在支持的设备上拍摄压缩的 Ultra HDR 静态图片。从传感器中恢复的颜色越多，博文中的编辑效果就越灵活。与 Ultra HDR 图片关联的 Gainmap 可用于使用 OpenGL 或 Vulkan 渲染这些图片。

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

Android 14 upgrades and improves camera extensions, allowing apps to handle longer processing times, which enables improved images using compute-intensive algorithms like low-light photography on supported devices. These features give users an even more robust experience when using camera extension capabilities. Examples of these improvements include:

• Dynamic still capture processing latency estimation provides much more accurate still capture latency estimates based on the current scene and environment conditions. Call CameraExtensionSession.getRealtimeStillCaptureLatency() to get a StillCaptureLatency object that has two latency estimation methods. The getCaptureLatency() method returns the estimated latency between onCaptureStarted and onCaptureProcessStarted(), and the getProcessingLatency() method returns the estimated latency between onCaptureProcessStarted() and the final processed frame being available.
• Support for capture progress callbacks so that apps can display the current progress of long-running, still-capture processing operations. You can check if this feature is available with CameraExtensionCharacteristics.isCaptureProcessProgressAvailable, and if it is, you implement the onCaptureProcessProgressed() callback, which has the progress (from 0 to 100) passed in as a parameter.

• Extension specific metadata, such as CaptureRequest.EXTENSION_STRENGTH for dialing in the amount of an extension effect, such as the amount of background blur with EXTENSION_BOKEH.

• Postview Feature for Still Capture in camera extensions, which provides a less-processed image more quickly than the final image. If an extension has increased processing latency, a postview image could be provided as a placeholder to improve UX and switched out later for the final image. You can check if this feature is available with CameraExtensionCharacteristics.isPostviewAvailable. Then you can pass an OutputConfiguration to ExtensionSessionConfiguration.setPostviewOutputConfiguration.

• Support for SurfaceView allowing for a more optimized and power-efficient preview render path.

• Support for tap to focus and zoom during extension usage.

传感器内缩放

当 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 添加了 Credential Manager 作为平台 API，并通过使用 Google Play 服务的 Jetpack 库为 Android 4.4（API 级别 19）设备提供了额外的支持。凭据管理器旨在使用 API 通过用户配置的凭据提供程序检索和存储凭据，让用户更轻松地登录。凭据管理器在一个 API 中支持多种登录方法，包括用户名和密码、通行密钥和联合登录解决方案（如“使用 Google 账号登录”）。

通行密钥具有许多优势。例如，通行密钥基于业界标准构建，可在不同的操作系统和浏览器生态系统中使用，还可用于网站和应用。

如需了解详情，请参阅凭据管理器和通行密钥文档以及关于 Credential Manager 和通行密钥的博文。

健康数据共享

Health Connect 是设备端用户健康与健身数据的存储区。它 让用户可以在喜爱的应用之间共享数据 控制他们要与这些应用分享哪些数据

在搭载 Android 14 之前版本的 Android 设备上，Health Connect 会 可在 Google Play 商店中以应用的形式下载。从 Android 14 开始，Health Connect 将成为 Android 平台的一部分，并通过 Google Play 系统更新接收更新，而无需单独下载。这样，健康 Connect 可能会经常更新，并且您的应用可以依赖于 Health Connect 在搭载 Android 14 或更高版本的设备上可用。用户可以访问“健康”应用 通过设备中的“设置”连接，以及集成到 与系统设置有关

用户无需单独的 在搭载 Android 14 或更高版本的设备上下载应用。

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

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 引入了多个 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，以便允许应用的某些功能按条件分发或按需下载。

应用元数据软件包

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

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

为了打造更加标准化的屏幕截图检测体验，Android 14 引入了可保护隐私的屏幕截图检测 API。借助此 API，应用可以按 activity 注册回调。如果用户在该 activity 可见时截取屏幕截图，系统会调用这些回调并通知用户。

注意：该回调未提供实际屏幕截图的图片。用户截取屏幕截图后，屏幕上的内容将由您的应用决定。

用户体验

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

Android 14 更新了系统 Sharesheet，以便为用户提供自定义应用操作和信息更丰富的预览结果。

添加自定义操作

借助 Android 14，您的应用可以 向其调用的系统 Sharesheet 添加自定义操作。

分享表格中自定义操作的屏幕截图。

提高直接共享目标的排名

Android 14 根据来自应用的更多信号来确定直接 分享目标，以便为用户提供更实用的结果。 若要提供最有用的排名信号，请遵循 提高直接共享目标的排名。 通信应用还可以报告以下内容的快捷方式使用情况： 外发和传入的邮件

Sharesheet 中的“Direct Share”行，如 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 智能回复

在附带 12 月功能更新版的 Pixel 8 Pro 设备上，开发者可以在 Gboard 中体验更优质的智能回复，该功能由在 Google Tensor 上运行的设备端大型语言模型 (LLM) 提供支持。

此功能目前仅在 WhatsApp、Line 和 KakaoTalk 中推出美式英语的有限预览版。该功能需要使用一部支持 Gboard 的 Pixel 8 Pro 设备作为键盘。

如需试用，请先依次选择设置 > 开发者选项 > AiCore 设置 > 启用 Aicore Persistent 以启用该功能。

接下来，在受支持的应用中打开对话，以在 Gboard 的建议栏中看到由 LLM 提供支持的智能回复，以便响应收到的消息。

Gboard 利用设备端 LLM 提供更优质的智能回复。

注意 ：此功能预览版将在 12 月功能更新后开始面向设备推出。如果您还没有看到新的智能回复行为，请等待几天，然后重试。下载模型可能也需要一些时间，所以夜间通过 Wi-Fi 给设备充电有助于加快速度。

显卡

路径可查询和插值

Android 的 Path API 是一种强大且灵活的机制， 创建和渲染矢量图形，能够描边或填充 使用线段、二次曲线或立方曲线构造路径，执行 进行布尔运算，以获取更复杂的形状， 。其中一项限制是，我们不能确定 Path 对象；在创建后，对象的内部信息对调用方是不透明的。

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

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

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 早期版本

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

Android 长期支持绘制具有自定义着色的三角形网格，但输入网格格式被限制为几种预定义的属性组合。Android 14 增加了对自定义网格的支持，自定义网格可定义为三角形或三角形带，并且可以视需要编入索引。这些网格通过自定义属性、顶点步长、转换以及用 AGSL 编写的顶点和片段着色器指定。

顶点着色器定义变化，例如位置和颜色，而 fragment 着色器可以选择定义像素的颜色，通常通过使用顶点着色器创建的变化。如果 fragment 着色器提供了颜色，则它会使用绘制网格时选择的混合模式与当前的 Paint 颜色混合。您可以将 uniform 传递到 fragment 和顶点着色器中，以提高灵活性。

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

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