Zmiany zachowania: aplikacje kierowane na Androida 14 lub nowszego

Podobnie jak w przypadku poprzednich wersji Androida, w Androidzie 14 wprowadzono 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 14 (API na poziomie 34) lub nowszego. Jeśli Twoja aplikacja jest kierowana na Androida 14 lub nowszego, zmodyfikuj ją, aby prawidłowo obsługiwała te zachowania, w stosownych przypadkach.

Zapoznaj się też z listą zmian w zachowaniu, które wpływają na wszystkie aplikacje działające na Androidzie 14, niezależnie od targetSdkVersion aplikacji.

Główna funkcja

Typy usług na pierwszym planie są wymagane

Jeśli aplikacja jest kierowana na Androida 14 (poziom interfejsu API 34) lub nowszego, musi określać co najmniej jeden typ usługi na pierwszym planie dla każdej usługi na pierwszym planie w aplikacji. Należy wybrać typ usługi na pierwszym planie, który odpowiada zastosowaniu aplikacji. System oczekuje, że usługi na pierwszym planie o określonym typie będą spełniać określone przypadki użycia.

Jeśli przypadek użycia w aplikacji nie jest powiązany z żadnym z tych typów, zdecydowanie zalecamy przeniesienie logiki na WorkManager lub zadania przesyłania danych inicjowane przez użytkownika.

Wymuszanie uprawnień BLUETOOTH_CONNECT w BluetoothAdapter

Android 14 wymusza uprawnienie BLUETOOTH_CONNECT podczas wywoływania metody BluetoothAdapter getProfileConnectionState() w przypadku aplikacji kierowanych na Androida 14 (poziom API 34) lub nowszego.

Ta metoda wymagała już uprawnienia BLUETOOTH_CONNECT, ale nie była ona egzekwowana. Upewnij się, że aplikacja deklaruje uprawnienie BLUETOOTH_CONNECT w pliku AndroidManifest.xml, jak pokazano w tym fragmencie, i sprawdź, czy użytkownik przyznał odpowiednie uprawnienia przed wywołaniem funkcji getProfileConnectionState.

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

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.

Niektóre z tych zmian mogą mieć wpływ na zgodność aplikacji:

  • Zmiany w wyrażeniach regularnych: nieprawidłowe odwołania do grup są teraz niedozwolone, aby bardziej odpowiadać semantyce OpenJDK. Możesz zauważyć nowe przypadki, w których klasa java.util.regex.Matcher wyrzuca błąd IllegalArgumentException. Dlatego przetestuj aplikację pod kątem obszarów, które używają wyrażeń regularnych. Aby włączyć lub wyłączyć tę zmianę podczas testowania, włącz lub wyłącz flagę DISALLOW_INVALID_GROUP_REFERENCE za pomocą narzędzi platformy zgodności.
  • Obsługa UUID: metoda java.util.UUID.fromString() przeprowadza teraz bardziej rygorystyczne kontrole podczas sprawdzania argumentu wejściowego, więc podczas deserializacji możesz zobaczyć błądIllegalArgumentException. Aby włączyć lub wyłączyć tę zmianę podczas testowania, włącz lub wyłącz flagę ENABLE_STRICT_VALIDATION za pomocą narzędzi platformy zgodności.
  • Problemy z ProGuard: w niektórych przypadkach dodanie klasy java.lang.ClassValue powoduje problemy, gdy próbujesz zmniejszyć rozmiar, zaciemnić i zoptymalizować aplikację za pomocą ProGuard. Problem pochodzi z biblioteki Kotlina, która zmienia zachowanie w czasie wykonywania w zależności od tego, czy funkcja Class.forName("java.lang.ClassValue") zwraca klasę. Jeśli Twoja aplikacja została opracowana na podstawie starszej wersji środowiska uruchomieniowego bez dostępnej klasy java.lang.ClassValue, te optymalizacje mogą usunąć metodę computeValue z klas wywodzących się z klasy java.lang.ClassValue.

JobScheduler wzmacnia wywołania zwrotne i zachowanie sieciowe

Since its introduction, JobScheduler expects your app to return from onStartJob or onStopJob within a few seconds. Prior to Android 14, if a job runs too long, the job is stopped and fails silently. If your app targets Android 14 (API level 34) or higher and exceeds the granted time on the main thread, the app triggers an ANR with the error message "No response to onStartJob" or "No response to onStopJob".

This ANR may be a result of 2 scenarios: 1. There is work blocking the main thread, preventing the callbacks onStartJob or onStopJob from executing and completing within the expected time limit. 2. The developer is running blocking work within the JobScheduler callback onStartJob or onStopJob, preventing the callback from completing within the expected time limit.

To address #1, you will need to further debug what is blocking the main thread when the ANR occurs, you can do this using ApplicationExitInfo#getTraceInputStream() to get the tombstone trace when the ANR occurs. If you're able to manually reproduce the ANR, you can record a system trace and inspect the trace using either Android Studio or Perfetto to better understand what is running on the main thread when the ANR occurs. Note that this can happen when using JobScheduler API directly or using the androidx library WorkManager.

To address #2, consider migrating to WorkManager, which provides support for wrapping any processing in onStartJob or onStopJob in an asynchronous thread.

JobScheduler also introduces a requirement to declare the ACCESS_NETWORK_STATE permission if using setRequiredNetworkType or setRequiredNetwork constraint. If your app does not declare the ACCESS_NETWORK_STATE permission when scheduling the job and is targeting Android 14 or higher, it will result in a SecurityException.

Interfejs API uruchamiania kafelków

W przypadku aplikacji kierowanych do użytkowników, którzy ukończyli 14 lat, Narzędzie TileService#startActivityAndCollapse(Intent) zostało wycofane i obecnie zgłasza tylko w przypadku wywołania. Jeśli aplikacja uruchamia czynności z kart, użyj zamiast tego TileService#startActivityAndCollapse(PendingIntent).

Prywatność

Częściowy dostęp do zdjęć i filmów

Android 14 introduces Selected Photos Access, which allows users to grant apps access to specific images and videos in their library, rather than granting access to all media of a given type.

This change is only enabled if your app targets Android 14 (API level 34) or higher. If you don't use the photo picker yet, we recommend implementing it in your app to provide a consistent experience for selecting images and videos that also enhances user privacy without having to request any storage permissions.

If you maintain your own gallery picker using storage permissions and need to maintain full control over your implementation, adapt your implementation to use the new READ_MEDIA_VISUAL_USER_SELECTED permission. If your app doesn't use the new permission, the system runs your app in a compatibility mode.

Interfejs użytkownika

Zabezpieczanie powiadomień o intencjach pełnoekranowych

W Androidzie 11 (poziom API 30) każda aplikacja mogła używać interfejsu Notification.Builder.setFullScreenIntent do wysyłania intencji pełnoekranowych, gdy telefon jest zablokowany. Możesz przyznać je automatycznie podczas instalowania aplikacji, deklarując uprawnienie USE_FULL_SCREEN_INTENT w pliku AndroidManifest.

Powiadomienia z intencją pełnoekranową są przeznaczone do powiadomień o bardzo wysokim priorytecie, które wymagają natychmiastowej uwagi użytkownika, takich jak połączenie telefoniczne czy alarm ustawiony przez użytkownika. W przypadku aplikacji kierowanych na Androida 14 (poziom API 34) i nowszych wersje uprawnienia do korzystania z tego uprawnienia są ograniczone do aplikacji, które umożliwiają tylko dzwonienie i alarmy. Sklep Google Play odwołuje domyślne uprawnienia USE_FULL_SCREEN_INTENT w przypadku wszystkich aplikacji, które nie pasują do tego profilu. Termin wdrożenia tych zmian zasad to 31 maja 2024 r.

To uprawnienie pozostaje włączone w przypadku aplikacji zainstalowanych na telefonie przed aktualizacją do Androida 14. Użytkownicy mogą włączać i wyłączać to uprawnienie.

Możesz użyć nowego interfejsu API NotificationManager.canUseFullScreenIntent, aby sprawdzić, czy Twoja aplikacja ma to uprawnienie. Jeśli nie, może ona użyć nowego zamiaru ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT, aby otworzyć stronę ustawień, na której użytkownicy mogą przyznać uprawnienie.

Bezpieczeństwo

Ograniczenia dotyczące niejawnych i oczekujących intencji

For apps targeting Android 14 (API level 34) or higher, Android restricts apps from sending implicit intents to internal app components in the following ways:

  • Implicit intents are only delivered to exported components. Apps must either use an explicit intent to deliver to unexported components, or mark the component as exported.
  • If an app creates a mutable pending intent with an intent that doesn't specify a component or package, the system throws an exception.

These changes prevent malicious apps from intercepting implicit intents that are intended for use by an app's internal components.

For example, here is an intent filter that could be declared in your app's manifest file:

<activity
    android:name=".AppActivity"
    android:exported="false">
    <intent-filter>
        <action android:name="com.example.action.APP_ACTION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

If your app tried to launch this activity using an implicit intent, an ActivityNotFoundException exception would be thrown:

Kotlin

// Throws an ActivityNotFoundException exception when targeting Android 14.
context.startActivity(Intent("com.example.action.APP_ACTION"))

Java

// Throws an ActivityNotFoundException exception when targeting Android 14.
context.startActivity(new Intent("com.example.action.APP_ACTION"));

To launch the non-exported activity, your app should use an explicit intent instead:

Kotlin

// This makes the intent explicit.
val explicitIntent =
        Intent("com.example.action.APP_ACTION")
explicitIntent.apply {
    package = context.packageName
}
context.startActivity(explicitIntent)

Java

// This makes the intent explicit.
Intent explicitIntent =
        new Intent("com.example.action.APP_ACTION")
explicitIntent.setPackage(context.getPackageName());
context.startActivity(explicitIntent);

Odbiorniki zarejestrowane w czasie działania muszą określać działanie dotyczące eksportu

Aplikacje i usługi kierowane na Androida 14 (poziom API 34) lub nowszego i korzystające z odbiorników rejestrowanych w kontekście muszą zawierać flagę wskazującą, czy odbiornik ma być eksportowany do wszystkich innych aplikacji na urządzeniu (wartość RECEIVER_EXPORTED) czy nie (wartość RECEIVER_NOT_EXPORTED). To wymaganie pomaga chronić aplikacje przed lukami w zabezpieczeniach dzięki funkcjom tych odbiorników wprowadzonym w Androidzie 13.

Wyjątek dla odbiorników, które odbierają tylko transmisje systemowe

Jeśli Twoja aplikacja rejestruje odbiornik tylko w celu przekazywania danych z systemu za pomocą metod Context#registerReceiver, takich jak Context#registerReceiver(), nie powinna określać flagi podczas rejestrowania odbiornika.

Bezpieczniejsze wczytywanie kodu dynamicznego

Jeśli Twoja aplikacja jest kierowana na Androida 14 (poziom interfejsu API 34) lub nowszego i korzysta z kodu dynamicznego Ładowanie (DCL) powoduje, że wszystkie dynamicznie ładowane pliki muszą być oznaczone jako tylko do odczytu. W przeciwnym razie system zgłasza wyjątek. Zalecamy, aby aplikacje unikały dynamiczne wczytywanie kodu bo to znacznie zwiększa ryzyko, że aplikacja został przejęty przez wstrzyknięcie kodu lub zmodyfikowanie kodu.

Jeśli musisz dynamicznie ładować kod, użyj następującej metody, aby ustawić atrybut dynamicznie ładowany (np. DEX, JAR czy APK) jako tylko do odczytu podczas otwierania pliku i do zapisywania treści:

Kotlin

val jar = File("DYNAMICALLY_LOADED_FILE.jar")
val os = FileOutputStream(jar)
os.use {
    // Set the file to read-only first to prevent race conditions
    jar.setReadOnly()
    // Then write the actual file content
}
val cl = PathClassLoader(jar, parentClassLoader)

Java

File jar = new File("DYNAMICALLY_LOADED_FILE.jar");
try (FileOutputStream os = new FileOutputStream(jar)) {
    // Set the file to read-only first to prevent race conditions
    jar.setReadOnly();
    // Then write the actual file content
} catch (IOException e) { ... }
PathClassLoader cl = new PathClassLoader(jar, parentClassLoader);

Obsługa plików ładowanych dynamicznie, które już istnieją

Aby zapobiec wyrzucaniu wyjątków w przypadku istniejących plików wczytywanych dynamicznie, zalecamy usunięcie i ponowne utworzenie plików przed ponownym wczytaniem ich dynamicznie w aplikacji. Podczas ponownego tworzenia plików postępuj zgodnie z poprzednimi wskazówkami dotyczącymi oznaczania plików jako tylko do odczytu w momencie zapisu. Ewentualnie możesz zmienić etykiety istniejących plików na „tylko do odczytu”, ale w tym przypadku zdecydowanie zalecamy wcześniejsze sprawdzenie integralności plików (na przykład porównując podpis pliku z zaufaną wartością), pomaga to chronić aplikację przed złośliwymi działaniami.

Dodatkowe ograniczenia dotyczące rozpoczynania działań w tle

For apps targeting Android 14 (API level 34) or higher, the system further restricts when apps are allowed to start activities from the background:

These changes expand the existing set of restrictions to protect users by preventing malicious apps from abusing APIs to start disruptive activities from the background.

Przemierzanie ścieżki ZIP

For apps targeting Android 14 (API level 34) or higher, Android prevents the Zip Path Traversal Vulnerability in the following way: ZipFile(String) and ZipInputStream.getNextEntry() throws a ZipException if zip file entry names contain ".." or start with "/".

Apps can opt-out from this validation by calling dalvik.system.ZipPathValidator.clearCallback().

For apps targeting Android 14 (API level 34) or higher, a SecurityException is thrown by MediaProjection#createVirtualDisplay in either of the following scenarios:

Your app must ask the user to give consent before each capture session. A single capture session is a single invocation on MediaProjection#createVirtualDisplay, and each MediaProjection instance must be used only once.

Handle configuration changes

If your app needs to invoke MediaProjection#createVirtualDisplay to handle configuration changes (such as the screen orientation or screen size changing), you can follow these steps to update the VirtualDisplay for the existing MediaProjection instance:

  1. Invoke VirtualDisplay#resize with the new width and height.
  2. Provide a new Surface with the new width and height to VirtualDisplay#setSurface.

Register a callback

Your app should register a callback to handle cases where the user doesn't grant consent to continue a capture session. To do this, implement Callback#onStop and have your app release any related resources (such as the VirtualDisplay and Surface).

If your app doesn't register this callback, MediaProjection#createVirtualDisplay throws an IllegalStateException when your app invokes it.

Zaktualizowane ograniczenia dotyczące interfejsów API innych niż SDK

Android 14 zawiera zaktualizowane listy ograniczonych interfejsów innych niż SDK, które powstały na podstawie współpracy z deweloperami Androida i najnowszych testów wewnętrznych. W miarę możliwości przed ograniczeniem interfejsów innych niż SDK udostępniamy publiczne alternatywy.

Jeśli Twoja aplikacja nie jest kierowana na Androida 14, niektóre z tych zmian mogą nie mieć na nią natychmiastowego wpływu. Obecnie możesz używać niektórych interfejsów spoza SDK (w zależności od docelowego poziomu interfejsu API aplikacji), ale używanie dowolnej metody lub pola spoza SDK zawsze wiąże się z wysokim ryzykiem awarii aplikacji.

Jeśli nie masz pewności, czy Twoja aplikacja używa interfejsów innych niż SDK, możesz to sprawdzić, testując ją. Jeśli Twoja aplikacja korzysta z interfejsów spoza SDK, zacznij planować migrację na alternatywne rozwiązania SDK. Rozumiemy jednak, że w przypadku niektórych aplikacji używanie interfejsów innych niż SDK jest uzasadnione. Jeśli nie możesz znaleźć alternatywy dla używania interfejsu innego niż SDK w przypadku funkcji w aplikacji, poproś o nowy publiczny interfejs API.

To learn more about the changes in this release of Android, see Updates to non-SDK interface restrictions in Android 14. To learn more about non-SDK interfaces generally, see Restrictions on non-SDK interfaces.