Podobnie jak w przypadku poprzednich wersji Androida, w Androidzie 15 wprowadziliśmy zmiany w działaniu, które mogą mieć wpływ na Twoją aplikację. Poniższe zmiany w działaniu dotyczą wyłącznie aplikacji kierowanych na Androida 15 lub nowszego. Jeśli Twoja aplikacja jest kierowana na Androida 15 lub nowszego, zmodyfikuj ją, aby w odpowiednich przypadkach prawidłowo obsługiwała te działania.
Zapoznaj się też z listą zmian w działaniu, które wpływają na wszystkie aplikacje działające na Androidzie 15 niezależnie od targetSdkVersion aplikacji.
Główna funkcja
Android 15 modyfikuje lub rozszerza różne podstawowe funkcje systemu Android.
Zmiany w usługach działających na pierwszym planie
我们将对 Android 15 中的前台服务进行以下更改。
数据同步前台服务超时行为
对于以 Android 15（API 级别 35）或更高版本为目标平台的应用，Android 15 为 dataSync 引入了新的超时行为。此行为也适用于新的 mediaProcessing 前台服务类型。
系统允许应用的 dataSync 服务在 24 小时内总共运行 6 小时，之后系统会调用正在运行的服务的 Service.onTimeout(int, int) 方法（在 Android 15 中引入）。此时，该服务有几秒钟时间来调用 Service.stopSelf()。调用 Service.onTimeout() 后，该服务将不再被视为前台服务。如果服务未调用 Service.stopSelf()，系统会抛出内部异常。系统会在 Logcat 中记录此异常，并显示以下消息：
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"
为避免因行为变更而导致问题，您可以执行以下一项或多项操作：
- 让您的服务实现新的
Service.onTimeout(int, int)方法。当您的应用收到回调时，请务必在几秒钟内调用stopSelf()。（如果您不立即停止应用，系统会生成故障。） - 确保应用的
dataSync服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。 - 仅通过直接的用户互动来启动
dataSync前台服务；由于您的应用在服务启动时位于前台，因此服务会在应用进入后台后的 6 小时内完整运行。 - 请改用替代 API，而不是使用
dataSync前台服务。
如果您的应用的 dataSync 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 dataSync 前台服务，除非用户已将您的应用切换到前台（这会重置计时器）。如果您尝试启动其他 dataSync 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似“前台服务类型 dataSync 的时间限制已用尽”的错误消息。
测试
如需测试应用的行为，您可以启用数据同步超时功能，即使应用未以 Android 15 为目标平台也是如此（前提是应用在 Android 15 设备上运行）。如需启用超时，请运行以下 adb 命令：
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
您还可以调整超时期限，更轻松地测试应用在达到此限制时的行为。如需设置新的超时期限，请运行以下 adb 命令：
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
新的媒体处理前台服务类型
W Androidzie 15 wprowadziliśmy nowy typ usługi na pierwszym planie: mediaProcessing. Ten typ usługi jest odpowiedni do operacji takich jak transkodowanie plików multimedialnych. Na przykład aplikacja multimedialna może pobrać plik audio i przed odtworzeniem musi przekonwertować go na inny format. Możesz użyć usługi mediaProcessing na pierwszym planie, aby mieć pewność, że konwersja będzie kontynuowana nawet wtedy, gdy aplikacja będzie działać w tle.
System zezwala na działanie usług mediaProcessing aplikacji przez łącznie 6 godzin w okresie 24 godzin. Po tym czasie system wywołuje metodę Service.onTimeout(int, int) (wprowadzoną w Androidzie 15). Obecnie usługa ma kilka sekund na wywołanie funkcji Service.stopSelf(). Jeśli usługa nie wywołuje funkcji Service.stopSelf(), system zgłasza wewnętrzny wyjątek. Wyjątek jest logowany w Logcat z tym komunikatem:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"
Aby uniknąć wyjątku, wykonaj jedną z tych czynności:
- Zaimplementuj nową metodę
Service.onTimeout(int, int)w swojej usłudze. Gdy aplikacja otrzyma połączenie zwrotne, w ciągu kilku sekund zadzwoń pod numerstopSelf(). (jeśli nie zatrzymasz aplikacji od razu, system wygeneruje błąd). - Upewnij się, że usługi
mediaProcessingw aplikacji nie działają dłużej niż 6 godzin w ciągu 24 godzin (chyba że użytkownik wchodzi w interakcję z aplikacją, zresetowując w ten sposób timer). - Uruchamiaj usługi na pierwszym planie
mediaProcessingtylko w wyniku bezpośredniej interakcji z użytkownikiem. Ponieważ aplikacja jest na pierwszym planie, gdy usługa się uruchamia, ma ona 6 godzin na działanie po przejściu aplikacji w tło. - Zamiast usługi na pierwszym planie
mediaProcessingużyj alternatywnego interfejsu API, takiego jak WorkManager.
Jeśli w ciągu ostatnich 24 godzin usługi mediaProcessing na pierwszym planie aplikacji działały przez 6 godzin, nie możesz uruchomić innej usługi mediaProcessing na pierwszym planie chyba że użytkownik przełączył aplikację na pierwszy plan (co spowoduje zresetowanie minutnika). Jeśli spróbujesz uruchomić inną usługę działającą na pierwszym planie mediaProcessing, system wyświetli komunikat o błędzie podobny do „Czas limitu usługi działającej na pierwszym planie typu mediaProcessing został już wykorzystany”.ForegroundServiceStartNotAllowedException
Więcej informacji o typie usługi mediaProcessing znajdziesz w artykule Zmiany w typach usług na pierwszym planie w Androidzie 15: przetwarzanie multimediów.
Testowanie
Aby przetestować działanie aplikacji, możesz włączyć limity czasu przetwarzania multimediów, nawet jeśli aplikacja nie jest kierowana na Androida 15 (o ile jest uruchomiona na urządzeniu z Androidem 15). Aby włączyć limity czasu, uruchom to polecenie adb:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
Możesz też dostosować czas oczekiwania, aby łatwiej testować działanie aplikacji po osiągnięciu limitu. Aby ustawić nowy okres oczekiwania, uruchom to polecenie adb:
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds
对启动前台服务的 BOOT_COMPLETED 广播接收器的限制
在启动 BOOT_COMPLETED 广播接收器方面存在新限制
前台服务。BOOT_COMPLETED 接收器不能启动
以下类型的前台服务：
dataSynccameramediaPlaybackphoneCallmediaProjectionmicrophone（自 Android 14 起，microphone就受到此限制）
如果 BOOT_COMPLETED 接收器尝试启动任何上述类型的前台
服务，系统会抛出 ForegroundServiceStartNotAllowedException。
测试
如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。运行以下 adb 命令：
adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name
如需在不重启设备的情况下发送 BOOT_COMPLETED 广播，请运行以下 adb 命令：
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name
在应用拥有 SYSTEM_ALERT_WINDOW 权限时启动前台服务的限制
以前，如果应用拥有 SYSTEM_ALERT_WINDOW 权限，即使应用当前在后台运行，也可以启动前台服务（如免于后台启动限制中所述）。
如果应用以 Android 15 为目标平台，则此豁免范围现在更窄。现在，应用需要具有 SYSTEM_ALERT_WINDOW 权限，并且还需要有一个可见的叠加窗口。也就是说，应用需要先启动 TYPE_APPLICATION_OVERLAY 窗口，并且该窗口需要处于可见状态，然后您才能启动前台服务。
如果您的应用尝试从后台启动前台服务，但不符合这些新要求（并且没有其他豁免情况），系统会抛出 ForegroundServiceStartNotAllowedException。
如果您的应用声明了 SYSTEM_ALERT_WINDOW 权限并从后台启动前台服务，则可能会受到此变更的影响。如果您的应用获得了 ForegroundServiceStartNotAllowedException，请检查应用的操作顺序，并确保应用在尝试从后台启动前台服务之前已具有有效的叠加层窗口。您可以通过调用 View.getWindowVisibility() 检查叠加层窗口当前是否可见，也可以替换 View.onWindowVisibilityChanged()，以便在可见性发生变化时收到通知。
测试
如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。如需针对从后台启动前台服务启用这些新限制，请运行以下 adb 命令：
adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name
Zmiany dotyczące tego, kiedy aplikacje mogą modyfikować globalny stan trybu Nie przeszkadzać
Aplikacje kierowane na Androida 15 (poziom API 35) lub nowszego nie mogą już zmieniać globalnego stanu ani zasad trybu Nie przeszkadzać na urządzeniu (ani przez modyfikowanie ustawień użytkownika, ani przez wyłączanie trybu Nie przeszkadzać). Zamiast tego aplikacje muszą przekazać AutomaticZenRule, które system połączy w globalne zasady z dotychczasowym schematem „najbardziej restrykcyjne zasady wygrywają”. Wywołania istniejących interfejsów API, które wcześniej wpływały na stan globalny (setInterruptionFilter,
setNotificationPolicy), powodują utworzenie lub zaktualizowanie niejawnego AutomaticZenRule, który jest włączany i wyłączany w zależności od cyklu wywołań tych interfejsów API.
Pamiętaj, że ta zmiana wpływa tylko na obserwowalne zachowanie, jeśli aplikacja wywołuje funkcję setInterruptionFilter(INTERRUPTION_FILTER_ALL) i oczekuje, że ta funkcja dezaktywuje AutomaticZenRule, który został wcześniej aktywowany przez właścicieli.
Zmiany w interfejsie OpenJDK API
Android 15 kontynuuje prace nad odświeżaniem podstawowych bibliotek Androida, aby były one zgodne z funkcjami w najnowszych wersjach OpenJDK LTS.
Niektóre z tych zmian mogą mieć wpływ na zgodność aplikacji kierowanych na Androida 15 (poziom interfejsu API 35):
Zmiany w interfejsach API formatowania ciągów znaków: w przypadku korzystania z tych interfejsów API walidacja indeksu argumentu, flag, szerokości i precyzji jest teraz bardziej rygorystyczna:
String.format()iFormatter.format():String.format(String, Object[])String.format(Locale, String, Object[])Formatter.format(String, Object[])Formatter.format(Locale, String, Object[])
Na przykład ten wyjątek jest zgłaszany, gdy używany jest indeks argumentu 0 (
%0w ciągu formatu):IllegalFormatArgumentIndexException: Illegal format argument index = 0W tym przypadku problem można rozwiązać, używając indeksu argumentu 1 (
%1w ciągu formatu).Zmiany w typie komponentu
Arrays.asList(...).toArray(): gdy używaszArrays.asList(...).toArray(), typem komponentu wynikowej tablicy jest terazObject, a nie typ elementów tablicy bazowej. Dlatego ten kod zgłaszaClassCastException:String[] elements = (String[]) Arrays.asList("one", "two").toArray();W tym przypadku, aby zachować
Stringjako typ komponentu w wynikowej tablicy, możesz użyćCollection.toArray(Object[])zamiast tego:String[] elements = Arrays.asList("two", "one").toArray(new String[0]);Zmiany w obsłudze kodów języków: gdy używasz interfejsu API
Locale, kody języków hebrajskiego, jidysz i indonezyjskiego nie są już konwertowane na ich przestarzałe formy (hebrajski:iw, jidysz:ji, indonezyjski:in). Podczas określania kodu języka dla jednej z tych ustawień regionalnych używaj kodów z ISO 639-1 (hebrajski:he, jidysz:yi, indonezyjski:id).Zmiany w sekwencjach liczb losowych: po zmianach wprowadzonych w https://bugs.openjdk.org/browse/JDK-8301574 te metody
Random.ints()zwracają teraz inną sekwencję liczb niż metodyRandom.nextInt():Zasadniczo ta zmiana nie powinna powodować nieprawidłowego działania aplikacji, ale Twój kod nie powinien oczekiwać, że sekwencja wygenerowana przez metody
Random.ints()będzie zgodna zRandom.nextInt().
Nowy interfejs API SequencedCollection może mieć wpływ na zgodność aplikacji
po zaktualizowaniu compileSdk w konfiguracji kompilacji aplikacji, aby używać
Androida 15 (poziom interfejsu API 35):
Kolizja z
MutableList.removeFirst()iMutableList.removeLast()funkcjami rozszerzeń wkotlin-stdlibTyp
Listw Javie jest mapowany na typMutableListw Kotlinie. Ponieważ interfejsy APIList.removeFirst()iList.removeLast()zostały wprowadzone w Androidzie 15 (poziom interfejsu API 35), kompilator Kotlin rozwiązuje wywołania funkcji, np.list.removeFirst(), statycznie do nowych interfejsów APIList, a nie do funkcji rozszerzeń wkotlin-stdlib.Jeśli aplikacja zostanie ponownie skompilowana z
compileSdkustawionym na35iminSdkustawionym na34lub niższą wartość, a następnie zostanie uruchomiona na Androidzie 14 lub starszym, zostanie zgłoszony błąd środowiska wykonawczego:java.lang.NoSuchMethodError: No virtual method removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;Istniejąca opcja lint
NewApiwe wtyczce Androida do obsługi Gradle może wykryć te nowe użycia interfejsu API../gradlew lintMainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi] list.removeFirst()Aby naprawić wyjątek środowiska wykonawczego i błędy lint, wywołania funkcji
removeFirst()iremoveLast()można zastąpić odpowiednioremoveAt(0)iremoveAt(list.lastIndex)w Kotlinie. Jeśli używasz Androida Studio Ladybug | 2024.1.3 lub nowszego, udostępnia ono też opcję szybkiej naprawy tych błędów.Jeśli opcja lint została wyłączona, rozważ usunięcie
@SuppressLint("NewApi")ilintOptions { disable 'NewApi' }.Kolizja z innymi metodami w Javie
Do istniejących typów, np.,
ListiDeque, dodano nowe metody. Te nowe metody mogą być niezgodne z metodami o tej samej nazwie i typach argumentów w innych interfejsach i klasach. W przypadku kolizji sygnatury metody z niezgodnością kompilatorjavaczgłasza błąd w czasie kompilacji. Przykład:Przykładowy błąd 1:
javac MyList.javaMyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List public void removeLast() { ^ return type void is not compatible with Object where E is a type-variable: E extends Object declared in interface ListPrzykładowy błąd 2:
javac MyList.javaMyList.java:7: error: types Deque<Object> and List<Object> are incompatible; public class MyList implements List<Object>, Deque<Object> { both define reversed(), but with unrelated return types 1 errorPrzykładowy błąd 3:
javac MyList.javaMyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible; public static class MyList implements List<Object>, MyInterface<Object> { class MyList inherits unrelated defaults for getFirst() from types List and MyInterface where E#1,E#2 are type-variables: E#1 extends Object declared in interface List E#2 extends Object declared in interface MyInterface 1 errorAby naprawić te błędy kompilacji, klasa implementująca te interfejsy powinna zastąpić metodę zgodnym typem zwracanym. Przykład:
@Override public Object getFirst() { return List.super.getFirst(); }
Bezpieczeństwo
Android 15 zawiera zmiany, które zwiększają bezpieczeństwo systemu, aby chronić aplikacje i użytkowników przed złośliwymi aplikacjami.
Ograniczone wersje TLS
Android 15 ogranicza użycie TLS w wersjach 1.0 i 1.1. Te wersje zostały wcześniej wycofane w Androidzie, ale teraz są niedozwolone w przypadku aplikacji kierowanych na Androida 15.
Zabezpieczone uruchamianie aktywności w tle
Android 15 chroni użytkowników przed złośliwymi aplikacjami i zapewnia im większą kontrolę nad urządzeniami. Wprowadziliśmy zmiany, które uniemożliwiają złośliwym aplikacjom działającym w tle przenoszenie innych aplikacji na pierwszy plan, podnoszenie ich uprawnień i nadużywanie interakcji z użytkownikiem. Od Androida 10 (poziom interfejsu API 29) uruchamianie aktywności w tle jest ograniczone.
Inne zmiany
- Zmień domyślne ustawienie
PendingIntenttwórców na blokowanie uruchamiania aktywności w tle. Pomaga to zapobiegać przypadkowemu tworzeniu przez aplikacjePendingIntent, które mogłyby być wykorzystywane przez nieuczciwe podmioty. - Nie przenoś aplikacji na pierwszy plan, chyba że
PendingIntentnadawca na to zezwoli. Ta zmiana ma zapobiegać nadużywaniu przez złośliwe aplikacje możliwości rozpoczynania aktywności w tle. Domyślnie aplikacje nie mogą przenosić stosu zadań na pierwszy plan, chyba że twórca zezwoli na uprawnienia do uruchamiania działań w tle lub nadawca ma uprawnienia do uruchamiania działań w tle. - Określa, jak najwyższa aktywność w stosie zadań może zakończyć zadanie. Jeśli aktywność na górze stosu zakończy zadanie, Android wróci do ostatniego aktywnego zadania. Jeśli aktywność niebędąca na pierwszym planie zakończy swoje zadanie, Android wró do ekranu głównego. Nie zablokuje zakończenia tej aktywności.
- Zapobiegaj uruchamianiu dowolnych działań z innych aplikacji w swoim zadaniu. Ta zmiana uniemożliwia złośliwym aplikacjom wyłudzanie informacji od użytkowników przez tworzenie działań, które wyglądają jak działania innych aplikacji.
- Blokowanie okien niewidocznych, aby nie były brane pod uwagę podczas uruchamiania aktywności w tle. Pomaga to zapobiegać wykorzystywaniu przez złośliwe aplikacje uruchamiania aktywności w tle do wyświetlania użytkownikom niechcianych lub szkodliwych treści.
Bezpieczniejsze zamiary
Android 15 针对 intent 引入了 StrictMode。
如需查看有关 Intent 使用违规行为的详细日志，请使用以下方法：
Kotlin
fun onCreate() { StrictMode.setVmPolicy(VmPolicy.Builder() .detectUnsafeIntentLaunch() .build() ) }
Java
public void onCreate() { StrictMode.setVmPolicy(new VmPolicy.Builder() .detectUnsafeIntentLaunch() .build()); }
Wrażenia użytkowników i interfejs systemu
Android 15 zawiera kilka zmian, które mają na celu zapewnienie bardziej spójnego i intuicyjnego interfejsu.
Zmiany w oknie
Android 15 中与窗口内边距相关的两项变更：默认强制执行边到边，此外还有配置变更，例如系统栏的默认配置。
Egzekwowanie treści od krawędzi do krawędzi
Jeśli aplikacja jest kierowana na Androida 15 (poziom API 35), domyślnie wyświetla się bez ramki na urządzeniach z tą wersją systemu.
Jest to zmiana powodująca niezgodność wsteczną, która może mieć negatywny wpływ na interfejs aplikacji. Zmiany dotyczą tych obszarów interfejsu:
- Pasek nawigacji z obsługą gestów
- Domyślnie przezroczysty.
- Odsunięcie od dołu jest wyłączone, więc treść jest rysowana za paskiem nawigacji systemu, chyba że zastosowano wcięcia.
setNavigationBarColoriR.attr#navigationBarColorsą wycofane i nie mają wpływu na nawigację przy użyciu gestów.setNavigationBarContrastEnforcediR.attr#navigationBarContrastEnforcednadal nie mają wpływu na nawigację przy użyciu gestów.
- Nawigacja przy użyciu 3 przycisków
- Domyślnie ustawiona jest przezroczystość 80%, a kolor może być zgodny z tłem okna.
- Odsunięcie od dołu jest wyłączone, więc treść jest rysowana za paskiem nawigacji systemu, chyba że zastosowano wcięcia.
setNavigationBarColoriR.attr#navigationBarColorsą domyślnie ustawione tak, aby pasowały do tła okna. Aby zastosować to ustawienie domyślne, tło okna musi być obiektem rysowalnym w kolorze. Ten interfejs API jest wycofany, ale nadal wpływa na nawigację przy użyciu 3 przycisków.setNavigationBarContrastEnforcediR.attr#navigationBarContrastEnforcedsą domyślnie ustawione na wartość „prawda”, co powoduje dodanie tła o przezroczystości 80% w nawigacji przy użyciu 3 przycisków.
- Pasek stanu
- Domyślnie przezroczysty.
- Odsunięcie od góry jest wyłączone, więc treść jest rysowana za paskiem stanu, chyba że zastosowano wcięcia.
setStatusBarColoriR.attr#statusBarColorsą wycofane i nie mają wpływu na Androida 15.setStatusBarContrastEnforcediR.attr#statusBarContrastEnforcedsą wycofane, ale nadal mają wpływ na Androida 15.
- Wycięcie w ekranie
- W przypadku okien niepływających wartość
layoutInDisplayCutoutModemusi być równaLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. WartościSHORT_EDGES,NEVERiDEFAULTsą interpretowane jakoALWAYS, dzięki czemu użytkownicy nie widzą czarnego paska spowodowanego wycięciem w ekranie, a aplikacja wyświetla się bez ramki.
- W przypadku okien niepływających wartość
Poniższy przykład pokazuje aplikację przed i po kierowaniu na Androida 15 (poziom API 35) oraz przed i po zastosowaniu wcięć. Ten przykład nie jest wyczerpujący i może wyglądać inaczej w Androidzie Auto.
Co sprawdzić, jeśli aplikacja już wyświetla się bez ramki
Jeśli Twoja aplikacja już wyświetla się bez ramki i stosuje wcięcia, w większości przypadków nie musisz nic robić, z wyjątkiem tych sytuacji: Nawet jeśli uważasz, że nie musisz nic robić, zalecamy przetestowanie aplikacji.
- Masz okno niepływające, np.
Activity, które używa wartościSHORT_EDGES,NEVERlubDEFAULTzamiastLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Jeśli aplikacja ulega awarii podczas uruchamiania, przyczyną może być ekran powitalny. Możesz zaktualizować zależność core splashscreen do wersji 1.2.0-alpha01 lub nowszej albo ustawićwindow.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always. - Mogą występować ekrany o mniejszym natężeniu ruchu z zasłoniętym interfejsem. Sprawdź, czy te rzadziej odwiedzane ekrany nie mają zasłoniętego interfejsu. Ekrany o mniejszym natężeniu ruchu to m.in.:
- ekrany wprowadzające lub logowania,
- strony ustawień.
Co sprawdzić, jeśli aplikacja nie wyświetla się jeszcze bez ramki
Jeśli Twoja aplikacja nie wyświetla się jeszcze bez ramki, najprawdopodobniej musisz coś zmienić. Oprócz scenariuszy dotyczących aplikacji, które już wyświetlają się bez ramki, musisz wziąć pod uwagę te kwestie:
- Jeśli Twoja aplikacja używa komponentów Material 3 (
androidx.compose.material3) w Compose, takich jakTopAppBar,BottomAppBar, iNavigationBar, te komponenty nie powinny mieć wpływu, ponieważ automatycznie obsługują wcięcia. - Jeśli Twoja aplikacja używa komponentów Material 2 (
androidx.compose.material) w Compose, te komponenty nie obsługują automatycznie wcięć. Możesz jednak uzyskać dostęp do wcięć i zastosować je ręcznie. W androidx.compose.material 1.6.0 i nowszych wersjach użyj parametruwindowInsets, aby ręcznie zastosować wcięcia w przypadku komponentówBottomAppBar,TopAppBar,BottomNavigationiNavigationRail. Podobnie użyj parametrucontentWindowInsetsdlaScaffold. - Jeśli Twoja aplikacja używa widoków i komponentów Material
(
com.google.android.material), większość komponentów Material opartych na widokach, takich jakBottomNavigationView,BottomAppBar,NavigationRailViewczyNavigationView, obsługuje wcięcia i nie wymaga dodatkowej pracy. Jeśli jednak używasz komponentuAppBarLayout, musisz dodaćandroid:fitsSystemWindows="true". - W przypadku niestandardowych komponentów kompozycyjnych zastosuj wcięcia ręcznie jako dopełnienie. Jeśli treść znajduje się w komponencie
Scaffold, możesz użyć wcięć za pomocą wartości dopełnieniaScaffoldpadding values. W przeciwnym razie zastosuj dopełnienie za pomocą jednego z komponentówWindowInsets. - Jeśli Twoja aplikacja używa widoków i
BottomSheet,SideSheetlub niestandardowych kontenerów, zastosuj dopełnienie za pomocąViewCompat.setOnApplyWindowInsetsListener. W przypadkuRecyclerViewzastosuj dopełnienie za pomocą tego odbiornika i dodaj teżclipToPadding="false".
Co sprawdzić, jeśli aplikacja musi oferować niestandardową ochronę tła
Jeśli Twoja aplikacja musi oferować niestandardową ochronę tła w przypadku nawigacji przy użyciu 3 przycisków lub paska stanu, powinna umieścić komponent kompozycyjny lub widok za paskiem systemowym za pomocą WindowInsets.Type#tappableElement(), aby uzyskać wysokość paska nawigacji przy użyciu 3 przycisków, lub WindowInsets.Type#statusBars.
Dodatkowe materiały dotyczące wyświetlania bez ramki
Dodatkowe informacje o stosowaniu wcięć znajdziesz w przewodnikach Wyświetlanie bez ramki w widokach i Wyświetlanie bez ramki w Compose.
Wycofane interfejsy API
Te interfejsy API są wycofane, ale nie wyłączone:
R.attr#enforceStatusBarContrastR.attr#navigationBarColor(w przypadku nawigacji przy użyciu 3 przycisków z przezroczystością 80%)Window#isStatusBarContrastEnforcedWindow#setNavigationBarColor(w przypadku nawigacji przy użyciu 3 przycisków z przezroczystością 80%)Window#setStatusBarContrastEnforced
Te interfejsy API są wycofane i wyłączone:
R.attr#navigationBarColor(w przypadku nawigacji przy użyciu gestów)R.attr#navigationBarDividerColorR.attr#statusBarColorWindow#setDecorFitsSystemWindowsWindow#getNavigationBarColorWindow#getNavigationBarDividerColorWindow#getStatusBarColorWindow#setNavigationBarColor(w przypadku nawigacji przy użyciu gestów)Window#setNavigationBarDividerColorWindow#setStatusBarColor
Stabilna konfiguracja
如果您的应用以 Android 15（API 级别 35）或更高版本为目标平台，Configuration 不再排除系统栏。如果您在 Configuration 类中使用屏幕尺寸进行布局计算，则应根据需要将其替换为更好的替代方案，例如适当的 ViewGroup、WindowInsets 或 WindowMetricsCalculator。
Configuration 自 API 1 起可用。它通常从 Activity.onConfigurationChanged 获取。它提供窗口密度、屏幕方向和尺寸等信息。从 Configuration 返回的窗口尺寸的一个重要特征是，它之前排除了系统栏。
配置尺寸通常用于资源选择，例如 /res/layout-h500dp，这仍然是一个有效的用例。但是，我们一直不建议将其用于布局计算。如果您这样做，现在应该停止。您应该根据自己的用例，将 Configuration 的使用替换为更合适的内容。
如果您使用它来计算布局，请使用适当的 ViewGroup，例如 CoordinatorLayout 或 ConstraintLayout。如果您使用它来确定系统导航栏的高度，请使用 WindowInsets。如果您想知道应用窗口的当前尺寸，请使用 computeCurrentWindowMetrics。
以下列表介绍了受此更改影响的字段：
Configuration.screenWidthDp和screenHeightDp尺寸不再 排除系统栏。Configuration.smallestScreenWidthDp间接受到screenWidthDp和screenHeightDp更改的影响。Configuration.orientation间接受到接近正方形的设备上screenWidthDp和screenHeightDp更改的影响。Display.getSize(Point)间接受到Configuration更改的影响。此方法已从 API 级别 30 开始被弃用。- 自 API 级别 33 起，
Display.getMetrics()的运作方式已是如此。
Atrybut elegantTextHeight ma domyślnie wartość true.
W przypadku aplikacji przeznaczonych na Androida 15 (poziom interfejsu API 35) atrybut elegantTextHeight TextView domyślnie staje się true, co zastępuje czcionkę kompaktową używaną domyślnie w niektórych skryptach, które mają duże wymiary pionowe, czcionką o znacznie lepszej czytelności.
Czcionka kompaktowa została wprowadzona, aby zapobiec rozmieszczaniu elementów układu. Android 13 (poziom interfejsu API 33) zapobiega wielu takim problemom, ponieważ pozwala na rozciąganie wysokości układu tekstu za pomocą atrybutu fallbackLineSpacing.
W Androidzie 15 czcionka kompaktowa nadal pozostaje w systemie, więc aplikacja może ustawić wartość elegantTextHeight na false, aby uzyskać takie samo działanie jak wcześniej, ale jest mało prawdopodobne, aby była obsługiwana w przyszłych wersjach. Jeśli Twoja aplikacja obsługuje te pismo: arabski, kannada, oriya, tamilski, telugu, gudżarati, malajalam, birmański, gudźarati, kannada, malajalam, oriya, telugu lub tajski, przetestuj ją, ustawiając wartość elegantTextHeight na true.
elegantTextHeightdla aplikacji kierowanych na Androida 14 (poziom API 34) i starszego.
elegantTextHeightzachowanie w przypadku aplikacji kierowanych na Androida 15.Szerokość widoku TextView zmienia się w przypadku złożonych kształtów liter
W poprzednich wersjach Androida niektóre czcionki kursywe lub języki ze złożonym kształtem mogą rysować litery w obszarze poprzedniego lub następnego znaku.
Zdarzało się, że takie litery były obcinane na początku lub na końcu.
Od Androida 15 TextView przydziela wystarczającą ilość miejsca na wyświetlenie takich liter, a aplikacje mogą prosić o dodatkowe wypełnienie po lewej stronie, aby zapobiec przycięciu.
Ta zmiana wpływa na sposób określania szerokości przez TextView, więc TextView domyślnie przydziela więcej szerokości, jeśli aplikacja jest kierowana na Androida 15 (poziom API 35) lub nowszego. Możesz włączyć lub wyłączyć tę funkcję, wywołując interfejs API setUseBoundsForWidth w komponencie TextView.
Dodanie dopełnienia z lewej strony może spowodować niewłaściwe ułożenie istniejących układów, dlatego dopełnienie nie jest dodawane domyślnie nawet w przypadku aplikacji kierowanych na Androida 15 lub nowszego.
Możesz jednak dodać dodatkowy margines, aby zapobiec przycięciu, wywołując funkcję setShiftDrawingOffsetForStartOverhang.
W poniższych przykładach pokazujemy, jak te zmiany mogą poprawić układ tekstu w przypadku niektórych czcionek i języków.
<TextView android:fontFamily="cursive" android:text="java" />
<TextView android:fontFamily="cursive" android:text="java" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
<TextView android:text="คอมพิวเตอร์" />
<TextView android:text="คอมพิวเตอร์" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
Domyślna wysokość wiersza w widoku EditText dostosowana do ustawień regionalnych
W poprzednich wersjach Androida układ tekstu rozciągał wysokość tekstu, aby dopasować ją do wysokości wiersza czcionki odpowiadającej bieżącemu ustawieniu języka. Jeśli na przykład treści były w języku japońskim, to ze względu na to, że wysokość linii czcionki japońskiej jest nieco większa niż czcionki łacińskiej, wysokość tekstu była nieco większa. Jednak pomimo tych różnic w wysokościach wierszy element EditText miał jednakowy rozmiar niezależnie od używanej lokalizacji, jak pokazano na poniższym obrazku:
EditText, które mogą zawierać tekst w języku angielskim (en), japońskim (ja) i birmańskim (my). Wysokość EditText jest taka sama, mimo że te języki mają różne wysokości linii.W przypadku aplikacji kierowanych na Androida 15 (poziom interfejsu API 35) minimalna wysokość linii jest teraz zarezerwowana dla EditText, aby pasowała do czcionki referencyjnej dla określonego języka, jak pokazano na poniższym obrazie:
EditText, które mogą zawierać tekst w języku angielskim (en), japońskim (ja) i birmańskim (my). Wysokość EditText uwzględnia teraz miejsce na domyślną wysokość wiersza dla czcionek w tych językach.W razie potrzeby aplikacja może przywrócić poprzednie działanie, ustawiając atrybut useLocalePreferredLineHeightForMinimum na false. Może też ustawić niestandardowe minimalne dane pionowe za pomocą interfejsu API setMinimumFontMetrics w językach Kotlin i Java.
Aparat i multimedia
W Androidzie 15 wprowadziliśmy te zmiany w działaniu aparatu i multimediów w przypadku aplikacji kierowanych na Androida 15 lub nowszego.
Ograniczenia dotyczące żądania aktywności audio
Aplikacje kierowane na Androida 15 (poziom API 35) muszą być aplikacjami na pierwszym planie lub usługami na pierwszym planie, aby poprosić o uzyskanie kontroli nad dźwiękiem. Jeśli aplikacja próbuje poprosić o skupienie uwagi, gdy nie spełnia jednego z tych wymagań, wywołanie zwraca AUDIOFOCUS_REQUEST_FAILED.
Więcej informacji o fokusowaniu dźwięku znajdziesz w artykule Zarządzanie fokusem dźwięku.
Zaktualizowane ograniczenia dotyczące pakietów SDK
Android 15 包含更新后的受限非 SDK 接口列表（基于与 Android 开发者之间的协作以及最新的内部测试）。在限制使用非 SDK 接口之前，我们会尽可能确保有可用的公开替代方案。
如果您的应用并非以 Android 15 为目标平台，其中一些变更可能不会立即对您产生影响。不过，虽然您的应用可以访问某些非 SDK 接口（具体取决于应用的目标 API 级别），但只要您使用任何非 SDK 方法或字段，就很有可能会造成应用功能异常。
如果您不确定自己的应用是否使用了非 SDK 接口，则可以通过 测试该应用来进行确认。如果您的应用依赖非 SDK 接口，则应开始计划迁移到 SDK 替代方案。不过，我们知道某些应用存在使用非 SDK 接口的合理场景。如果您无法为应用中的某项功能找到使用非 SDK 接口的替代方案，则应该请求新的公共 API。
Więcej informacji o zmianach w tej wersji Androida znajdziesz w artykule Zmiany ograniczeń interfejsu niebędącego interfejsem SDK w Androidzie 15. Więcej informacji o interfejsach innych niż SDK znajdziesz w artykule Ograniczenia interfejsów innych niż SDK.