Zmiany w działaniu: aplikacje kierowane na Androida 17 lub nowszego

Podobnie jak w przypadku poprzednich wersji Androida, w Androidzie 17 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 17 lub nowszego. Jeśli Twoja aplikacja jest kierowana na Androida 17 lub nowszego, zmodyfikuj ją, aby w odpowiednich przypadkach 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 17 niezależnie od targetSdkVersion aplikacji.

Wrażenia użytkowników i interfejs systemu

Android 17 zawiera te zmiany, które mają na celu zapewnienie bardziej spójnego i intuicyjnego interfejsu.

Widżet limitu pamięci

Od Androida 17 system egzekwuje ścisły limit pamięci (1,5 * szerokość ekranu * wysokość ekranu * 4) w przypadku łącznego wykorzystania pamięci przez mapy bitowe i ikony w pakiecie RemoteViews w aplikacjach kierowanych na Androida 17 (interfejs API na poziomie 37) lub nowszego. Przekroczenie tych limitów powoduje błąd krytyczny IllegalArgumentException i awarię procesu aplikacji.

Więcej informacji znajdziesz w artykule UpdateAppWidget.

Główna funkcja

Android 17 zawiera te zmiany, które modyfikują lub rozszerzają różne podstawowe funkcje systemu Android.

Nowa implementacja MessageQueue bez blokad

Beginning with Android 17, apps targeting Android 17 (API level 37) or higher receive a new lock-free implementation of android.os.MessageQueue. The new implementation improves performance and reduces missed frames, but may break clients that reflect on MessageQueue private fields and methods.

For more information, including mitigation strategies, see MessageQueue behavior change guidance.

Statyczne pola końcowe są teraz niemodyfikowalne

Aplikacje działające na Androidzie 17 lub nowszym, które są kierowane na Androida 17 (API na poziomie 37) lub nowszego, nie mogą zmieniać pól static final. Jeśli aplikacja spróbuje zmienić pole static final za pomocą odbicia, spowoduje to wystąpienie błędu IllegalAccessException. Próba zmodyfikowania jednego z tych pól za pomocą interfejsów API JNI (np. SetStaticLongField()) spowoduje awarię aplikacji.

Ułatwienia dostępu

W Androidzie 17 wprowadziliśmy te zmiany, aby poprawić dostępność.

Ułatwienia dostępu do złożonego pisania na klawiaturze fizycznej IME

Ta funkcja wprowadza nowe interfejsy API AccessibilityEvent i TextAttribute, które ulepszają odczytywanie przez czytnik ekranu komunikatów głosowych w przypadku wprowadzania tekstu w językach CJKV. Aplikacje CJKV IME mogą teraz sygnalizować, czy podczas tworzenia tekstu wybrano kandydata do konwersji tekstu. Aplikacje z polami edycji mogą określać rodzaje zmian tekstu podczas wysyłania zdarzeń dostępności związanych ze zmianą tekstu. Aplikacje mogą na przykład określać, że zmiana tekstu nastąpiła podczas jego tworzenia lub że wynikała z zatwierdzenia. Dzięki temu usługi ułatwień dostępu, takie jak czytniki ekranu, mogą przekazywać bardziej precyzyjne informacje zwrotne na podstawie charakteru modyfikacji tekstu.

Popularność aplikacji

• Aplikacje IME: podczas ustawiania tekstu w polach edycji aplikacje IME mogą używać znaku TextAttribute.Builder.setTextSuggestionSelected(), aby wskazać, czy wybrano konkretną propozycję konwersji.

• Aplikacje z uprawnieniami do edytowania pól: aplikacje, które obsługują niestandardowe pole InputConnection, mogą pobierać dane o wyborze kandydatów, wywołując funkcję TextAttribute.isTextSuggestionSelected(). Te aplikacje powinny następnie wywoływać AccessibilityEvent.setTextChangeTypes() podczas wysyłania TYPE_VIEW_TEXT_CHANGED zdarzeń. Aplikacje kierowane na Androida 17 (poziom interfejsu API 37), które korzystają ze standardowego interfejsu TextView, będą miały tę funkcję włączoną domyślnie. (Oznacza to, że TextView będzie pobierać dane z edytora IME i ustawiać typy zmian tekstu podczas wysyłania zdarzeń do usług ułatwień dostępu).

• Usługi ułatwień dostępu: usługi ułatwień dostępu, które przetwarzają zdarzenia TYPE_VIEW_TEXT_CHANGED, mogą wywoływać zdarzenia AccessibilityEvent.getTextChangeTypes(), aby określić charakter modyfikacji i odpowiednio dostosować strategie przekazywania informacji zwrotnych.

Prywatność

W Androidzie 17 wprowadziliśmy te zmiany, aby zwiększyć prywatność użytkowników.

Włączono ECH (Encrypted Client Hello)

Android 17 introduces platform support for Encrypted Client Hello (ECH), a TLS extension that enhances user privacy by encrypting the Server Name Indication (SNI) in the TLS handshake. This encryption helps prevent network observers from easily identifying the specific domain your app is connecting to.

For apps targeting Android 17 (API level 37) or higher, ECH is used for TLS connections. ECH is active only if the networking library used by the app (for example, HttpEngine, WebView, or OkHttp) has integrated ECH support and the remote server also supports the ECH protocol. If ECH cannot be negotiated, the client sends an ECH extension with randomized contents (a mechanism called ECH GREASE). See RFC 9849 for more details on how ECH GREASE works.

To allow apps to customize this behavior, Android 17 adds a new <domainEncryption> element to the Network Security Configuration file. Developers can use <domainEncryption> within <base-config> or <domain-config> tags to select an ECH mode (for example, "enabled" or "disabled") on a global or per-domain basis.

For more information, see the Encrypted Client Hello documentation.

Aplikacje kierowane na Androida 17 wymagają uprawnień dostępu do sieci lokalnej

Android 17 wprowadza uprawnienia w czasie działania (aplikacji) ACCESS_LOCAL_NETWORK, aby chronić użytkowników przed nieautoryzowanym dostępem do sieci lokalnej. Ponieważ to uprawnienie należy do istniejącej grupy uprawnień NEARBY_DEVICES, użytkownicy, którzy przyznali już inne uprawnienia NEARBY_DEVICES, nie będą ponownie proszeni o ich przyznanie. Ten nowy wymóg uniemożliwia złośliwym aplikacjom wykorzystywanie nieograniczonego dostępu do sieci lokalnej do potajemnego śledzenia użytkowników i zbierania odcisków cyfrowych. Deklarując to uprawnienie i o nie prosząc, aplikacja może wykrywać urządzenia w lokalnej sieci (LAN), takie jak urządzenia inteligentnego domu lub odbiorniki do przesyłania, i się z nimi łączyć.

Aplikacje kierowane na Androida 17 (API na poziomie 37) lub nowszego mają teraz 2 sposoby na utrzymanie komunikacji z urządzeniami w sieci LAN: mogą korzystać z selektorów urządzeń obsługiwanych przez system, które chronią prywatność i pomijają prośbę o uprawnienia, lub wyraźnie prosić o te nowe uprawnienia w czasie działania, aby utrzymać komunikację w sieci lokalnej.

Więcej informacji znajdziesz w dokumentacji uprawnień do sieci lokalnej.

Ukrywanie haseł na urządzeniach fizycznych

Jeśli aplikacja jest kierowana na Androida 17 (API na poziomie 37) lub nowszego, a użytkownik korzysta z fizycznego urządzenia wejściowego (np. zewnętrznej klawiatury), system operacyjny Android stosuje nowe ustawienie show_passwords_physical do wszystkich znaków w polu hasła. Domyślnie to ustawienie ukrywa wszystkie znaki hasła.

System Android wyświetla ostatni wpisany znak hasła, aby pomóc użytkownikowi sprawdzić, czy nie popełnił błędu. W przypadku większych klawiatur zewnętrznych jest to jednak znacznie mniej potrzebne. Dodatkowo urządzenia z klawiaturami zewnętrznymi mają często większe wyświetlacze, co zwiększa ryzyko, że ktoś zobaczy wpisywane hasło.

Jeśli użytkownik korzysta z ekranu dotykowego urządzenia, system zastosuje nowe ustawienieshow_passwords_touch.

Ochrona haseł jednorazowych w standardowych SMS-ach

Od Androida 17 rozszerzamy ochronę SMS-ów z kodem OTP na standardowe wiadomości SMS (zawierające kod OTP, które nie korzystają z formatów WebOTP ani SMS Retriever). W przypadku większości aplikacji kierowanych na Androida 17 (poziom interfejsu API 37) lub nowszego te wiadomości SMS stają się dostępne dopiero po 3 godzinach od ich otrzymania. Ma to zapobiec przejęciu kodu OTP. Podczas tego 3-godzinnego opóźnienia transmisja SMS_RECEIVED_ACTION jest wstrzymana, a zapytania do bazy danych dostawcy SMS-ów są filtrowane. Po upływie tego czasu SMS będzie dostępny w tych aplikacjach.

Niektóre aplikacje, takie jak domyślna aplikacja asystenta SMS, aplikacje towarzyszące połączonym urządzeniom itp., są zwolnione z tego opóźnienia. Wszystkie aplikacje, które do wyodrębniania kodów OTP korzystają z odczytywania wiadomości SMS, powinny przejść na interfejsy SMS Retriever lub SMS User Consent, aby zapewnić dalsze działanie.

Bezpieczeństwo

Android 17 wprowadza te ulepszenia zabezpieczeń urządzeń i aplikacji:

Bezpieczeństwo aktywności

In Android 17, the platform continues its shift toward a "secure-by-default" architecture, introducing a suite of enhancements designed to mitigate high-severity exploits such as phishing, interaction hijacking, and confused deputy attacks. This update requires developers to explicitly opt in to new security standards to maintain app compatibility and user protection.

Key impacts for developers include:

• BAL hardening & improved opt-in: We are refining Background Activity Launch (BAL) restrictions by extending protections to IntentSender. Developers must migrate away from the legacy MODE_BACKGROUND_ACTIVITY_START_ALLOWED constant. Instead, you should adopt granular controls like MODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE, which restricts activity starts to scenarios where the calling app is visible, significantly reducing the attack surface.
• Adoption tools: Developers should utilize strict mode and updated lint checks to identify legacy patterns and ensure readiness for future target SDK requirements.

Domyślne włączanie CT

Jeśli aplikacja jest kierowana na Androida 17 (API na poziomie 37) lub nowszego, przejrzystość certyfikatów (CT) jest domyślnie włączona. (Na Androidzie 16 CT jest dostępny, ale aplikacje musiały wyrazić zgodę na jego używanie).

Bezpieczniejszy natywny DCL-C

If your app targets Android 17 (API level 37) or higher, the Safer Dynamic Code Loading (DCL) protection introduced in Android 14 for DEX and JAR files now extends to native libraries.

All native files loaded using System.load() must be marked as read-only. Otherwise, the system throws UnsatisfiedLinkError.

We recommend that apps avoid dynamically loading code whenever possible, as doing so greatly increases the risk that an app can be compromised by code injection or code tampering.

Ograniczanie pól umożliwiających identyfikację osób w widoku danych CP2

For apps targeting Android 17 (API level Android 17 (API level 37)) and higher, Contacts Provider 2 (CP2) restricts certain columns containing Personally Identifiable Information (PII) from the data view. When this change is enabled, these columns are removed from the data view to enhance user privacy. The restricted columns include:

• ACCOUNT_NAME
• ACCOUNT_TYPE
• ACCOUNT_TYPE_AND_DATA_SET

Apps that are using these columns from ContactsContract.Data can extract them from ContactsContract.RawContacts instead, by joining with RAW_CONTACT_ID.

Wymuszanie rygorystycznych kontroli SQL w CP2

W przypadku aplikacji kierowanych na Androida 17 (interfejs API na poziomie 37) i nowszych dostawca kontaktów 2 (CP2) wymusza ścisłą weryfikację zapytań SQL, gdy uzyskiwany jest dostęp do tabeli ContactsContract.Data bez uprawnienia READ_CONTACTS.

Po wprowadzeniu tej zmiany, jeśli aplikacja nie ma uprawnień READ_CONTACTS, podczas wysyłania zapytań do tabeli ContactsContract.Data ustawiane są opcje StrictColumns i StrictGrammar. Jeśli zapytanie używa wzorca, który nie jest z nimi zgodny, zostanie odrzucone i spowoduje zgłoszenie wyjątku.

Inteligencja

W Androidzie 17 wprowadziliśmy te zmiany w zakresie inteligencji systemowej.

Wycofanie metody setContentCaptureEnabled

Content Capture is enabled by default on certain devices to allow on-device AI features to analyze screen contents for intelligent experiences.

Starting in Android 17, the ContentCaptureManager.setContentCaptureEnabled(boolean) API method is deprecated. For apps that target Android 17 (API level 37) or higher, calling setContentCaptureEnabled(false) no longer disables Content Capture.

If your app needs to continue disabling Content Capture or restrict screen contents from being captured by the system, you must transition to using the FLAG_SECURE window layout parameter.

To disable Content Capture, set the FLAG_SECURE flag on your window as shown in the following example:

window.setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
)

getWindow().setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
);

For more details, see the WindowManager.LayoutParams.FLAG_SECURE reference documentation.

Multimedia

W Androidzie 17 wprowadziliśmy te zmiany w działaniu multimediów.

Wzmacnianie zabezpieczeń dźwięku w tle

Od Androida 17 platforma audio wymusza ograniczenia dotyczące interakcji audio w tle, w tym odtwarzania dźwięku, żądań aktywności audio i interfejsów API zmiany głośności, aby mieć pewność, że te zmiany są inicjowane celowo przez użytkownika.

Niektóre ograniczenia dotyczące dźwięku obowiązują w przypadku wszystkich aplikacji. Jeśli jednak aplikacja jest kierowana na Androida 17 (API na poziomie 37), ograniczenia są bardziej rygorystyczne. Jeśli jedna z tych aplikacji wchodzi w interakcję z dźwiękiem, gdy działa w tle, musi mieć uruchomioną usługę na pierwszym planie. Oprócz tego aplikacja musi spełniać co najmniej 1 z tych wymagań:

• Usługa na pierwszym planie musi mieć funkcje obowiązujące podczas używania.
• Aplikacja musi mieć uprawnienie alarm precyzyjny i korzystać ze strumieni audio USAGE_ALARM.

Więcej informacji, w tym strategie ograniczania ryzyka, znajdziesz w artykule Zwiększanie bezpieczeństwa dźwięku w tle.

Formaty urządzeń

Android 17 wprowadza te zmiany, aby zwiększyć wygodę użytkowników na urządzeniach o różnych rozmiarach i formach.

Zmiany w interfejsie Platform API, które powodują ignorowanie ograniczeń dotyczących orientacji, możliwości zmiany rozmiaru i formatu obrazu na dużych ekranach (sw>=600dp)

W Androidzie 16 wprowadziliśmy zmiany w interfejsie Platform API, aby ignorować ograniczenia dotyczące orientacji, formatu obrazu i możliwości zmiany rozmiaru na dużych ekranach (sw >= 600 dp) w przypadku aplikacji korzystających z API na poziomie 36 lub nowszym. Deweloperzy mogą zrezygnować z tych zmian w przypadku pakietu SDK 36, ale ta opcja nie będzie już dostępna w przypadku aplikacji, których docelowy poziom to Android 17 (interfejs API na poziomie 37) lub nowszy.

Więcej informacji znajdziesz w artykule Ograniczenia dotyczące orientacji i możliwości zmiany rozmiaru są ignorowane.

Łączność

Android 17 wprowadza tę zmianę, aby zwiększyć spójność i dostosować działanie gniazd Bluetooth RFCOMM do standardowego zachowania języka Java InputStream.

Spójne działanie metody read() w przypadku gniazd BluetoothSocket RFCOMM

W przypadku aplikacji kierowanych na Androida 17 (poziom API 37) metoda read() obiektu InputStream uzyskanego z gniazda BluetoothSocket opartego na RFCOMM zwraca teraz wartość -1, gdy gniazdo jest zamknięte lub połączenie zostało przerwane.

Ta zmiana ujednolica działanie gniazd RFCOMM z gniazdami LE CoC i jest zgodna z dokumentacją standardu InputStream.read(), która mówi, że po osiągnięciu końca strumienia zwracana jest wartość -1.

Aplikacje, które polegają wyłącznie na przechwytywaniu wyjątku IOException w celu przerwania pętli odczytu, mogą odczuć skutki tej zmiany. Powinny zaktualizować pętle odczytu gniazd BluetoothSocket, aby jawnie sprawdzać wartość zwracaną -1. Dzięki temu pętla zakończy się prawidłowo, gdy urządzenie zdalne zostanie odłączone lub gniazdo zostanie zamknięte. Przykładową implementację znajdziesz we fragmencie kodu w przewodniku Przesyłanie danych przez Bluetooth.