Funkcje i interfejsy API – przegląd

Android 14 wprowadza wiele przydatnych funkcji i interfejsów API dla deweloperów. Poniższe materiały 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 o różnicach w interfejsach API. Szczegółowe informacje o dodanych interfejsach API znajdziesz w dokumentacji interfejsu Android API. W przypadku Androida 14 poszukaj interfejsów API dodanych na poziomie 34. Aby dowiedzieć się więcej o obszarach, w których zmiany na platformie mogą mieć wpływ na Twoje aplikacje, zapoznaj się ze zmianami w działaniu Androida 14 w przypadku aplikacji kierowanych na Androida 14 i w przypadku 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

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

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

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

Starting in Android 14, the system supports font scaling up to 200%, providing users with additional accessibility options.

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.

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 渲染这些图片。

Powiększanie, ustawianie ostrości, podgląd po zrobieniu zdjęcia i inne funkcje w rozszerzeniach aparatu

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

Zoom na matrycy

当 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 gains support for lossless audio formats for audiophile-level experiences over USB wired headsets. You can query a USB device for its preferred mixer attributes, register a listener for changes in preferred mixer attributes, and configure mixer attributes using the AudioMixerAttributes class. This class represents the format, such as channel mask, sample rate, and behavior of the audio mixer. The class allows for audio to be sent directly, without mixing, volume adjustment, or processing effects.

Wydajność i narzędzia dla programistów

Credential Manager

Android 14 dodaje Credential Manager jako interfejs API platformy, z dodatkowym wsparciem dla urządzeń z Androidem 4.4 (poziom interfejsu API 19) za pomocą biblioteki Jetpack korzystającej z Usług Google Play. Credential Manager ułatwia użytkownikom logowanie się dzięki interfejsom API, które pobierają i przechowują dane logowania za pomocą dostawców danych logowania skonfigurowanych przez użytkownika. Credential Manager obsługuje wiele metod logowania, w tym logowanie przy użyciu nazwy użytkownika i hasła, kluczy dostępu i rozwiązań logowania sfederowanego (np. logowania przez Google) w jednym interfejsie API.

Klucze dostępu mają wiele zalet. Na przykład klucze dostępu oparte są na standardach branżowych, mogą działać w różnych systemach operacyjnych i ekosystemach przeglądarek oraz mogą być używane zarówno w witrynach, jak i w aplikacjach.

Więcej informacji znajdziesz w dokumentacji Menedżera danych uwierzytelniających i kluczy dostępu oraz w poście na blogu na temat Menedżera danych uwierzytelniających i kluczy dostępu.

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 中的新功能的博文。

Aktualizacje OpenJDK 17

Android 14 kontynuuje proces odświeżania podstawowych bibliotek Androida, aby dostosować je do funkcji najnowszych wersji OpenJDK LTS, w tym do aktualizacji bibliotek i obsługi języka Java 17 dla deweloperów aplikacji i platform.

Dostępne są następujące funkcje i ulepszenia:

  • Zaktualizowano około 300 klas java.base, aby obsługiwały Java 17.
  • Blokami tekstowymi, które wprowadzają do języka programowania Java wielowierszowe ciągi znaków.
  • dopasowywanie wzoru do instanceof, które umożliwia traktowanie obiektu jako mającego określony typ w instanceof bez żadnych dodatkowych zmiennych;
  • Zamknięte klasy, które umożliwiają ograniczenie zakresu klas i interfejsów, które mogą je rozszerzać lub implementować.

Dzięki aktualizacjom systemowym Google Play (projekt Mainline) ponad 600 milionów urządzeń może otrzymywać najnowsze aktualizacje środowiska wykonawczego Androida (ART), które zawierają te zmiany. Jest to część naszego zobowiązania do zapewnienia aplikacjom bardziej spójnego i bezpiecznego środowiska na różnych urządzeniach oraz udostępniania użytkownikom nowych funkcji i możliwości niezależnie od wersji platformy.

Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi firmy Oracle lub jej podmiotów stowarzyszonych.

Ulepszenia w sklepach 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 urządzenia

Aby zapewnić bardziej standardowe wykrywanie zrzutów ekranu, Android 14 wprowadza interfejs API do wykrywania zrzutów ekranu, który chroni prywatność. Ten interfejs API umożliwia aplikacjom rejestrowanie wywołań zwrotnych dla poszczególnych aktywności. Te wywołania zwrotne są wywoływane, a użytkownik jest powiadamiany, gdy zrobi zrzut ekranu podczas wyświetlania danego działania.

Interfejs użytkownika

Działania niestandardowe na arkuszu udostępniania i ulepszone rankingowanie

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 ustawień producenta urządzenia z dużym ekranem dla poszczególnych aplikacji

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

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

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

Zastąpienia ustawień aplikacji dla użytkowników dużych ekranów

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

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

Udostępnianie ekranu aplikacji

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

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

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

Inteligentna odpowiedź na klawiaturze Gboard na Pixelu 8 Pro oparta na 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 wyszukiwać 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łków i fragmentów

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

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

Renderowanie bufora sprzętowego w Canvas

Aby ułatwić korzystanie z interfejsu API Canvas w Androidzie do rysowania z przyspieszeniem sprzętowym w HardwareBuffer, Android 14 wprowadza HardwareBufferRenderer. Ten interfejs API jest szczególnie przydatne, gdy Twój przypadek użycia obejmuje komunikację z systemem kompozytor do SurfaceControl, by zapewnić małe opóźnienie rysunek.