Migracja aplikacji na Androida 12

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 12.

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 12).
  • kierowanie reklam na nowe funkcje platformy i interfejsy API (jak najszybciej po opublikowaniu ostatecznej wersji).

Zapewnianie zgodności z Androidem 12

Warto przetestować działanie istniejącej aplikacji w porównaniu z Androidem 12, aby zapewnić komfort użytkowników po aktualizacji 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 12

Wgraj na urządzenie obraz systemu Android 12 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 z użyciem tego samego poziomu interfejsu API, na który kierowana była Twoja aplikacja – nie ma potrzeby kierowania aplikacji na Androida 12.

Opublikuj

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

Testy zgodności

Testowanie zgodności z Androidem 12 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ć aplikację, zainstaluj ją na urządzeniu z Androidem 12 i przejdź przez wszystkie procesy i funkcje, szukając problemów. Aby skupić się na testowaniu, zapoznaj się z zmianami w działaniu wszystkich aplikacji wprowadzonych w Androidzie 12, 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 12, 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 12.

Zaktualizuj kierowanie aplikacji i zastosuj nowe interfejsy API

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

Planując pełne wsparcie Androida 12, 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 12.

Pobierz pakiet SDK na Androida 12

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

Sprawdzanie zmian w działaniu

Zapoznaj się ze zmianami w działaniu aplikacji kierowanych na Androida 12. 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 12.

Wdrażanie funkcji Androida 12

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

Sprawdź

Przetestuj na urządzeniu z Androidem 12 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 12 będą gotowe, ponownie zaktualizuj targetSdkVersion i inne konfiguracje kompilacji, wprowadź dodatkowe aktualizacje 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 12, użyj najnowszej wersji testowej Android Studio i pobierz pakiet Android 12 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 12

Gdy skompilujesz aplikację i zainstalujesz ją na urządzeniu z Androidem 12, rozpocznij testy, aby 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 12. 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 12, 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 12 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 fazie programowania obsługi Androida 12 użyj przełączników. Więcej informacji znajdziesz w artykule Zmiany w platformie zgodności (Android 12).