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

Przejście z wersji starszej niż Android 11 (poziom API 30)

Wybierz wersję Androida, z której chcesz przenieść dane:

Przejście na Androida 5 (poziom API 21)

Zapoznaj się ze stronami dotyczącymi zmian w działaniu poszczególnych wersji, aby upewnić się, ż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 API 16)

Aby kontynuować, postępuj zgodnie z instrukcjami w następnej sekcji.

Migracja do Androida 6 (poziom interfejsu API 23)

W przypadku aplikacji kierowanych na Androida 6.0 i nowsze wersje platformy obowiązują te kwestie:

• Uprawnienia czasu działania

  • Niebezpieczne uprawnienia są przyznawane tylko w czasie działania aplikacji. Interfejsy przepływów muszą umożliwiać przyznawanie tych uprawnień.

  • W miarę możliwości zadbaj o to, aby aplikacja była przygotowana na odrzucenie próśb o przyznanie uprawnień. Jeśli na przykład użytkownik odrzuci prośbę o dostęp do GPS-u urządzenia, upewnij się, że aplikacja może kontynuować działanie w inny sposób.

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

Aby kontynuować, postępuj zgodnie z instrukcjami w następnej sekcji.

Przejście na Androida 7 (poziom interfejsu API 24)

W przypadku aplikacji kierowanych na Androida 7.0 i nowsze wersje platformy obowiązują te kwestie:

• Uśpienie i tryb gotowości aplikacji

  Projektuj aplikacje pod kątem zachowań opisanych w artykule Optymalizacja pod kątem funkcji Uśpienie i Czuwanie aplikacji, który obejmuje stopniowe zmiany wprowadzane w kilku wersjach platformy.

  Gdy urządzenie jest w trybie uśpienia lub czuwania aplikacji, system działa w ten 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 o normalnym priorytecie.

• Zmiany uprawnień

  • System ogranicza dostęp do prywatnych katalogów aplikacji.
  • Udostępnienie identyfikatora URI file:// poza aplikacją wywołuje FileUriExposedException. Jeśli musisz udostępniać pliki poza aplikację, zaimplementujFileProvider

• System uniemożliwia łączenie z bibliotekami innymi niż NDK.

Pełną listę zmian wprowadzonych w Androidzie 7.0 (poziom API 24) znajdziesz na stronie Zmiany zachowania dotyczącej tej wersji platformy.

Aby kontynuować, postępuj zgodnie z instrukcjami w następnej sekcji.

Migracja do Androida 8 (poziom 26 interfejsu API)

W przypadku aplikacji kierowanych na Androida 8.0 i nowsze wersje platformy obowiązują te kwestie:

• Limity wykonywania w tle
  • System ogranicza usługi dla aplikacji, które nie są uruchomione na pierwszym planie.
    • startService() zgłasza teraz wyjątek, gdy aplikacja próbuje go wywołać, a startService() jest zabronione.
    • Aby uruchomić usługi na pierwszym planie, aplikacja musi używać startForeground() i  startForegroundService().
    • Dokładnie zapoznaj się ze zmianami wprowadzonymi w interfejsie JobScheduler API, które zostały opisane na stronie ze zmianami w zachowaniu w Androidzie 8.0 (poziom 26 interfejsu API).
    • Firebase Cloud Messaging 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 konieczne jest wykonanie pracy w tle, np. synchronizacja danych w tle, aplikacja powinna planować zadania za pomocą Firebase Job Dispatcher lub JobIntentService. Więcej informacji znajdziesz w  dokumentacji Firebase Cloud Messaging.
  • Komunikaty ogólne
    • Implicite transmisje są ograniczone. Informacje o obsłudze zdarzeń w tle znajdziesz w dokumentacji interfejsu JobScheduler API.
  • Ograniczenia dotyczące 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 używaj połączonego dostawcy lokalizacji, aby okresowo otrzymywać aktualizacje lokalizacji.
• Kanały powiadomień
  • Właściwości przerywania powiadomień należy definiować dla każdego kanału osobno.
  • Aby powiadomienia się wyświetlały, musisz przypisać je do kanału.
  • Ta wersja platformy obsługuje NotificationCompat.Builder.
• Prywatność
  • ANDROID_ID jest ograniczony do klucza podpisywania aplikacji.

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

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

• Zarządzanie zasilaniem
  • Zasobniki stanu gotowości aplikacji wprowadzają nowe ograniczenia działania w tle na podstawie zaangażowania w aplikację, takie jak odroczone zadania, alarmy i limity 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
  • Musisz poprosić o zwykłe uprawnienia FOREGROUND_SERVICE (nie o uprawnienia w czasie działania).
• Zmiany w zakresie prywatności
  • Ograniczony dostęp do czujników w tle
  • Ograniczony dostęp do rejestru połączeń, obecnie w grupie uprawnień CALL_LOG
  • Ograniczony dostęp do numerów telefonów, wymagający uprawnień READ_CALL_LOG
  • Ograniczony dostęp do informacji o Wi-Fi

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

Przejście z Androida 9 (poziom 28 interfejsu API) na Androida 10 (poziom 29 interfejsu API)

• Powiadomienia z intencją pełnoekranową
  • Musisz poprosić o zwykłe uprawnienia USE_FULL_SCREEN_INTENT (a nie o uprawnienia w czasie działania).
• Obsługa urządzeń składanych i urządzeń z dużym ekranem
  • Wiele aktywności może być jednocześnie w stanie „wznowiono”, ale tylko jedna z nich jest aktywna.
    • Ta zmiana wpłynie na działanie onResume() i onPause().
    • Nowa koncepcja cyklu życia „najwyżej wznawiany”, którą można wykryć, subskrybując onTopResumedActivityChanged().
      • Tylko jedna aktywność może być „najwyższą wznowioną”.
  • Gdy parametr resizeableActivity ma wartość false, aplikacje mogą dodatkowo określać parametr minAspectRatio , który automatycznie dodaje do aplikacji paski po bokach w przypadku węższych proporcji obrazu.
• Zmiany w zakresie prywatności
  • Zakres przechowywania
    • Dostęp do pamięci zewnętrznej jest ograniczony tylko do katalogu aplikacji i określonych typów multimediów utworzonych przez aplikację.
  • Ograniczony dostęp do lokalizacji, gdy aplikacja działa w tle, co wymaga zgody na ACCESS_BACKGROUND_LOCATION.
  • Ograniczony dostęp do identyfikatorów, których nie można zresetować, takich jak IMEI i numer seryjny.
  • Ograniczony dostęp do informacji o aktywności fizycznej, takich jak liczba kroków użytkownika, wymagający uprawnienia ACTIVITY_RECOGNITION.
  • Ograniczony dostęp do niektórych interfejsów API telefonii, Bluetootha i Wi-Fi, wymagający ACCESS_FINE_LOCATION zezwolenia.
  • Ograniczony dostęp do ustawień Wi-Fi
    • Aplikacje nie mogą już bezpośrednio włączać ani wyłączać Wi-Fi. Muszą to robić za pomocą paneli ustawień.
    • Ograniczenia dotyczące inicjowania połączenia z siecią Wi-Fi, które wymagają użycia WifiNetworkSpecifier lub WifiNetworkSuggestion.

Przejście z Androida 10 (poziom 29 interfejsu API) na Androida 11 (poziom 30 interfejsu API)

• Prywatność
  • Wymuszanie dostępu do pamięci w określonym zakresie : aplikacje powinny korzystać z modelu dostępu do pamięci w określonym zakresie, w którym pliki specyficzne dla aplikacji, multimedia i inne typy plików są zapisywane i dostępne w wyznaczonych lokalizacjach.
  • Automatyczne resetowanie uprawnień: jeśli użytkownicy nie korzystają z aplikacji przez kilka miesięcy, system automatycznie resetuje jej uprawnienia dostępu do danych wrażliwych. Nie powinno to mieć wpływu na większość aplikacji. Jeśli Twoja aplikacja działa głównie w tle bez interakcji z użytkownikiem, 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. Zezwolenie na dostęp do lokalizacji w tle można przyznać tylko w ustawieniach aplikacji, a nie w oknach z prośbą o dostęp do lokalizacji w czasie działania.
  • Widoczność pakietu: gdy aplikacja wysyła zapytanie o listę zainstalowanych aplikacji i usług na urządzeniu, zwracana lista jest filtrowana.
    • Jeśli korzystasz z usług zamiany tekstu na mowę lub rozpoznawania mowy, musisz dodać do pliku manifestu elementy zapytań dotyczące tych usług.
• Bezpieczeństwo
  • Skompresowane pliki `resource.arsc` nie są już obsługiwane
  • Schemat podpisywania plików APK w wersji 2 jest teraz wymagany. Ze względu na zgodność wsteczną deweloperzy powinni nadal podpisywać aplikacje za pomocą schematu podpisu plików APK w wersji 1.
  • Ograniczenie interfejsu innego niż SDK. Używanie interfejsów innych niż SDK nie jest zalecane w przypadku aplikacji kierowanych na poziom API 30, ponieważ niektóre z tych interfejsów są teraz blokowane. Pełną listę zablokowanych interfejsów innych niż SDK znajdziesz w artykule Interfejsy inne niż SDK, które są teraz blokowane w Androidzie 11.

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

Kontynuuj aktualizację do interfejsu API w wersji 31, postępując zgodnie z instrukcjami w poprzedniej sekcji.