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

Gdy przesyłasz pakiet APK, musi on spełniać wymagania Google Play dotyczące docelowego poziomu interfejsu API.

Od 31 sierpnia 2026 r.:

• Nowe aplikacje i aktualizacje aplikacji przesyłane do Google Play muszą być kierowane na Androida 16 (API na poziomie 36) lub nowszego. Nie dotyczy to aplikacji na Wear OS i system operacyjny Android Automotive, które muszą być kierowane na Androida 15 (API na poziomie 35) lub nowszego, oraz aplikacji na Androida TV i Androida XR, które muszą być kierowane na Androida 14 (API na poziomie 34) lub nowszego.
• Istniejące aplikacje muszą być kierowane na Androida 15 (API na poziomie 35) lub nowszego, aby pozostały dostępne dla nowych użytkowników na urządzeniach z systemem operacyjnym Android nowszym niż docelowy poziom API aplikacji. Aplikacje, które są kierowane na Androida 14 (API na poziomie 34) lub starszego, w tym Androida 13 (API na poziomie 33) lub starszego w przypadku Wear OS, Androida TV i Androida XR oraz Androida 12 (API na poziomie 31) lub starszego w przypadku systemu operacyjnego Android Automotive, będą dostępne tylko na urządzeniach z systemem operacyjnym Android z interfejsem API na docelowym poziomie takim samym jak dla danej aplikacji lub niższym.

Jeśli potrzebujesz więcej czasu na zaktualizowanie aplikacji, możesz poprosić o przedłużenie terminu do 1 listopada 2026 r. Formularze przedłużenia dla Twojej aplikacji będą dostępne w Konsoli Play jeszcze w tym roku.

Przykładowe wyjątki od tych wymagań:

• Aplikacje zawsze prywatne, które są dostępne tylko dla użytkowników w konkretnej organizacji i przeznaczone wyłącznie do dystrybucji wewnętrznej.

Dlaczego warto kierować reklamy na nowsze pakiety SDK?

Każda nowa wersja Androida wprowadza zmiany, które poprawiają bezpieczeństwo i wydajność, a także zwiększają ogólną wygodę korzystania z tego systemu. Niektóre z tych zmian dotyczą tylko aplikacji, które wyraźnie deklarują obsługę za pomocą atrybutu manifestu targetSdkVersion (nazywanego również docelowym poziomem interfejsu API).

Kierowanie aplikacji na aktualny poziom interfejsu API zapewnia użytkownikom korzyści wynikające z ulepszeń, ale jednocześnie pozwala uruchamiać ją na starszych wersjach Androida. Kierowanie na aktualny poziom interfejsu API pozwala też aplikacji korzystać z najnowszych funkcji platformy, co zwiększa zadowolenie użytkowników. Ponadto od Androida 10 (API na poziomie 29) użytkownicy widzą ostrzeżenie, gdy po raz pierwszy uruchamiają aplikację kierowaną na Androida 5.1 (API na poziomie 22) lub starszego.

W tym dokumencie znajdziesz ważne informacje o aktualizowaniu docelowego poziomu interfejsu API, aby spełnić wymagania Google Play. Instrukcje znajdziesz w sekcjach poniżej, w zależności od wersji, na którą przechodzisz.

Przejście z Androida 12 lub nowszego (poziom API 31) na nowszą wersję

Aby zaktualizować aplikację i kierować ją na nowszą wersję Androida, postępuj zgodnie z odpowiednią listą zmian w działaniu:

• Zmiany w działaniu Androida 13
• Zmiany w działaniu Androida 14
• Zmiany w zachowaniu Androida 15
• Zmiany w zachowaniu Androida 16

Przejście z Androida 11 (poziom API 30) na Androida 12 (poziom API 31)

Bezpieczeństwo i uprawnienia

• Bluetooth: musisz zastąpić deklaracje uprawnień BLUETOOTH i BLUETOOTH_ADMIN uprawnieniami BLUETOOTH_SCAN, BLUETOOTH_ADVERTISE lub BLUETOOTH_CONNECT. Nie musisz już wysyłać próśb o uprawnienia w czasie działania aplikacji LOCATION w przypadku operacji Bluetooth.
• Lokalizacja: użytkownicy mogą prosić aplikacje o pobieranie tylko informacji o przybliżonej lokalizacji. Za każdym razem, gdy prosisz o uprawnienie ACCESS_FINE_LOCATION, musisz też poprosić o uprawnienie ACCESS_COARSE_LOCATION.
  • Filtry intencji: jeśli aplikacja zawiera aktywności, usługi lub odbiorniki, które używają filtrów intencji, musisz wyraźnie zadeklarować atrybut android:exported dla tych komponentów.
• Hibernacja: aplikacje mogą zostać wprowadzone w tryb hibernacji, jeśli nie są używane przez pewien czas. W trybie hibernacji uprawnienia w czasie działania aplikacji i pamięć podręczna są resetowane, a zadania i alerty nie mogą być uruchamiane. Możesz sprawdzić stan hibernacji aplikacji.
• Zmienność intencji oczekującej: musisz określić zmienność każdego obiektu PendingIntent tworzonego przez aplikację.

Interfejs użytkownika

• Powiadomienia niestandardowe: powiadomienia z niestandardowymi widokami treści nie będą już używać całego obszaru powiadomień. Zamiast tego system zastosuje szablon standardowy. Ten szablon zapewnia, że powiadomienia niestandardowe mają takie same elementy jak inne powiadomienia we wszystkich stanach. To działanie jest niemal identyczne z działaniem Notification.DecoratedCustomViewStyle.
• Zmiany w weryfikacji linków aplikacji na Androida: jeśli używasz weryfikacji linków aplikacji na Androida, upewnij się, że filtry intencji zawierają kategorię BROWSABLE i obsługują schemat HTTPS.

Wydajność

• Ograniczenia dotyczące uruchamiania usług na pierwszym planie: aby aplikacja mogła być kierowana na Androida 12 lub nowszego, nie może uruchamiać usług na pierwszym planie, gdy działa w tle, z wyjątkiem kilku szczególnych przypadków. Jeśli aplikacja próbuje uruchomić usługę działającą na pierwszym planie, gdy działa w tle, występuje wyjątek (z wyjątkiem kilku szczególnych przypadków).

  Rozważ użycie WorkManagera do planowania i rozpoczynania prac priorytetowych, gdy aplikacja działa w tle. Aby wykonywać działania wymagające szybkiej reakcji, o które prosi użytkownik, uruchamiaj usługi działające na pierwszym planie w ramach alarmu precyzyjnego.

• Ograniczenia dotyczące trampolin powiadomień: gdy użytkownicy klikają powiadomienia, niektóre aplikacje reagują, uruchamiając komponent aplikacji, który rozpoczyna aktywność widoczną dla użytkownika i umożliwiającą mu interakcję. Ten komponent aplikacji jest nazywany trampoliną powiadomień.

  Aplikacje nie mogą uruchamiać aktywności z usług ani odbiorników komunikatów, które są używane jako trampoliny powiadomień. Gdy użytkownik kliknie powiadomienie lub przycisk polecenia w powiadomieniu, aplikacja nie może wywołać metody startActivity() w usłudze ani odbiorniku.

Wyświetl pełny zestaw zmian, które wpływają na aplikacje kierowane na Androida 12 (poziom API 31).

Modernizowanie aplikacji

Podczas aktualizowania docelowego poziomu interfejsu API w aplikacjach rozważ wdrożenie najnowszych funkcji platformy, aby unowocześnić aplikacje i zadowolić użytkowników.

• Aby w pełni wykorzystać możliwości aparatu, rozważ użycie CameraX w wersji beta.
• Używaj komponentów Jetpack, aby stosować sprawdzone metody, uniknąć pisania powtarzalnego kodu i uprościć złożone zadania, dzięki czemu możesz skupić się na kodzie, który Cię interesuje.
• Używaj Kotlina, aby szybciej pisać lepsze aplikacje i używać mniej kodu.
• Upewnij się, że przestrzegasz wymagań i sprawdzonych metod dotyczących prywatności.
• Dodaj obsługę ciemnego motywu w swoich aplikacjach.
• Dodaj do aplikacji obsługę nawigacji przy użyciu gestów.
• Przenieś aplikację z Google Cloud Messaging (GCM) do najnowszej wersji Komunikacji w chmurze Firebase.
• korzystać z zaawansowanego zarządzania oknami;
  • Obsługuj większe formaty obrazu (powyżej 16:9), aby wykorzystać najnowsze osiągnięcia technologiczne. Upewnij się, że aplikacja zmienia rozmiar, aby wypełnić dostępną przestrzeń na ekranie. Maksymalny format obrazu deklaruj tylko w ostateczności. Więcej informacji o maksymalnych formatach obrazu znajdziesz w artykule Deklarowanie ograniczonej obsługi ekranu.
  • Dodaj obsługę wielu okien, aby zwiększyć produktywność aplikacji i zarządzać wieloma wyświetlaczami.
  • Jeśli świetne zminimalizowane wrażenia użytkownika aplikacji poprawią wrażenia użytkownika, dodaj obsługę obrazu w obrazie.
    • Optymalizacja pod kątem urządzeń z wycięciem w ekranie.
    • Nie zakładaj, że wysokość paska stanu jest stała. Zamiast tego użyj WindowInsets i View.OnApplyWindowInsetsListener. Więcej informacji znajdziesz w filmie z droidcon NYC 2017.
    • Nie zakładaj, że aplikacja zajmuje całe okno. Zamiast tego potwierdź jego lokalizację za pomocą View.getLocationInWindow(), a nie View.getLocationOnScreen(). * Podczas obsługi MotionEvent używaj MotionEvent.getX() i MotionEvent.getY(), a nie MotionEvent.getRawX(), MotionEvent.getRawY().

Sprawdzanie i aktualizowanie pakietów SDK oraz bibliotek

Upewnij się, że zależności pakietów SDK innych firm obsługują interfejs API 31: niektórzy dostawcy pakietów SDK publikują te informacje w pliku manifestu, a w przypadku innych wymagane będzie dodatkowe sprawdzenie. Jeśli używasz pakietu SDK, który nie obsługuje interfejsu API 31, priorytetowo potraktuj współpracę z dostawcą pakietu SDK, aby rozwiązać ten problem.

Pamiętaj też, że targetSdkVersion aplikacji lub gry może ograniczać dostęp do prywatnych bibliotek platformy Androida. Szczegółowe informacje znajdziesz w artykule Aplikacje NDK łączące się z bibliotekami platformy.

Sprawdź też, czy w używanej przez Ciebie wersji Biblioteki pomocy Androida nie ma żadnych ograniczeń. Jak zawsze musisz zapewnić zgodność między wersją główną Biblioteki pomocy Androida a compileSdkVersion aplikacji.

Zalecamy wybranie wersji targetSdkVersion mniejszej lub równej wersji głównej biblioteki pomocy. Zachęcamy do zaktualizowania biblioteki do najnowszej zgodnej wersji, aby korzystać z najnowszych funkcji zgodności i poprawek błędów.

Testowanie aplikacji

Po zaktualizowaniu poziomu interfejsu API i funkcji aplikacji przetestuj kilka podstawowych przypadków użycia. Poniższe sugestie nie są wyczerpujące, ale mają na celu ułatwienie procesu testowania. Zalecamy przetestowanie:

• aplikacja kompiluje się do interfejsu API na poziomie 29 bez błędów i ostrzeżeń;

• Czy aplikacja ma strategię na wypadek, gdy użytkownik odrzuci prośbę o uprawnienia, i czy prosi użytkownika o uprawnienia. Aby to zrobić:

  • Otwórz ekran Informacje o aplikacji i wyłącz wszystkie uprawnienia.
  • Otwórz aplikację i upewnij się, że nie ulega awarii.
    • Przeprowadź testy podstawowych przypadków użycia i upewnij się, że wymagane uprawnienia są ponownie wyświetlane.

• Obsługuje tryb uśpienia z oczekiwanymi wynikami i bez błędów.

  • Za pomocą adb przełącz urządzenie testowe w tryb uśpienia, gdy aplikacja jest uruchomiona.
    • Przetestuj wszystkie przypadki użycia, które aktywują wiadomości Komunikacji w chmurze Firebase (FCM).
    • Przetestuj wszystkie przypadki użycia, które korzystają z alarmów lub zadań.
    • wyeliminować wszelkie zależności od usług w tle;
  • Przełączanie aplikacji w tryb czuwania
    • Przetestuj wszystkie przypadki użycia, które aktywują wiadomości Komunikacji w chmurze Firebase (FCM).
    • Przetestuj wszystkie przypadki użycia, które korzystają z alarmów.

• Obsługuje robienie nowych zdjęć i nagrywanie filmów

  • Sprawdź, czy aplikacja prawidłowo obsługuje ograniczone ACTION_NEW_PICTURE i ACTION_NEW_VIDEO komunikaty (czyli przeniesione do zadań JobScheduler).
  • Upewnij się, że wszystkie krytyczne przypadki użycia, które zależą od tych zdarzeń, nadal działają.

• Obsługuje udostępnianie plików innym aplikacjom - Przetestuj dowolny przypadek użycia, który udostępnia dane pliku innej aplikacji (nawet innej aplikacji tego samego dewelopera).

  • Sprawdź, czy treść jest widoczna w drugiej aplikacji i nie powoduje awarii.

Dodatkowe informacje

Wyraź zgodę na otrzymywanie e-maili w Konsoli Google Play, abyśmy mogli wysyłać Ci ważne aktualizacje i ogłoszenia dotyczące Androida i Google Play, w tym nasz miesięczny newsletter dla partnerów.