Funkcje i interfejsy API – przegląd

Android 14 wprowadza świetne funkcje i interfejsy API dla deweloperów. Poniższe informacje pomogą Ci poznać funkcje aplikacji i zacząć korzystać z powiązanych interfejsów API.

Szczegółową listę dodanych, zmodyfikowanych i usuniętych interfejsów API znajdziesz w raporcie porównawczym interfejsów API. Szczegółowe informacje o dodanych interfejsach API znajdziesz w dokumentacji interfejsu API Androida. W przypadku Androida 14 poszukaj interfejsów API dodanych na poziomie 34. Aby dowiedzieć się, w jakich obszarach zmiany w platformie mogą mieć wpływ na Twoje aplikacje, zapoznaj się ze zmianami w zachowaniu Androida 14 w przypadku aplikacji kierowanych na tę wersję systemu i wszystkich aplikacji.

Internacjonalizacja

Wybór języka według aplikacji

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

3 miliardy ludzi mówi językami z płcią: językami, w których kategorie gramatyczne (np. rzeczowniki, czasowniki, przymiotniki i przyimki) odmieniają się w zależności od płci osób i rzeczy, do których się zwracamy lub o których mówimy. Tradycyjnie wiele języków z płcią gramatyczną używa męskiej formy gramatycznej jako domyślnej lub uniwersalnej.

Zwracanie się do użytkowników w niewłaściwym rodzaju gramatycznym, np. do kobiet w męskim rodzaju gramatycznym, może negatywne wpłynąć na ich wyniki i postawę. Z kolei interfejs z językiem, który poprawnie odzwierciedla płeć gramatyczną użytkownika, może zwiększyć zaangażowanie użytkowników i zapewnić bardziej spersonalizowane i naturalne wrażenia.

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

Preferencje regionalne

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

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

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

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

Ułatwienia dostępu

nieliniowe skalowanie czcionki do 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 对方程进行硬编码。由于字体缩放是非线性的，因此 scaledDensity 字段不再准确。fontScale 字段应仅用于提供信息，因为字体不再使用单个标量值进行缩放。

对 lineHeight 使用 sp 单位

始终使用 sp 单位（而非 dp）定义 android:lineHeight，以便行高随文本一起缩放。否则，如果您的文本为 sp，而 lineHeight 以 dp 或 px 为单位，则文本无法缩放且看起来狭窄。TextView 会自动更正 lineHeight 以保留您预期的比例，但前提是以 sp 为单位同时定义 textSize 和 lineHeight。

Aparat i multimedia

Ultra HDR w przypadku zdjęć

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

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

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

Zoom, ostrość, podgląd i inne funkcje w rozszerzeniach aparatu

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

Zoom w czujniku

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

Bezstratny dźwięk przez USB

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

Narzędzia i produktywność programistów

Credential Manager

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

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

如需了解详情，请参阅 Credential Manager 和通行密钥文档以及介绍 Credential Manager 和通行密钥的博文。

Health Connect

Health Connect to repozytorium danych o zdrowiu i kondycji fizycznej użytkownika na urządzeniu. Umożliwia ona użytkownikom udostępnianie danych między ulubionymi aplikacjami i zarządzanie w jednym miejscu danymi, które chcą udostępniać tym aplikacjom.

Na urządzeniach z Androidem w wersjach starszych niż 14 aplikację Health Connect można pobrać ze Sklepu Google Play. Od Androida 14 Zarządzanie danymi o zdrowiu jest częścią platformy i otrzymuje aktualizacje w ramach aktualizacji systemowych Google Play bez konieczności osobnego pobierania. Dzięki temu Health Connect może być często aktualizowany, a Twoje aplikacje mogą korzystać z Health Connect na urządzeniach z Androidem w wersji 14 lub nowszej. Użytkownicy mogą korzystać z Health Connect w ustawieniach urządzenia, a ustawienia prywatności są zintegrowane z ustawieniami systemu.

Użytkownicy mogą zacząć korzystać z Health Connect bez konieczności pobierania osobnej aplikacji na urządzeniach z Androidem 14 lub nowszym.
Użytkownicy mogą kontrolować, które aplikacje mają dostęp do ich danych o zdrowiu i kondycji fizycznej, za pomocą ustawień systemu.

Health Connect zawiera kilka nowych funkcji w Androidzie 14, takich jak trasy treningów, które umożliwiają użytkownikom udostępnianie trasy treningu, którą można wyświetlić na mapie. Trasa to lista lokalizacji zapisanych w określonym przedziale czasu. Aplikacja może wstawiać trasy do sesji ćwiczeń, łącząc je ze sobą. Aby mieć pełną kontrolę nad tymi poufnymi danymi, użytkownicy muszą zezwolić na udostępnianie poszczególnych tras innym aplikacjom.

Więcej informacji znajdziesz w dokumentacji dotyczącej funkcji Health Connection oraz w poście na blogu Co nowego w Androidzie Health.

aktualizacje 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 及/或其关联公司的商标或注册商标。

Ulepszenia sklepów z aplikacjami

Android 14 wprowadza kilka interfejsów API PackageInstaller, które umożliwiają sklepom z aplikacjami poprawę wrażeń użytkowników.

Prośba o zatwierdzenie instalacji przed pobraniem

Instalacja lub aktualizacja aplikacji może wymagać zaakceptowania przez użytkownika. Na przykład gdy instalator korzystający z uprawnienia REQUEST_INSTALL_PACKAGES próbuje zainstalować nową aplikację. W poprzednich wersjach Androida sklepy z aplikacjami mogą prosić o pozwolenie użytkownika dopiero po zapisaniu plików APK w sesji instalacji i zaakceptowaniu sesji.

Od Androida 14 metoda requestUserPreapproval() pozwala instalatorom poprosić o pozwolenie użytkownika przed rozpoczęciem sesji instalacji. Ta funkcja umożliwia opóźnienie pobierania plików APK do momentu zatwierdzenia instalacji przez użytkownika. Ponadto po zatwierdzeniu instalacji przez użytkownika aplikacja może pobrać i zainstalować aplikację w tle bez przerywania pracy użytkownika.

Przejmowanie odpowiedzialności za przyszłe aktualizacje

Metoda setRequestUpdateOwnership() pozwala instalatorowi wskazać systemowi, że będzie odpowiedzialny za przyszłe aktualizacje instalowanej aplikacji. Ta funkcja umożliwia egzekwowanie własności aktualizacji, co oznacza, że tylko właściciel aktualizacji może instalować automatyczne aktualizacje aplikacji. Egzekwowanie własności aktualizacji pomaga zapewnić, aby użytkownicy otrzymywali aktualizacje tylko z oczekiwanego sklepu z aplikacjami.

Aby zainstalować aktualizację, każdy inny instalator, w tym korzystający z uprawnienia INSTALL_PACKAGES, musi uzyskać wyraźną zgodę użytkownika. Jeśli użytkownik zdecyduje się na przeprowadzenie aktualizacji z innego źródła, utraci prawo własności do aktualizacji.

Aktualizuj aplikacje w godzinach, w których nie zakłócasz pracy.

Sklepy z aplikacjami zwykle nie chcą aktualizować aplikacji, która jest aktywnie używana, ponieważ powoduje to przerwanie jej procesów, co może zakłócić działanie użytkownika.

Od Androida 14 interfejs API InstallConstraints daje instalatorom możliwość zapewnienia, że aktualizacje aplikacji będą się odbywać w odpowiednim momencie. Sklep z aplikacjami może na przykład wywołać metodę commitSessionAfterInstallConstraintsAreMet(), aby upewnić się, że aktualizacja zostanie zaakceptowana tylko wtedy, gdy użytkownik nie będzie już korzystać z aplikacji.

Bezproblemowe instalowanie opcjonalnych podziałów

W przypadku podzielonych plików APK funkcje aplikacji mogą być dostarczane w osobnych plikach APK, a nie jako monolityczny plik APK. Dzielone pliki APK umożliwiają sklepom z aplikacjami optymalizację dostarczania różnych komponentów aplikacji. Sklepy z aplikacjami mogą na przykład optymalizować na podstawie właściwości urządzenia docelowego. Interfejs API PackageInstaller obsługuje dzielenie na części od czasu wprowadzenia na poziomie 22 interfejsu API.

W Androidzie 14 metoda setDontKillApp() umożliwia instalatorowi wskazanie, że działające procesy aplikacji nie powinny zostać zakończone podczas instalowania nowych części. Sklepy z aplikacjami mogą używać tej funkcji do płynnego instalowania nowych funkcji aplikacji, gdy użytkownik z niej korzysta.

Pakiety metadanych aplikacji

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

Wykrywanie, kiedy użytkownicy robią zrzuty ekranu na urządzeniu

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

Interfejs użytkownika

Działania niestandardowe w panelu udostępniania i ulepszona kolejność

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

添加自定义操作

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

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

提高直接共享目标的排名

Android 14 根据来自应用的更多信号来确定直接共享目标的排名，以便为用户提供更实用的结果。为了提供最实用的排名信号，请遵循提高直接共享目标排名的准则。通讯应用还可以报告出站和入站消息的快捷方式使用情况。

共享表单中的“直接分享”行，如 1
所示

Obsługa wbudowanych i niestandardowych animacji przewidywanego przejścia wstecz

视频：预测性返回动画

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

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

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

Zastąpienia na urządzeniach z dużym ekranem od producenta

Zastąpienia dotyczące aplikacji umożliwiają producentom urządzeń zmianę działania aplikacji na urządzeniach z dużym ekranem. Na przykład zastąpienie FORCE_RESIZE_APP instruuje system, aby zmienił rozmiar aplikacji, aby pasowała do wyświetlanych wymiarów (unikając trybu zgodności rozmiaru), nawet jeśli w manifeście aplikacji ustawiono resizeableActivity="false".

Zastąpienia mają na celu poprawę wrażeń użytkowników na dużych ekranach.

Nowe właściwości pliku manifestu umożliwiają wyłączenie w przypadku aplikacji niektórych zastąpień producenta urządzenia.

Zastąpienia dla użytkowników na dużym ekranie na poziomie aplikacji

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

借助 Android 14 QPR1，用户可以在大屏设备上通过新的设置菜单应用按应用替换项。

Udostępnianie ekranu aplikacji

借助应用界面共享功能，用户可以在录制屏幕内容时共享应用窗口，而不是整个设备屏幕。

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

应用屏幕共享功能可让用户运行多个应用，但将内容共享限制为单个应用，从而提高工作效率并保护隐私。

Inteligentna odpowiedź na klawiaturze Gboard na Pixelu 8 Pro z wykorzystaniem LLM

在搭载 12 月功能分块的 Pixel 8 Pro 设备上，开发者可以在 Gboard 中试用质量更高的智能回复，这些回复由在 Google Tensor 上运行的设备端大语言模型 (LLM) 提供支持。

此功能目前仅在 WhatsApp、Line 和 KakaoTalk 中以美式英语的形式提供给用户进行小范围测试。此功能需要使用 Pixel 8 Pro 设备，并将 Gboard 用作键盘。

如需试用此功能，请先依次前往设置 > 开发者选项 > AiCore 设置 > 启用 Aicore 持久性，启用该功能。

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

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

Grafika

Ścieżki można przeszukiwać i interpolować.

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。

niestandardowe siatki z shaderami wierzchołkowymi i fragmentowymi,

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

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

sprzętowy renderowanie bufora dla Canvas

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