Zmiany zachowania: aplikacje kierowane na Androida 14 lub nowszego

Podobnie jak w przypadku poprzednich wersji Androida, w Androidzie 14 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 14 (poziom 34 interfejsu API) lub nowszego. Jeśli Twoja aplikacja jest kierowana na Androida 14 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 14 niezależnie od aplikacji targetSdkVersion.

Główna funkcjonalność

Wymagane są typy usług działających na pierwszym planie

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.

Egzekwowanie uprawnienia 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 działanie wywołania zwrotnego i sieci

Od momentu wprowadzenia JobScheduler oczekuje, że aplikacja wróci z onStartJob lub onStopJob w ciągu kilku sekund. Przed Androidem 14 Jeśli zadanie będzie działać zbyt długo, zostanie zatrzymane, a jego wykonanie zakończy się dyskretnie. Jeśli Twoja aplikacja jest kierowana na Androida 14 (poziom interfejsu API 34) lub nowszego przekracza ustalony czas w wątku głównym, aplikacja wywołuje błąd ANR z komunikatem o błędzie „Brak odpowiedzi dla: onStartJob”. lub „Brak odpowiedzi na: onStopJob”.

Przyczyną tego błędu ANR mogą być 2 sytuacje: 1. Istnieje praca blokująca wątek główny, która uniemożliwia wywołania zwrotne onStartJob lub onStopJob od wykonania i ukończenia w oczekiwanym czasie. 2. Deweloper realizuje prace blokujące w harmonogramie zadań oddzwanianie onStartJob lub onStopJob, co uniemożliwia oddzwonienie z w oczekiwanym czasie.

Aby rozwiązać problem 1, musisz dokładniej debugować, co blokuje wątek główny. po wystąpieniu błędu ANR możesz to zrobić, korzystając z funkcji ApplicationExitInfo#getTraceInputStream(), aby zdobyć nagrobek śledzić, gdy wystąpi błąd ANR. Jeśli możesz ręcznie odtworzyć błąd ANR, możesz zarejestrować ślad systemu i sprawdzić go za pomocą Android Studio lub Perfetto, aby lepiej zrozumieć, co działa na w wątku głównym, gdy wystąpi błąd ANR. Pamiętaj, że może się to zdarzyć, gdy używasz interfejsu JobScheduler API bezpośrednio lub biblioteki androidx WorkManager.

Aby rozwiązać problem 2, rozważ migrację do WorkManagera, który obsługuje owinięcie dowolnego przetwarzania w onStartJob lub onStopJob w wątku asynchronicznym.

JobScheduler nakłada również wymóg deklarowania uprawnienia ACCESS_NETWORK_STATE, jeśli używasz setRequiredNetworkType lub Ograniczenie setRequiredNetwork. Jeśli podczas planowania zadania aplikacja nie deklaruje uprawnienia ACCESS_NETWORK_STATE i jest kierowana na Androida 14 lub nowszego, otrzymasz błąd 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 wprowadza dostęp do wybranych zdjęć, który pozwala użytkownikom przyznawać aplikacjom dostęp do konkretnych obrazów i filmów w bibliotece, zamiast przyznawać dostęp do wszystkich multimediów danego typu.

Ta zmiana jest dostępna tylko wtedy, gdy Twoja aplikacja jest kierowana na Androida 14 (poziom API 34) lub nowszego. Jeśli nie korzystasz jeszcze z selektora zdjęć, zalecamy wdrożenie go w aplikacji, aby zapewnić spójne działanie funkcji wybierania zdjęć i filmów. W ten sposób zwiększysz też prywatność użytkowników bez konieczności proszenia o jakiekolwiek uprawnienia do przechowywania.

Jeśli masz własną aplikację do wybierania zdjęć, która korzysta z uprawnień dostępu do pamięci, i chcesz zachować pełną kontrolę nad jej implementacją, zmodyfikuj implementację, aby używała nowego uprawnienia READ_MEDIA_VISUAL_USER_SELECTED. Jeśli aplikacja nie korzysta z nowych uprawnień, system uruchamia ją w trybie zgodności.

Wrażenia użytkownika

Bezpieczne powiadomienia intencji pełnoekranowej

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 intencji niejawnych i oczekujących

W przypadku aplikacji kierowanych na Androida 14 (poziom interfejsu API 34) lub nowszego Android ogranicza możliwość wysyłania intencji niejawnych do wewnętrznych komponentów aplikacji w ten sposób:

  • Implicit intents są dostarczane tylko do komponentów eksportowanych. Aplikacje muszą używać jawnej intencji, by dostarczyć komponenty do niewyeksportowanych komponentów, lub oznaczyć komponent jako wyeksportowany.
  • Jeśli aplikacja tworzy zmienną oczekującą intencję z intencją, która nie określa komponentu ani pakietu, system zgłasza wyjątek.

Te zmiany zapobiegają przechwytywaniu niejawnych intencji, które mają być używane przez wewnętrzne komponenty aplikacji.

Oto przykładowy filtr intencji, który można zadeklarować w pliku manifestu aplikacji:

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

Jeśli aplikacja spróbuje uruchomić tę aktywność za pomocą domyślnego zamiaru, zostanie zgłoszony wyjątek ActivityNotFoundException:

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"));

Aby uruchomić aktywność, która nie została wyeksportowana, aplikacja powinna użyć wyraźnego zamiaru:

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

如果您的应用以 Android 14（API 级别 34）或更高版本为目标平台并使用动态代码 正在加载 (DCL)，所有动态加载的文件都必须标记为只读。 否则，系统会抛出异常。我们建议应用尽可能避免动态加载代码，因为这样做会大大增加应用因代码注入或代码篡改而遭到入侵的风险。

如果必须动态加载代码，请使用以下方法，在动态文件（例如 DEX、JAR 或 APK 文件）打开并写入任何内容之前立即将其设为只读：

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);

处理已存在的动态加载文件

为防止系统对现有动态加载的文件抛出异常，我们建议您先删除并重新创建文件，然后再尝试在应用中重新动态加载这些文件。重新创建文件时，请按照上述指南在写入时将文件标记为只读。或者，您可以将现有文件重新标记为只读，但在这种情况下，我们强烈建议您先验证文件的完整性（例如，对照可信值检查文件的签名）以保护应用免遭恶意操作的影响。

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

W przypadku aplikacji kierowanych na Androida 14 (interfejs API na poziomie 34) lub nowszego system dodatkowo ogranicza, kiedy aplikacje mogą uruchamiać działania w tle:

  • Gdy aplikacja wysyła PendingIntent za pomocą PendingIntent#send() lub podobnych metod, musi wyrazić zgodę, jeśli chce przyznać uprawnienia do uruchamiania własnych działań w tle, aby rozpocząć oczekującą intencję. Aby wyrazić zgodę, aplikacja musi przekazać pakiet ActivityOptions z setPendingIntentBackgroundActivityStartMode(MODE_BACKGROUND_ACTIVITY_START_ALLOWED).
  • Gdy widoczna aplikacja wiąże usługę innej aplikacji, która działa w tle, za pomocą metody bindService(), musi teraz zdecydować, czy chce przyznać tej usłudze uprawnienia do uruchamiania własnych działań w tle. Aby wyrazić zgodę, aplikacja powinna zawierać flagę BIND_ALLOW_ACTIVITY_STARTS podczas wywoływania metody bindService().

Te zmiany rozszerzają istniejący zestaw ograniczeń, aby chronić użytkowników przed złośliwymi aplikacjami, które nadużywają interfejsów API do uruchamiania zakłócających działań w tle.

Zip path traversal

W przypadku aplikacji kierowanych na Androida 14 (poziom API 34) lub nowszego Android zapobiega podatności na atak polegający na przemierzaniu ścieżki w pliku ZIP w następujący sposób: ZipFile(String) i ZipInputStream.getNextEntry() zgłaszaZipException błąd, jeśli nazwy elementów pliku ZIP zawierają „..” lub zaczynają się od „/”.

Aplikacje mogą zrezygnować z tej weryfikacji, wywołując funkcję dalvik.system.ZipPathValidator.clearCallback().

W przypadku aplikacji kierowanych na Androida 14 (API na poziomie 34) lub nowszego SecurityException jest zgłaszany przez MediaProjection#createVirtualDisplay w jednym z tych scenariuszy:

Aplikacja musi prosić użytkownika o zgodę przed każdą sesją rejestrowania. Pojedyncza sesja rejestrowania to pojedyncze wywołanie funkcji MediaProjection#createVirtualDisplay, a każde wystąpienie MediaProjection#createVirtualDisplay może być użyte tylko raz.MediaProjection

Obsługa zmian konfiguracji

Jeśli Twoja aplikacja musi wywołać MediaProjection#createVirtualDisplay, aby obsłużyć zmiany konfiguracji (np. zmianę orientacji lub rozmiaru ekranu), możesz zaktualizować VirtualDisplay dla istniejącego wystąpienia MediaProjection, wykonując te czynności:

  1. Wywołaj VirtualDisplay#resize z nową szerokością i wysokością.
  2. Dodaj nowy Surface o nowej szerokości i wysokości, aby użyć go w miejscu VirtualDisplay#setSurface.

Rejestrowanie wywołania zwrotnego

Aplikacja powinna zarejestrować funkcję wywołania zwrotnego, aby obsłużyć przypadki, gdy użytkownik nie wyrazi zgody na kontynuowanie sesji rejestrowania. Aby to zrobić, wdrożyć Callback#onStop i opublikować w aplikacji odpowiednie zasoby (takie jak VirtualDisplay i Surface).

Jeśli aplikacja nie zarejestruje tego wywołania zwrotnego, funkcja MediaProjection#createVirtualDisplay rzuci wyjątek IllegalStateException, gdy aplikacja ją wywoła.

Zaktualizowane ograniczenia dotyczące interfejsów API spoza 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.

Więcej informacji o zmianach w tej wersji Androida znajdziesz w artykule Zmiany ograniczeń interfejsu niebędącego interfejsem SDK w Androidzie 14. Więcej informacji o interfejsach innych niż SDK znajdziesz w artykule Ograniczenia dotyczące interfejsów innych niż SDK.