Spełnij wymóg dotyczący docelowego poziomu interfejsu API w Google Play

Migracja z Androida niższego niż 11 (poziom API 30)

Wybierz wersję Androida, z której chcesz przeprowadzić migrację:

Przejdź na Androida 5 (poziom API 21)

Zapoznaj się z odpowiednimi stronami Zmiany w działaniu każdej z poniższych wersji, aby się upewnić, że Twoja aplikacja uwzględnia zmiany wprowadzone w tych wersjach:

• Android 5.0 (poziom API 21)
• Android 4.4 (poziom API 19)
• Android 4.1.x (poziom interfejsu API 16).

Kontynuuj, postępując zgodnie z instrukcjami w następnej sekcji.

Przejdź na Androida 6 (poziom API 23)

W przypadku aplikacji kierowanych na Androida 6.0 i nowsze wersje platformy należy pamiętać o tych kwestiach:

• Uprawnienia czasu działania

  • Niebezpieczne uprawnienia są przyznawane tylko w czasie działania. Przepływy interfejsu użytkownika muszą zapewniać uprawnienia umożliwiające przyznawanie tych uprawnień.

  • W miarę możliwości upewnij się, że aplikacja jest przygotowana na odrzucenie próśb o przyznanie uprawnień. Jeśli na przykład użytkownik odrzuci prośbę o dostęp do GPS-a, upewnij się, że aplikacja ma inny sposób postępowania.

Pełną listę zmian wprowadzonych w Androidzie 6.0 (poziom interfejsu API 23) znajdziesz na stronie Zmiany w działaniu w danej wersji platformy.

Kontynuuj, postępując zgodnie z instrukcjami w następnej sekcji.

Przejdź na Androida 7 (poziom API 24)

W przypadku aplikacji kierowanych na Androida 7.0 i nowsze wersje platformy należy pamiętać o tych kwestiach:

• Uśpienie i czuwanie aplikacji

  Projektowanie pod kątem zachowań opisanych w artykule Optymalizacja pod kątem funkcji uśpienia i czuwania aplikacji, która obejmuje stopniowe zmiany wprowadzane w kilku wersjach platformy.

  Gdy urządzenie jest w trybie uśpienia i trybie czuwania aplikacji, system działa w następujący sposób:

  • Ogranicza dostęp do sieci
  • Odkłada alarmy, synchronizacje i zadania
  • Ogranicza skanowanie GPS i Wi-Fi
  • Ogranicza wiadomości Komunikacji w chmurze Firebase (Firebase) o normalnym priorytecie.

• Zmiany uprawnień

  • System ogranicza dostęp do katalogów prywatnych aplikacji.
  • Ujawnienie identyfikatora URI file:// poza aplikacją powoduje wywołanie FileUriExposedException. Jeśli chcesz udostępniać pliki poza aplikacją, zaimplementuj funkcję FileProvider

• System zabrania łączenia z bibliotekami innymi niż NDK.

Pełną listę zmian wprowadzonych w Androidzie 7.0 (poziom interfejsu API 24) znajdziesz na stronie Zmiany w działaniu w danej wersji platformy.

Kontynuuj, postępując zgodnie z instrukcjami w następnej sekcji.

Przejdź na Androida 8 (poziom API 26)

W przypadku aplikacji kierowanych na Androida 8.0 i nowsze wersje platformy należy pamiętać o tych kwestiach:

• Limity wykonywania w tle
  • System ogranicza dostęp do usług aplikacjom, które nie działają na pierwszym planie.
    • startService() teraz zgłasza wyjątek, gdy aplikacja próbuje ją wywołać, mimo że startService() jest zabroniona.
    • Aby można było uruchomić usługi działające na pierwszym planie, aplikacja musi używać interfejsów startForeground() i startForegroundService().
    • Uważnie przejrzyj zmiany wprowadzone w interfejsie JobScheduler API zgodnie z opisem na stronie Zmiany zachowania w Androidzie 8.0 (poziom interfejsu API 26).
    • Komunikacja w chmurze Firebase (FCM) wymaga pakietu SDK Usług Google Play w wersji 10.2.1 lub nowszej.
    • W przypadku korzystania z Komunikacji w chmurze Firebase dostarczanie wiadomości podlega limitom wykonywania w tle. Jeśli po otrzymaniu wiadomości wymagana jest praca w tle, na przykład do synchronizacji danych w tle, aplikacja powinna planować zadania za pomocą usługi Firebase Job Dispatcher lub JobIntentService. Więcej informacji znajdziesz w dokumentacji Komunikacji w chmurze Firebase (FCM).
  • Komunikaty pośrednie:
    • Komunikaty niejawne są ograniczone. Informacje o obsłudze zdarzeń w tle znajdziesz w dokumentacji interfejsu API JobScheduler.
  • Limity lokalizacji w tle
    • Aplikacje działające w tle mają ograniczony dostęp do danych o lokalizacji.
      • Na urządzeniach z Usługami Google Play korzystaj z usług dostawcy uśrednionej lokalizacji, aby okresowo otrzymywać aktualne informacje o lokalizacji.
• Kanały powiadomień
  • Właściwości wyświetlania powiadomień należy zdefiniować dla poszczególnych kanałów.
  • Aby powiadomienia się wyświetlały, musisz przypisać je do kanału.
  • Ta wersja platformy obsługuje NotificationCompat.Builder.
• Prywatność
  • Identyfikator ANDROID_ID jest ograniczony do każdego klucza podpisywania aplikacji.

Pełną listę zmian wprowadzonych w Androidzie 8.0 (poziom interfejsu API 26) znajdziesz na stronie Zmiany w działaniu w danej wersji platformy.

Migracja z Androida 8 (API 26) na Androida 9 (API 28)

• Zarządzanie zasilaniem
  • Zasobniki gotowości aplikacji wprowadzają nowe ograniczenia w tle oparte na zaangażowaniu użytkowników w aplikację, takie jak odroczone zadania, alarmy i limity dotyczące wiadomości o wysokim priorytecie
  • Ulepszenia oszczędzania baterii zwiększają ograniczenia dotyczące aplikacji w trybie gotowości
• Uprawnienia usługi działającej na pierwszym planie
  • Potrzebne jest normalne uprawnienie FOREGROUND_SERVICE (a nie uprawnienie w czasie działania)
• Zmiany dotyczące prywatności
  • Ograniczony dostęp do czujników w tle
  • Ograniczony dostęp do rejestrów połączeń, teraz w grupie uprawnień CALL_LOG
  • Ograniczony dostęp do numerów telefonów, wymaga uprawnienia READ_CALL_LOG
  • Ograniczony dostęp do informacji o sieciach Wi-Fi

Pełną listę zmian wprowadzonych w Androidzie 9.0 (poziom interfejsu API 28) znajdziesz w sekcji Zmiany w działaniu.

Migracja z Androida 9 (poziom interfejsu API 28) na Androida 10 (poziom API 29)

• Powiadomienia wyświetlane w trybie pełnoekranowym
  • Musisz poprosić o zwykłe uprawnienia USE_FULL_SCREEN_INTENT (a nie uprawnienia w czasie działania).
• Obsługa urządzeń składanych i urządzeń z dużym ekranem.
  • Kilka działań może mieć teraz stan „wznowione” w tym samym czasie, ale tylko jedna z nich będzie się skupiać.
    • Ta zmiana wpływa na działanie onResume() i onPause().
    • Nowa koncepcja cyklu życia dotycząca „najwyższego wznowienia”, którą można wykryć, subskrybując onTopResumedActivityChanged().
      • Tylko jedno działanie może mieć stan „Najwyższe wznowienie”.
  • Gdy parametr resizeableActivity ma wartość false, aplikacje mogą dodatkowo określić minAspectRatio, co powoduje automatyczne dodawanie czarnych pasów do aplikacji przy węższych formatach obrazu.
• Zmiany dotyczące prywatności
  • Ograniczone miejsce na dane
    • Dostęp do pamięci zewnętrznej jest ograniczony tylko do katalogu specyficznego dla aplikacji i do określonych typów multimediów utworzonych przez aplikację.
  • Ograniczono dostęp do lokalizacji, gdy aplikacja działa w tle, i wymaga uprawnienia ACCESS_BACKGROUND_LOCATION.
  • Ograniczony dostęp do identyfikatorów, których nie można zresetować, takich jak IMEI czy numer seryjny.
  • Ograniczony dostęp do informacji o aktywności fizycznej, takich jak liczba kroków użytkownika, wymaga uprawnienia ACTIVITY_RECOGNITION.
  • Ograniczony dostęp do niektórych interfejsów API telefonii, Bluetootha i Wi-Fi, który wymaga uprawnień ACCESS_FINE_LOCATION.
  • Ograniczono dostęp do ustawień Wi-Fi.
    • Aplikacje nie mogą już bezpośrednio włączać ani wyłączać sieci Wi-Fi. Muszą to zrobić za pomocą paneli ustawień.
    • Ograniczenia dotyczące inicjowania połączenia z siecią Wi-Fi, które wymagają użycia WifiNetworkSpecifier lub WifiNetworkSuggestion.

Migracja z Androida 10 (poziom interfejsu API 29) na Androida 11 (poziom API 30)

• Prywatność
  • Wymuszanie ograniczonego dostępu do miejsca na dane : aplikacje powinny korzystać z modelu ograniczonego miejsca na dane, w którym pliki aplikacji, pliki multimedialne oraz inne są zapisywane i otwierane za pomocą specjalnych lokalizacji.
  • Automatyczne resetowanie uprawnień: jeśli użytkownicy nie korzystali z aplikacji przez kilka miesięcy, system automatycznie resetuje wrażliwe uprawnienia aplikacji. W większości aplikacji nie powinno to mieć wpływu na działanie aplikacji. Jeśli Twoja aplikacja działa głównie w tle (bez interakcji z użytkownikami), możesz poprosić użytkowników o wyłączenie automatycznego resetowania.
  • Dostęp do lokalizacji w tle: aplikacje muszą oddzielnie prosić o dostęp do lokalizacji na pierwszym planie i w tle. Dostęp do lokalizacji w tle można przyznać tylko w ustawieniach aplikacji, a nie w oknach uprawnień w czasie działania.
  • Widoczność pakietu: gdy aplikacja wysyła zapytanie o listę aplikacji i usług zainstalowanych na urządzeniu, zwracana lista jest filtrowana.
    • Jeśli korzystasz z usług Zamiana tekstu na mowę lub rozpoznawania mowy, musisz dodać do pliku manifestu elementy zapytań dla usług.
• Zabezpieczenia
  • Skompresowane pliki „resource.arsc” nie są już obsługiwane
  • Wymagany jest schemat podpisu pliku APK w wersji 2. Ze względu na zgodność wsteczną deweloperzy powinni nadal podpisywać umowy za pomocą schematu podpisu plików APK w wersji 1.
  • Ograniczenie interfejsu innego niż SDK. Korzystanie z interfejsów spoza SDK nie jest zalecane w przypadku aplikacji kierowanych na interfejs API na poziomie 30, ponieważ niektóre z tych interfejsów są teraz zablokowane. Pełną listę zablokowanych interfejsów spoza SDK znajdziesz w artykule Interfejsy spoza SDK, które są teraz blokowane w Androidzie 11.

Pełną listę zmian wprowadzonych w Androidzie 11 (poziom interfejsu API 30) znajdziesz na stronie Zmiany w działaniu.

Przejdź na interfejs API 31, postępując zgodnie z instrukcjami podanymi w poprzedniej sekcji.