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

Przesyłany plik APK musi spełniać wymagania Google Play dotyczące docelowego poziomu interfejsu API.

Od 31 sierpnia 2025 r.:

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

Jeśli potrzebujesz więcej czasu na zaktualizowanie aplikacji, możesz poprosić o przedłużenie terminu do 1 listopada 2025 roku. 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 użytkowników korzystających z nowych pakietów SDK?

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

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

W tym dokumencie znajdziesz ważne informacje, które pomogą Ci zaktualizować docelowy poziom interfejsu API, aby spełniać wymagania Google Play. W zależności od tego, do której wersji chcesz przeprowadzić dane, postępuj zgodnie z instrukcjami podanymi w odpowiednich sekcjach.

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

Aby zaktualizować aplikację, aby kierować ją na nowszą wersję Androida, postępuj zgodnie z listą odpowiednich zmian zachowania:

• Zmiany w zachowaniu Androida 13
• Zmiany w zachowaniu 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 LOCATION w czasie wykonywania operacji dotyczących Bluetootha.
• Lokalizacja: użytkownicy mogą poprosić aplikacje o pobieranie tylko przybliżonych informacji o lokalizacji. Za każdym razem, gdy przesyłasz prośbę o uprawnienia ACCESS_FINE_LOCATION, musisz poprosić o uprawnienia ACCESS_COARSE_LOCATION.
  • Filtry intencji: jeśli aplikacja zawiera aktywności, usługi lub odbiorniki transmisji, które korzystają z filtrów intencji, musisz wyraźnie zadeklarować atrybut android:exported dla tych komponentów.
• Hibernacja: aplikacje mogą zostać umieszczone w stanie hibernacji, jeśli nie są używane przez pewien czas. W trybie hibernacji uprawnienia i pamięć podręczna aplikacji są resetowane, a Ty nie możesz wykonywać zadań ani alertów. 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łej powierzchni powiadomienia. Zamiast tego system zastosuje standardowy szablon. Dzięki temu szablonowi niestandardowe powiadomienia mają takie same elementy dekoracyjne jak inne powiadomienia we wszystkich stanach. Sposób działania tej zasady jest niemal identyczny ze sposobem działania zasady Notification.DecoratedCustomViewStyle.
• Zmiany w weryfikacji linków do aplikacji na Androida: jeśli korzystasz z weryfikacji linków do aplikacji na Androida, upewnij się, że filtry intencji obejmują kategorię BROWSABLE i obsługują schemat HTTPS.

Wydajność

• Ograniczenia dotyczące uruchamiania usług na pierwszym planie: jeśli Twoja aplikacja jest 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ę na pierwszym planie, gdy działa w tle, wystąpi wyjątek (z wyjątkiem kilku szczególnych przypadków).

  Rozważ użycie WorkManagera do zaplanowania i rozpoczęcia przyspieszonego działania, gdy aplikacja działa w tle. Aby wykonać działania wymagające szybkiego działania na żądanie użytkownika, uruchom usługi na pierwszym planie w ramach alarmu precyzyjnego.

• Ograniczenia trampoliny powiadomień: gdy użytkownicy klikają powiadomienia, niektóre aplikacje odpowiadają, uruchamiając komponent aplikacji, który uruchamia aktywność, którą użytkownik widzi i z którą wchodzi w interakcję. Ten komponent aplikacji nazywa się trampoliną powiadomień.

  Aplikacje nie mogą uruchamiać działań z usług lub odbiorników transmisji, które są używane jako trampoliny powiadomień. Gdy użytkownik kliknie powiadomienie lub przycisk działania w powiadomieniu, Twoja aplikacja nie może wywołać funkcji startActivity() w ramach usługi lub odbiornika transmisji.

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

Modernizacja aplikacji

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

• Aby w pełni korzystać z aparatu, rozważ użycie aplikacji CameraX, która jest w wersji beta.
• Korzystaj z komponentów Jetpacka, aby stosować się do sprawdzonych metod, unikać pisania szablonowego kodu i uproszczać skomplikowane zadania, dzięki czemu możesz skupić się na kodzie, który jest dla Ciebie ważny.
• Korzystaj z Kotlina, aby szybciej i z mniejszą ilością kodu pisać lepsze aplikacje.
• Przestrzegaj wymagań i sprawdzonych metod dotyczących prywatności.
• Dodaj do aplikacji obsługę ciemnego motywu.
• Dodaj do aplikacji obsługę nawigacji za pomocą gestów.
• Przenieś aplikację z Google Cloud Messaging (GCM) do najnowszej wersji Komunikacji w chmurze Firebase.
• Korzystaj z zaawansowanego zarządzania oknami.
  • Obsługa większych formatów obrazu (większych niż 16:9), aby korzystać z ostatnich osiągnięć w zakresie sprzętu. Upewnij się, że rozmiar aplikacji dostosowuje się do dostępnej przestrzeni na ekranie. Maksymalny współczynnik proporcji należy zadeklarować tylko w sytuacji, gdy nie można użyć innych metod. Więcej informacji o maksymalnych współczynnikach proporcji znajdziesz w artykule Oświadczenie o obsługiwaniu ekranów ograniczonych.
  • Dodaj obsługę wielu okien, aby zwiększyć produktywność aplikacji, a także zarządzać wieloma wyświetlaczami.
  • Jeśli lepszy interfejs aplikacji w trybie zminimalizowanym poprawi wrażenia użytkowników, 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 interfejsów WindowInsets i View.OnApplyWindowInsetsListener. Więcej informacji znajdziesz w tym filmie Droidcon NYC 2017.
    • Nie zakładaj, że aplikacja ma cały ekran. Zamiast tego potwierdź jego lokalizację, używając kolumny View.getLocationInWindow(), a nie View.getLocationOnScreen(). * Do obsługi MotionEvent używaj wartości MotionEvent.getX() i MotionEvent.getY(), a nie MotionEvent.getRawX() ani MotionEvent.getRawY().

Sprawdzanie i aktualizowanie pakietów SDK oraz bibliotek

Upewnij się, że pakiety SDK innych firm, na których Twoja aplikacja jest zależna, obsługują interfejs API 31. Niektórzy dostawcy pakietów SDK publikują go w manifeście, a w przypadku innych konieczne będzie sprawdzenie dodatkowych kwestii. Jeśli używasz pakietu SDK, który nie obsługuje interfejsu API 31, postaraj się jak najszybciej skontaktować z dostawcą pakietu SDK, aby rozwiązać ten problem.

Pamiętaj też, że targetSdkVersion Twojej aplikacji lub gry może ograniczać dostęp do prywatnych bibliotek platformy Android. Więcej informacji znajdziesz w artykule Połączanie aplikacji NDK z bibliotekami platformy.

Sprawdź też, czy w wersji biblioteki Android Support Library, której używasz, występują jakieś ograniczenia. Jak zawsze musisz zadbać o zgodność głównej wersji Biblioteki pomocy Androida z compileSdkVersion Twojej aplikacji.

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

Testowanie aplikacji

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

• Aplikacja kompiluje się do interfejsu API 29 bez błędów ani ostrzeżeń.

• Aplikacja ma strategię na przypadki, gdy użytkownik odrzuca prośby o przyznanie uprawnień, i prosi o te uprawnienia. Aby to zrobić:

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

• Obsługuje Doze z oczekiwanymi wynikami i bez błędów.

  • Użyj adb, aby umieścić urządzenie testowe w trybie Doze, gdy aplikacja jest uruchomiona.
    • Testowanie wszystkich przypadków użycia, które powodują wysyłanie wiadomości w Komunikacji w chmurze Firebase (FCM).
    • Testuj przypadki użycia, które wykorzystują alarmy lub zadania.
    • Usuń wszystkie zależności od usług działających w tle.
  • Przełącz aplikację w tryb wstrzymania.
    • Testowanie wszystkich przypadków użycia, które powodują wysyłanie wiadomości w Komunikacji w chmurze Firebase (FCM).
    • Testowanie wszystkich przypadków użycia, które wykorzystują alarmy.

• obsługuje nowe zdjęcia / filmy,

  • Sprawdź, czy aplikacja obsługuje transmisje ACTION_NEW_PICTURE i ACTION_NEW_VIDEO (czyli przenosi je 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. - Sprawdź wszystkie przypadki użycia, w których dane plików są udostępniane innej aplikacji (nawet innej aplikacji tego samego dewelopera).

  • Sprawdź, czy treści są widoczne w innej aplikacji i czy nie powodują jej awarii.

Dodatkowe informacje

Zasubskrybuj e-maile w Konsoli Google Play, abyśmy mogli wysyłać Ci ważne informacje i ogłoszenia dotyczące Androida i Google Play, w tym miesięczny newsletter dla partnerów.