功能與 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) 的應用程式語言瀏覽權限：輸入法編輯器可透過 getApplicationLocales() 方法檢查當前應用程式的語言，並和輸入法編輯器的語言進行比對。

文法轉變 API

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

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

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

地區偏好設定

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

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

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

Android 系统设置中的地区偏好设置界面。

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

無障礙設定

非線性字型縮放至 200%

自 Android 14 起，系統將支援高達 200% 的字型縮放功能，提供 視力不佳的使用者提供額外的無障礙服務選項， 無障礙內容規範 (WCAG)。

為避免畫面上的大型文字元素縮放過大，系統會採用系統做法 會套用非線性縮放曲線此縮放策略指的是大型文字 因此未像較小的文字一樣縮放非線性字型縮放功能 保留不同大小元素之間的比例階層 減少線性文字縮放為高角度的問題 (例如 截斷或因為超大型顯示而難以閱讀的文字 大小)。

使用非線性字型縮放測試應用程式

在裝置的無障礙設定中啟用字型大小上限 測試應用程式。

如果您已使用經過調整像素 (sp) 的單位定義文字大小，系統會自動將這些額外選項和縮放改善功能套用至應用程式中的文字。不過，您仍應啟用最大字型大小 (200%) 執行 UI 測試，確保應用程式能正確套用字型大小，並在不影響可用性的情況下，因應更大的字型大小。

如要啟用 200% 的字型大小，請按照下列步驟操作：

1. 開啟「設定」應用程式，然後依序前往「無障礙中心」>「無障礙設定」顯示大小和 文字。
2. 在「字型大小」選項中，輕觸加號 (+) 圖示，直到達字型大小上限為止，如本節隨附的圖片所示。

使用經過調整像素 (sp) 的單位處理文字大小

請記得一律以 sp 單位為單位指定文字大小。時間 應用程式使用 sp 單位，Android 可套用使用者偏好的文字大小 彈性調整資源配置

請勿使用 sp 單位做為邊框間距，也不應以隱含邊框間距來定義檢視畫面高度： 非線性字型縮放 sp 尺寸比例可能不一致，因此 4sp + 20sp 不一定等於 24sp。

轉換經過調整像素 (sp) 的單位

使用 TypedValue.applyDimension() 將 sp 單位轉換為像素，並使用 TypedValue.deriveDimension() 將像素轉換為 sp。這些方法會自動套用至適當的非線性縮放曲線。

避免使用硬式編碼方程式 Configuration.fontScale 或 DisplayMetrics.scaledDensity。因為字型縮放功能 非線性，scaledDensity 欄位已不準確。由於字型不再以單一標量值進行縮放，因此 fontScale 欄位應僅用於提供資訊。

使用 sp 單位處理 lineHeight

一律改用 sp 單位定義 android:lineHeight 因此，行高會隨著文字縮放。否則，如果您的文字 是 sp，但 lineHeight 的單位為 dp 或 px，則不會縮放，看起來會受到限制。 TextView 會自動修正 lineHeight，使其符合您的預期 只有在 textSize 和 lineHeight 都同時符合時，比例才會保留 以 sp 為單位定義。

相機和媒體

圖片的 Ultra HDR

標準動態範圍 (SDR) 與高動態範圍 (HDR) 圖片品質的比較圖。

Android 14 新增了對高動態範圍 (HDR) 圖片的支援，可在拍攝相片時保留更多感應器資訊，進而呈現鮮豔的色彩和更強烈的對比。Android 使用 Ultra HDR 格式，可與 JPEG 圖片完全相容，讓應用程式與 HDR 圖片無縫互動，並視需要以標準動態範圍 (SDR) 顯示。

當應用程式選擇為活動視窗使用 HDR UI (透過資訊清單項目或在執行階段呼叫 Window.setColorMode())，架構會自動在 UI 中以 HDR 格式轉譯這些圖片。您也可以在支援的裝置上拍攝壓縮的超高動態範圍靜態圖片。感應器可復原更多顏色，因此後製編輯的彈性更高。與 Ultra HDR 影像相關聯的 Gainmap 可用於使用 OpenGL 或 Vulkan 轉譯這些影像。

相機擴充功能中的變焦、對焦、後製預覽等功能

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

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

• 扩展程序专用元数据，例如用于调节扩展程序效果（例如背景虚化程度）的 CaptureRequest.EXTENSION_STRENGTH 和 EXTENSION_BOKEH。

• 相机扩展程序中的静态图片拍摄预览功能，该功能比最终图片更快地提供经过较少处理的图片。如果扩展程序的处理延迟时间增加，可以提供 postview 图片作为占位符以提升用户体验，并在稍后改用最终图片。您可以使用 CameraExtensionCharacteristics.isPostviewAvailable 检查此功能是否可用。然后，您可以将 OutputConfiguration 传递给 ExtensionSessionConfiguration.setPostviewOutputConfiguration。

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

• 支持在使用扩展程序时点按对焦和缩放。

感應器內變焦

當 CameraCharacteristics 中的 REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE 包含 SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW 時，應用程式可以使用進階感應器功能，透過 CaptureRequest 和 RAW 目標 (其串流用途已設為 CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW)，為經裁剪的 RAW 串流提供與全景視野相同的像素。透過實作要求覆寫控制項，更新後的相機可在其他相機控制項準備就緒前，提供縮放控制選項。

無損 USB 音訊

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

開發人員工作效率和工具

Credential Manager

Android 14 會新增 Credential Manager 做為平台 API，並透過使用 Google Play 服務的 Jetpack 程式庫，進一步支援 Android 4.4 (API 級別 19) 裝置。Credential Manager 的目標是透過 API 協助使用者輕鬆登入，這些 API 會透過使用者設定的憑證提供者擷取及儲存憑證。Credential Manager 可在單一 API 中支援多種登入方式，包括使用者名稱和密碼、密碼金鑰，以及聯合登入解決方案 (例如使用 Google 帳戶登入)。

密碼金鑰具有許多優點，舉例來說，密碼金鑰採用業界標準，可在不同作業系統和瀏覽器環境中運作，也能與網站和應用程式搭配使用。

如需更多資訊，請參閱 Credential Manager 和密碼金鑰說明文件，以及Credential Manager 和密碼金鑰相關網誌文章。

Health Connect

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 Connect 文档以及有关 Android Health 中的新功能的博文。

OpenJDK 17 更新

Android 14 将继续更新 Android 的核心库，以与最新 OpenJDK LTS 版本中的功能保持一致，包括适合应用和平台开发者的库更新和 Java 17 语言支持。

其中包含以下功能和改进：

• 将大约 300 个 java.base 类更新为支持 Java 17。
• 文本块 - 为 Java 编程语言引入了多行字符串字面量。
• instanceof 模式匹配：可让对象在 instanceof 中被视为具有特定类型，而无需任何额外的变量。
• 密封类：允许您限制哪些类和接口可以扩展或实现它们。

得益于 Google Play 系统更新 (Project Mainline)，6 亿多台设备能够接收包含这些更改的最新 Android 运行时 (ART) 更新。我们致力于为应用提供更加一致、安全的跨设备环境，并为用户提供独立于平台版本的新功能。

Java 和 OpenJDK 是 Oracle 及/或其关联公司的商标或注册商标。

應用程式商店改善項目

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

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

下载之前请求批准安装

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

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

承担未来更新的责任

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

任何其他安装程序（包括使用 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 根据来自应用的更多信号来确定直接共享目标的排名，以便为用户提供更实用的结果。为了提供最实用的排名信号，请遵循提高直接共享目标排名的准则。通讯应用还可以报告出站和入站消息的快捷方式使用情况。

共享表单中的“直接分享”行，如 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" 也是如此。

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

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

大螢幕使用者個別應用程式覆寫值

Note: This feature is included on devices running Android 14 QPR1 or higher.

Per-app overrides change the behavior of apps on large screen devices. For example, the OVERRIDE_MIN_ASPECT_RATIO_LARGE device manufacturer override sets the app aspect ratio to 16:9 regardless of the app's configuration.

Android 14 QPR1 enables users to apply per‑app overrides by means of a new settings menu on large screen devices.

應用程式分享螢幕畫面

注意： 這項功能適用於搭載 Android 14 QPR2 以上版本的裝置。

分享應用程式畫面功能可讓使用者在錄製螢幕內容時，分享應用程式視窗，而非整個裝置畫面。

透過應用程式螢幕分享功能，系統會從共用畫面中排除狀態列、導覽列、通知和其他系統 UI 元素。只會分享所選應用程式的內容。

應用程式螢幕分享功能可讓使用者執行多個應用程式，但只分享單一應用程式的內容，進而提升工作效率和隱私權。

Pixel 8 Pro 的 Gboard 支援 LLM 智慧回覆功能

在搭載 12 月功能更新的 Pixel 8 Pro 裝置上，開發人員可以試用 Gboard 中採用 Google Tensor 晶片的大型語言模型 (LLM) 所提供的更高品質智慧回覆功能。

這項功能目前僅在 WhatsApp、Line 和 KakaoTalk 提供美式英文的限量預覽版。你必須使用 Pixel 8 Pro 裝置，並將 Gboard 做為鍵盤。

如要試用這項功能，請先依序前往「設定」>「開發人員選項」>「AI Core 設定」>「啟用 Aicore 持續性」。

接著，在支援的應用程式中開啟對話，即可在 Gboard 的建議列中看到 LLM 支援的智慧回覆功能，以回覆傳入的訊息。

Gboard 會使用裝置端 LLM 提供更高品質的智慧回覆。

注意： 這項功能的預先發布版將在 12 月功能更新後開始在裝置上推出。如果您尚未看到新的智慧回覆行為，請等待幾天，然後再試一次。模型下載作業可能需要一段時間，因此建議你在 Wi-Fi 網路下過夜充電，以便加快下載速度。

圖形

路徑可供查詢及內插

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。

使用頂點和片段著色器的自訂網格

Android 长期以来一直支持使用自定义着色绘制三角网格，但输入网格格式仅限于一些预定义的属性组合。Android 14 增加了对自定义网格的支持，可将其定义为三角形或三角形条，并且可以选择是否编入索引。这些网格是使用自定义属性、顶点步长、可变以及使用 AGSL 编写的顶点着色器和片段着色器指定的。

顶点着色器定义了位置和颜色等变量，而片段着色器可以选择为像素定义颜色，通常是使用顶点着色器创建的变量。如果片段着色器提供颜色，则系统会使用绘制网格时选择的混合模式将其与当前 Paint 颜色混合。Uniform 可以传递到片段着色器和顶点着色器，以提高灵活性。

Canvas 的硬體緩衝區轉譯器

為協助使用 Android 的 Canvas API 以硬體加速繪製至 HardwareBuffer，Android 14 推出了 HardwareBufferRenderer。如果您的用途涉及透過 SurfaceControl 與系統合成器通訊，以便繪製低延遲畫面，這個 API 就特別實用。