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

Migracja z Androida w wersji starszej niż 11 (poziom interfejsu API 30)

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

Migracja na Androida 5 (poziom interfejsu API 21)

Zapoznaj się ze stroną Zmiany w działaniu każdej z tych wersji, aby upewnić się, że uwzględnia ona zmiany wprowadzone w tych wersjach:

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

Postępuj zgodnie z instrukcjami podanymi w następnej sekcji.

Migracja na Androida 6 (poziom interfejsu API 23)

W przypadku aplikacji kierowanych na Androida 6.0 lub nowszego, należy wziąć pod uwagę te kwestie:

• Uprawnienia czasu działania

  • Niebezpieczne uprawnienia są przyznawane tylko w czasie działania. Przepływy interfejsu muszą zawierać afordancje umożliwiające przyznanie tych uprawnień.

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

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

Postępuj zgodnie z instrukcjami podanymi 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 należy wziąć pod uwagę te kwestie:

• Uśpienie i tryb czuwania aplikacji

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

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

  • Ogranicza dostęp do sieci
  • Odracza alarmy, synchronizacje i zadania
  • Ogranicza skanowanie za pomocą GPS i Wi-Fi
  • Ogranicza wiadomości z Komunikacji w chmurze 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ą, zastosuj FileProvider

• System zakazuje łą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 dotyczącej danej wersji platformy.

Postępuj zgodnie z instrukcjami podanymi w następnej sekcji.

Migracja na Androida 8 (poziom interfejsu API 26)

W przypadku aplikacji kierowanych na Androida 8.0 i nowsze wersje platformy należy wziąć pod uwagę te kwestie:

• Limity wykonywania w tle
  • System ogranicza dostęp do usług dla aplikacji, które nie działają na pierwszym planie.
    • startService() zgłasza wyjątek, gdy aplikacja próbuje go wywołać, gdy startService() jest zabroniony.
    • Aby uruchomić usługi na pierwszym planie, aplikacja musi używać interfejsów startForeground() i startForegroundService().
    • Uważnie zapoznaj się ze zmianami wprowadzonymi w interfejsie JobScheduler API, zgodnie z dokumentacją na stronie Zmiany zachowania w Androidzie 8.0 (poziom interfejsu API 26).
    • Komunikacja w chmurze Firebase wymaga wersji 10.2.1 pakietu SDK Usług Google Play lub nowszej wersji.
    • Podczas korzystania z Komunikacji w chmurze Firebase (FCM) dostarczanie wiadomości podlega limitom wykonywania wiadomości w tle. Gdy przy odebraniu wiadomości konieczne są działania w tle, np. synchronizacja danych w tle, aplikacja powinna zaplanować zadania za pomocą usługi Firebase Job Dispatcher lub JobIntentService. Więcej informacji znajdziesz w dokumentacji Komunikacji w chmurze Firebase (FCM).
  • Komunikaty niejawne
    • Transmisje pośrednie podlegają ograniczeniom. 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 używaj dostawcy uśrednionej lokalizacji, aby co jakiś czas otrzymywać aktualizacje lokalizacji.
• Kanały powiadomień
  • Właściwości przerywania powiadomień należy zdefiniować na poziomie poszczególnych kanałów.
  • Aby powiadomienia się wyświetlały, musisz przypisać je do kanału.
  • Ta wersja platformy obsługuje NotificationCompat.Builder.
• Prywatność
  • ANDROID_ID: zakres ograniczony do klucza podpisywania aplikacji.

Pełną listę zmian wprowadzonych w Androidzie 8.0 (poziom interfejsu API 26) znajdziesz na stronie Zmiany w działaniu dotyczącej 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 aplikacji, takie jak odroczone zadania, alarmy i limity w przypadku wiadomości o wysokim priorytecie.
  • Ulepszenia w zakresie oszczędzania baterii zwiększają ograniczenia dotyczące aplikacji w trybie gotowości
• Uprawnienia usługi na pierwszym planie
  • Trzeba poprosić o normalne uprawnienia FOREGROUND_SERVICE (a nie o uprawnienia 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 uprawnień READ_CALL_LOG
  • Ograniczony dostęp do informacji o sieci 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 interfejsu API 29)

• Powiadomienia z intencjami pełnoekranowymi
  • Musisz poprosić o normalne uprawnienie USE_FULL_SCREEN_INTENT (a nie uprawnienie w czasie działania).
• Obsługa urządzeń składanych i urządzeń z dużym ekranem.
  • Kilka działań może być teraz w stanie „Wznowiono” jednocześnie, ale tylko jedna z nich jest zaznaczona.
    • Ta zmiana wpływa na działanie onResume() i onPause().
    • Nowa koncepcja cyklu życia „najwyższe wznowione”, którą można wykryć, subskrybując onTopResumedActivityChanged().
      • Tylko 1 działanie można „wznowić na najwyższym poziomie”.
  • Gdy właściwość resizeableActivity ma wartość false, aplikacje mogą dodatkowo określić minAspectRatio, który automatycznie doda do aplikacji poziome pasy w przypadku węższych formatów obrazu.
• Zmiany dotyczące prywatności
  • Ilość miejsca na dane w ograniczonym zakresie
    • Dostęp do pamięci zewnętrznej jest ograniczony tylko do katalogu określonej aplikacji oraz do określonych typów multimediów utworzonych przez tę aplikację.
  • Ograniczony dostęp do lokalizacji, gdy aplikacja działa w tle, wymaga uprawnienia 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, wymaga uprawnień ACTIVITY_RECOGNITION.
  • Ograniczony dostęp do niektórych interfejsów API telefonii, Bluetootha i Wi-Fi; wymaga uprawnień ACCESS_FINE_LOCATION.
  • Ograniczony dostęp do ustawień Wi-Fi
    • Aplikacje nie mogą już bezpośrednio włączać ani wyłączać Wi-Fi. Muszą to zrobić za pomocą paneli ustawień.
    • Ograniczenia inicjowania połączenia z siecią Wi-Fi, która wymaga użycia WifiNetworkSpecifier lub WifiNetworkSuggestion.

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

• Prywatność.
  • Wymuszanie zakresu miejsca na dane : aplikacje powinny korzystać z modelu przechowywania danych o zakresie, w którym związane z aplikacjami, pliki multimedialne i inne typy plików są zapisywane i otwierane za pomocą dedykowanych lokalizacji.
  • Automatyczne resetowanie uprawnień: jeśli użytkownicy nie korzystają z aplikacji przez kilka miesięcy, system automatycznie resetuje jej wrażliwe uprawnienia. Nie powinno to mieć wpływu na większość aplikacji. Jeśli Twoja aplikacja działa głównie w tle i nie wymaga 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. Dostęp do lokalizacji w tle można przyznać tylko w ustawieniach aplikacji, a nie w oknach z uprawnieniami w czasie działania.
  • Widoczność pakietów: gdy aplikacja wysyła zapytanie o listę zainstalowanych aplikacji i usług na urządzeniu, zwrócona lista jest filtrowana.
    • Jeśli korzystasz z usług zamiany tekstu na mowę lub rozpoznawania mowy, musisz dodać elementy zapytań dotyczących usług do pliku manifestu.
• Zabezpieczenia
  • Skompresowane pliki `resource.arsc` nie są już obsługiwane
  • Wymagany jest teraz schemat podpisu pliku APK w wersji 2. Ze względu na zgodność wsteczną deweloperzy powinni też nadal podpisywać pliki APK według schematu podpisu plików APK w wersji 1.
  • Ograniczenie dotyczące interfejsu innego niż SDK. W przypadku aplikacji kierowanych na interfejs API na poziomie 30 nie zalecamy korzystania z interfejsów innych niż SDK, ponieważ niektóre z tych interfejsów są teraz zablokowane. Pełną listę zablokowanych interfejsów spoza SDK znajdziesz w artykule o interfejsach innych niż 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.