Funkcje i interfejsy API – przegląd

Android 14 wprowadza świetne funkcje i interfejsy 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ę, w jakich obszarach zmiany na platformie mogą wpłynąć na Twoje aplikacje, zapoznaj się ze zmianami w Androidzie 14 w przypadku aplikacji kierowanych na Androida 14 i w przypadku wszystkich aplikacji.

Internacjonalizacja

Wybór języka według aplikacji

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

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

To help you build a user-centric UI for gendered languages, Android 14 introduces the Grammatical Inflection API, which lets you add support for grammatical gender without refactoring your app.

Preferencje regionalne

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.

Ułatwienia dostępu

Nieliniowe skalowanie czcionki do 200%

Od Androida 14 system obsługuje skalowanie czcionek do 200%, zapewniając użytkownikom niedowidzącym dodatkowe opcje ułatwień dostępu zgodne z wytycznymi Web Content Accessibility Guidelines (WCAG).

Aby zapobiec nadmiernemu skalowaniu dużych elementów tekstowych na ekranie, system stosuje nieliniową krzywą skalowania. Ta strategia skalowania oznacza, że duży tekst nie jest skalowany w taki sam sposób jak mniejszy tekst. Pomocne jest nieliniowe skalowanie czcionek zachowaj proporcjonalną hierarchię elementów o różnych rozmiarach, łagodzenie problemów z liniowym skalowaniem tekstu pod wysokim stopniem (np. lub tekst, który staje się trudniejszy do odczytania ze względu na bardzo duży wyświetlacz. rozmiarów).

Testowanie aplikacji za pomocą nieliniowego skalowania czcionek

Aby przetestować aplikację, włącz maksymalny rozmiar czcionki w ustawieniach ułatwień dostępu na urządzeniu.

Jeśli do definiowania rozmiaru tekstu używasz już skalowanych pikseli (sp), te dodatkowe opcje i ulepszone skalowanie zostaną automatycznie zastosowane do tekstu w aplikacji. Mimo to nadal zalecamy przeprowadzenie testów interfejsu z włączonym maksymalnym rozmiarem czcionki (200%), aby mieć pewność, że aplikacja poprawnie stosuje rozmiary czcionek i że może wyświetlać czcionki o większych rozmiarach bez wpływu na użyteczność.

Aby włączyć rozmiar czcionki 200%, wykonaj te czynności:

  1. Otwórz aplikację Ustawienia i kliknij Ułatwienia dostępu > Rozmiar interfejsu i tekst.
  2. W przypadku opcji Rozmiar czcionki klikaj ikonę plusa (+), aby ustawić maksymalną rozmiar jest włączony, tak jak na ilustracji obok .

Używanie skalowanych pikseli (sp) do określania rozmiaru tekstu

Pamiętaj, aby zawsze określać rozmiary tekstu w jednostkach SP. Gdy aplikacja używa jednostek sp, Android może zastosować preferowany rozmiar tekstu użytkownika i odpowiednio go skalować.

Nie używaj jednostek sp jako dopełnienia ani zdefiniuj wysokości widoku, zakładając niejawne dopełnienie: z nieliniowym skalowaniem czcionki wymiary sp mogą być nieproporcjonalne, więc 4sp + 20 sp może nie równać się 24 sp.

Przelicz skalowane jednostki pikseli (sp)

Użyj TypedValue.applyDimension(), aby przeliczyć jednostki SP na piksele i użyj funkcji TypedValue.deriveDimension(), aby konwertowanie pikseli na sp. Te metody stosują odpowiednie skalowanie nieliniowe automatycznie.

Unikaj umieszczania w kodzie stałych wartości równań za pomocą funkcji Configuration.fontScale lub DisplayMetrics.scaledDensity. Skalowanie czcionek jest nieliniowe, więc pole scaledDensity nie jest już dokładne. fontScale powinno być używane wyłącznie w celach informacyjnych, ponieważ czcionki nie są już przeskalowane do jednej wartości skalarnej.

Używanie jednostek sp do atrybutów lineHeight

Zawsze definiuj kolumnę android:lineHeight za pomocą jednostek SP dp, więc wysokość wiersza jest skalowana wraz z tekstem. Jeśli natomiast tekst jest w układzie sp, ale lineHeight jest w układzie dp lub px, nie będzie się skalować i będzie wyglądać ciasno. TextView automatycznie poprawia lineHeight zgodnie z proporcje są zachowywane, ale tylko wtedy, gdy zostaną uwzględnione zarówno textSize, jak i lineHeight zdefiniowane w jednostkach sp.

Aparat i multimedia

Ultra HDR w przypadku zdjęć

Ilustracja porównująca jakość obrazu w standardowym zakresie dynamiki (SDR) i w wysokim zakresie dynamiki (HDR).

Android 14 obsługuje obrazy High Dynamic Range (HDR), które zachowują więcej informacji z czujnika podczas robienia zdjęcia, co umożliwia uzyskanie żywszych kolorów i większego kontrastu. Android używa formatu ultra HDR, który jest w pełni zgodny z wstecz z obrazami JPEG. Dzięki temu aplikacje mogą płynnie współpracować z obrazami HDR, wyświetlając je w standardowym zakresie dynamiki (SDR), gdy zajdzie taka potrzeba.

Przetwarzanie tych obrazów w interfejsie w HDR jest wykonywane automatycznie przez platformę, gdy aplikacja zechce używać interfejsu HDR w oknie aktywności, albo za pomocą elementu manifestu, albo w czasie działania przez wywołanieWindow.setColorMode(). Na obsługiwanych urządzeniach możesz też robić skompresowane zdjęcia Ultra HDR. Dzięki większej liczbie kolorów odzyskanych z czujnika edytowanie w postprodukcji może być bardziej elastyczne. Pliki Gainmap powiązane z obrazami Ultra HDR mogą służyć do ich renderowania za pomocą OpenGL lub Vulkan.

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

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:

Zoom na matrycy

Gdy REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE w CameraCharacteristics zawiera SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW, aplikacja może korzystać z zaawansowanych możliwości czujnika, aby zapewnić przycięty strumień RAW z tymi samymi pikselami co pełne pole widzenia, używając CaptureRequest z docelowym strumieniem RAW, dla którego ustawiono CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW. Dzięki wdrożeniu ustawień zastąpienia żądania zaktualizowana kamera umożliwia użytkownikom sterowanie zoomem jeszcze przed przygotowaniem innych ustawień.

Bezstratny dźwięk przez USB

Android 14 obsługuje bezstratne formaty dźwięku, dzięki czemu można uzyskać dźwięk w jakości studyjnej w przypadku przewodowych słuchawek USB. Możesz wysyłać zapytania do urządzenia USB w celu uzyskania preferowanych atrybutów miksera, rejestrować słuchacza zmian w preferowanych atrybutach miksera i konfigurować atrybuty miksera za pomocą klasy AudioMixerAttributes. Ta klasa reprezentuje format, np. maskę kanału, częstotliwość próbkowania i zachowanie miksera audio. Ta klasa umożliwia przesyłanie dźwięku bezpośrednio bez miksowania, regulowania głośności ani przetwarzania efektów.

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 is an on-device repository for user health and fitness data. It allows users to share data between their favorite apps, with a single place to control what data they want to share with these apps.

On devices running Android versions prior to Android 14, Health Connect is available to download as an app on the Google Play store. Starting with Android 14, Health Connect is part of the platform and receives updates through Google Play system updates without requiring a separate download. With this, Health Connect can be updated frequently, and your apps can rely on Health Connect being available on devices running Android 14 or higher. Users can access Health Connect from the Settings in their device, with privacy controls integrated into the system settings.

Users can get started using Health Connect without a separate app download on devices running Android 14 or higher.
Users can control which apps have access to their health and fitness data through system settings.

Health Connect includes several new features in Android 14, such as exercise routes, allowing users to share a route of their workout which can be visualized on a map. A route is defined as a list of locations saved within a window of time, and your app can insert routes into exercise sessions, tying them together. To ensure that users have complete control over this sensitive data, users must allow sharing individual routes with other apps.

For more information, see the Health Connection documentation and the blogpost on What's new in 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 introduces several PackageInstaller APIs that allow app stores to improve their user experience.

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.

Pakiety metadanych aplikacji

Od Androida 14 instalator pakietów Androida umożliwia określanie metadanych aplikacji, takich jak zasady bezpieczeństwa danych, które mają być wyświetlane na stronach sklepów z aplikacjami, np. w Google Play.

Wykrywanie, kiedy użytkownicy robią zrzuty ekranu urządzenia

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.

Interfejs użytkownika

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

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

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

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ępowanie ustawień aplikacji na urządzeniach z dużym ekranem

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.

Udostępnianie ekranu aplikacji

App screen sharing enables users to share an app window instead of the entire device screen during screen content recording.

With app screen sharing, the status bar, navigation bar, notifications, and other system UI elements are excluded from the shared display. Only the content of the selected app is shared.

App screen sharing improves productivity and privacy by enabling users to run multiple apps but limit content sharing to a single app.

Inteligentna odpowiedź na klawiaturze Gboard na Pixelu 8 Pro oparta na LLM

Na urządzeniach Pixel 8 Pro z aktualizacją z listopada deweloperzy mogą wypróbować inteligentne odpowiedzi lepszej jakości w klawiaturze Gboard, które są obsługiwane przez duże modele językowe (LLM) działające na procesorze Google Tensor.

Ta funkcja jest dostępna w wersji testowej w języku angielskim (USA) w aplikacji WhatsApp, Line i KakaoTalk. Wymaga użycia urządzenia Pixel 8 Pro z klawiaturą Gboard.

Aby wypróbować tę funkcję, najpierw włącz ją w sekcji Ustawienia > Opcje programisty > Ustawienia AICore > Włącz trwałe AICore.

Następnie otwórz rozmowę w obsługiwanej aplikacji, aby zobaczyć inteligentną odpowiedź w pasku sugestii Gboard, która jest obsługiwana przez LLM.

Gboard korzysta z LLM na urządzeniu, aby dostarczać inteligentne odpowiedzi lepszej jakości.

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 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.

Renderowanie bufora sprzętowego w Canvas

To assist in using Android's Canvas API to draw with hardware acceleration into a HardwareBuffer, Android 14 introduces HardwareBufferRenderer. This API is particularly useful when your use case involves communication with the system compositor through SurfaceControl for low-latency drawing.