Migracja aplikacji na Androida 13

Ten dokument zawiera ogólny wgląd w typowe fazy programowania i testowania. Dzięki temu łatwiej przygotujesz plan gotowości, który będzie zgodny z harmonogramem wprowadzania wersji na platformę i zapewni użytkownikom wygodę korzystania z Androida 13.

W każdej wersji Androida wprowadzamy nowe funkcje oraz zmiany w działaniu, które mają na celu zwiększenie przydatności, bezpieczeństwa i wydajności Androida. W wielu przypadkach aplikacja od razu działa dokładnie tak, jak powinna. W innych może być jednak konieczna jej aktualizacja, aby dostosować się do zmian na platformie.

Użytkownicy mogą zacząć korzystać z nowej platformy, gdy tylko kod źródłowy zostanie opublikowany w AOSP (Android Open Source Project). Dlatego Twoje aplikacje muszą być gotowe, działać zgodnie z oczekiwaniami oraz najlepiej wykorzystać nowe funkcje i interfejsy API, by w pełni wykorzystać możliwości nowej platformy.

Typowa migracja składa się z 2 faz, które mogą być równoczesne:

  • Zapewnienie zgodności aplikacji (do ostatniej wersji Androida 13).
  • kierowanie reklam na nowe funkcje platformy i interfejsy API (jak najszybciej po opublikowaniu ostatecznej wersji).

Zapewnianie zgodności z Androidem 13

Warto przetestować działanie istniejącej aplikacji w porównaniu z Androidem 13, aby zapewnić wygodę użytkownikom, którzy aktualizują się do najnowszej wersji Androida. Niektóre zmiany na platformie mogą wpłynąć na działanie aplikacji, dlatego tak ważne jest przetestowanie aplikacji wcześnie i dokładne oraz wprowadzenie w niej niezbędnych poprawek.

Zwykle możesz dostosować aplikację i opublikować aktualizację bez konieczności zmiany tego uprawnienia (targetSdkVersion). Nie musisz też używać nowych interfejsów API ani zmieniać compileSdkVersion aplikacji, chociaż może to zależeć od sposobu tworzenia aplikacji i wykorzystywanych przez nią funkcji platformy.

Przed rozpoczęciem testów zapoznaj się ze zmianami w działaniu wszystkich aplikacji. Te zmiany mogą mieć wpływ na Twoją aplikację, nawet jeśli nie zmienisz jej targetSdkVersion.

Pobierz Androida 13

Wgraj na urządzenie obraz systemu Android 13 lub pobierz obraz systemu w emulatorze Androida.

Sprawdź zmiany

Przejrzyj zmiany w działaniu systemu, aby zidentyfikować obszary, w których może to wpłynąć na Twoją aplikację.

Sprawdź

Zainstaluj aplikację na urządzeniu lub w emulatorze i przeprowadź testy. Skup się na zmianach w działaniu systemu i wykonuj czynności we wszystkich procesach w aplikacji.

Zaktualizuj

Wprowadzaj tylko te zmiany w kodzie, które są niezbędne, aby dostosować się do zmian w działaniu lub rozwiązać problemy. Ponownie kompiluj przy użyciu tego samego poziomu interfejsu API, na który kierowana była Twoja aplikacja – nie ma potrzeby kierowania aplikacji na Androida 13.

Opublikuj

Podpisz, prześlij i opublikuj zaktualizowany pakiet Android App Bundle lub plik APK.

Testy zgodności

Testowanie zgodności z Androidem 13 w większości przypadków przypomina testowanie aplikacji. To dobry moment, by zapoznać się z podstawowymi wskazówkami dotyczącymi jakości aplikacji i sprawdzonymi metodami testowania.

Aby przetestować swoją aktualnie opublikowaną aplikację, zainstaluj ją na urządzeniu z Androidem 13 i przeprowadź wszystkie etapy oraz działanie funkcji, szukając błędów. Aby skupić się na testowaniu, zapoznaj się z zmianami w działaniu wszystkich aplikacji wprowadzonych w Androidzie 13, które mogą wpływać na działanie aplikacji lub powodować jej awarię.

Pamiętaj też o przejrzeniu i przetestowaniu pod kątem użycia ograniczonych interfejsów spoza SDK. Każdy interfejs z ograniczeniami, z którego korzysta Twoja aplikacja, należy zastąpić publicznym pakietem SDK lub odpowiednikiem NDK. Zwróć uwagę na ostrzeżenia logcat, które wyróżniają te dostęp, i użyj metody StrictMode detectNonSdkApiUsage(), aby je automatycznie wychwytywać.

Pamiętaj też, aby w pełni przetestować biblioteki i pakiety SDK w swojej aplikacji, aby mieć pewność, że działają one zgodnie z oczekiwaniami na Androidzie 13, oraz postępować zgodnie ze sprawdzonymi metodami dotyczącymi ochrony prywatności, wydajności, UX, obsługi danych i uprawnień. Jeśli napotkasz problem, spróbuj zaktualizować pakiet SDK do najnowszej wersji lub poproś o pomoc jego dewelopera.

Po zakończeniu testów i wprowadzeniu aktualizacji zalecamy jak najszybsze opublikowanie zgodnej aplikacji. Pozwoli to użytkownikom na wczesne przetestowanie aplikacji i płynne przejście na Androida 13.

Zaktualizuj kierowanie aplikacji i zastosuj nowe interfejsy API

Gdy opublikujesz zgodną wersję aplikacji, następnym krokiem będzie zapewnienie pełnej obsługi Androida 13 przez aktualizację targetSdkVersion oraz wykorzystanie nowych interfejsów API i możliwości Androida 13. Możesz wprowadzić te zmiany od razu, pamiętając o wymaganiach Google Play dotyczących kierowania na nową platformę.

Planując pełną obsługę Androida 13, zapoznaj się ze zmianami w działaniu, które wpływają na aplikacje kierowane na ten system. Te odpowiednie zmiany działania mogą powodować problemy funkcjonalne, którymi musisz się zająć. W niektórych przypadkach takie zmiany wymagają znacznego rozwoju, dlatego zalecamy jak najszybsze zapoznanie się z tymi zmianami i rozwiązanie ich problemu. Aby ułatwić sobie wykrywanie konkretnych zmian w działaniu, które wpływają na Twoją aplikację, użyj przełączników zgodności, aby przetestować aplikację z włączonymi wybranymi zmianami.

Poniższe kroki opisują, jak w pełni zapewnić obsługę Androida 13.

Pobierz pakiet SDK na Androida 13

Aby kompilować w Androidzie 13, zainstaluj najnowszą wersję podglądu Android Studio. Sprawdź, czy masz urządzenie z Androidem 13 lub emulator.
Zaktualizuj targetSdkVersion i inne konfiguracje kompilacji.

Sprawdzanie zmian w działaniu

Zapoznaj się ze zmianami w działaniu aplikacji kierowanych na Androida 13. Określ obszary, na których może to wpłynąć na Twoją aplikację, i zaplanuj, jak je wspierać.

Zapoznaj się z nowymi zmianami dotyczącymi prywatności

Wprowadź zmiany w kodzie i architekturze niezbędne do obsługi zmian w zasadach prywatności użytkowników na Androidzie 13.

Wdrażanie funkcji Androida 13

Wykorzystaj interfejsy API Androida 13, aby wprowadzać nowe funkcje i możliwości do swoich aplikacji. Ponowna kompilacja na Androida 13.

Sprawdź

Przetestuj na urządzeniu z Androidem 13 lub emulatorze. Skup się na obszarach, w których zmiany w działaniu mogą mieć wpływ na Twoją aplikację. Wypróbuj funkcje korzystające z nowych interfejsów API. Prześlij opinię na temat platformy i interfejsu API. Zgłaszaj wszelkie problemy z platformą, interfejsem API lub pakietem SDK innej firmy.

Ostatnia aktualizacja

Gdy interfejsy API Androida 13 będą gotowe, ponownie zaktualizuj targetSdkVersion i inne konfiguracje kompilacji, wprowadź dodatkowe zmiany i przetestuj aplikację.

Opublikuj

Podpisz, prześlij i opublikuj zaktualizowany pakiet Android App Bundle lub plik APK.

Pobieranie pakietu SDK, zmiana kierowania i tworzenie nowych interfejsów API

Aby rozpocząć testy pełnej obsługi Androida 13, użyj najnowszej wersji testowej Android Studio i pobierz pakiet Android 13 SDK i inne potrzebne narzędzia. Następnie zaktualizuj targetSdkVersion i compileSdkVersion aplikacji, a potem ponownie skompiluj aplikację. Więcej informacji znajdziesz w przewodniku po konfiguracji pakietu SDK.

Testowanie aplikacji na Androida 13

Gdy skompilujesz aplikację i zainstalujesz ją na urządzeniu z Androidem 13, rozpocznij testy, by sprawdzić, czy aplikacja działa prawidłowo, gdy jest kierowana na ten system. Niektóre zmiany w działaniu mają zastosowanie tylko wtedy, gdy aplikacja jest kierowana na nową platformę, dlatego warto przejrzeć te zmiany, zanim zaczniesz.

Tak jak w przypadku podstawowego testowania zgodności, przejdź przez wszystkie przepływy i funkcje, szukając błędów. Skup się na testowaniu zmian w działaniu aplikacji kierowanych na Androida 13. To dobry moment na sprawdzenie, czy aplikacja jest zgodna z podstawowymi wskazówkami dotyczącymi jakości i sprawdzonymi metodami testowania.

Przejrzyj i przetestuj pod kątem ograniczonych interfejsów spoza SDK, które mogą mieć zastosowanie. Zwróć uwagę na ostrzeżenia logcat, które wyróżniają te przypadki dostępu, i użyj metody StrictMode detectNonSdkApiUsage() do ich automatycznego wychwytywania.

Pamiętaj też, aby w pełni przetestować biblioteki i pakiety SDK w swojej aplikacji, aby mieć pewność, że działają one zgodnie z oczekiwaniami na Androidzie 13, oraz postępować zgodnie ze sprawdzonymi metodami dotyczącymi ochrony prywatności, wydajności, UX, obsługi danych i uprawnień. Jeśli napotkasz problem, spróbuj zaktualizować pakiet SDK do najnowszej wersji lub poproś o pomoc jego dewelopera.

Testowanie za pomocą przełączników zgodności aplikacji

Android 13 ma przełączniki zgodności, które ułatwiają testowanie aplikacji dzięki ukierunkowanym zmianom działania. W przypadku aplikacji z możliwością debugowania możesz użyć przełączników:

  • Przetestuj docelowe zmiany bez zmiany wartości targetSdkVersion w aplikacji. Za pomocą przełączników możesz wymusić włączenie określonych docelowych zmian działania i ocenić ich wpływ na istniejącą aplikację.
  • Skup się na testowaniu tylko konkretnych zmian. Zamiast wprowadzać wszystkie docelowe zmiany jednocześnie, przełączniki pozwalają wyłączyć wszystkie docelowe zmiany z wyjątkiem tych, które chcesz przetestować.
  • Zarządzanie przełącznikami w narzędziu adb Za pomocą poleceń adb możesz włączać i wyłączać przełączane zmiany w automatycznym środowisku testowym.
  • Szybsze debugowanie przy użyciu standardowych identyfikatorów zmian Każda z możliwością przełączania zmian ma unikalny identyfikator i nazwę, których możesz użyć do szybkiego debugowania głównej przyczyny w danych wyjściowych logu.

Podczas przygotowań do zmiany kierowania aplikacji lub w trakcie opracowywania obsługi Androida 13 użyj przełączników. Więcej informacji znajdziesz w artykule Zmiany w platformie zgodności (Android 13).