Przenoszenie aplikacji na Androida 14

Ten dokument zawiera ogólny opis typowych faz rozwoju i testowania, które mogą pomóc w przygotowaniu się na wdrożenie zgodnie z harmonogramem i zapewnić użytkownikom wygodę korzystania z Androida 14.

W każdej wersji Androida wprowadzamy nowe funkcje i zmiany zachowania, aby system był bardziej przydatny, bezpieczny i wydajny. 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 ma 2 fazy, które mogą być wykonywane równolegle:

  • Zapewnienie zgodności aplikacji (do ostatniej wersji Androida 14)
  • kierowanie na nowe funkcje i interfejsy API platformy (jak najszybciej po ich ostatecznym wydaniu);

Zapewnienie zgodności z Androidem 14

Aby zapewnić użytkownikom wygodę korzystania z aplikacji po aktualizacji do najnowszej wersji Androida, ważne jest przetestowanie jej funkcjonalności w Androidzie 14. Niektóre zmiany na platformie mogą wpłynąć na działanie aplikacji, dlatego tak ważne jest szybkie i dokładne przetestowanie aplikacji i wprowadzenie w niej wszelkich niezbędnych poprawek.

Zwykle możesz dostosować aplikację i opublikować jej nową wersję bez konieczności zmiany targetSdkVersion. Podobnie nie musisz używać nowych interfejsów API ani zmieniać compileSdkVersion aplikacji, choć może to zależeć od sposobu jej utworzenia i funkcji platformy, z których korzysta.

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 14

Przeflashuj obraz systemu Androida 14 na urządzeniu lub pobierz obraz systemu dla emulatora Androida.

Sprawdzanie zmian

Sprawdź zmiany w zachowaniu systemu, aby określić, w jakich obszarach mogą one wpłynąć na Twoją aplikację.

Sprawdź

Zainstaluj aplikację na urządzeniu lub emulatorze i uruchom testy. Skup się na zmianach zachowania systemu i przetestuj wszystkie przepływy w aplikacji.

Aktualizacja

Wprowadzaj tylko zmiany kodu wymagane do dostosowania się do zmian w zachowaniu lub rozwiązywania problemów. Zrekompiluj aplikację z tym samym poziomem interfejsu API, na który była pierwotnie kierowana – nie musisz kierować jej na Androida 14.

Opublikuj

Podpisz, prześlij i opublikuj zaktualizowany pakiet aplikacji na Androida lub plik APK.

Przeprowadź testy zgodności

W większości przypadków testowanie zgodności z Androidem 14 jest podobne do zwykłego testowania aplikacji. To dobry moment na zapoznanie się z podstawowymi wskazówkami dotyczącymi jakości aplikacji i sprawdzonymi metodami testowania.

Aby przetestować aplikację, zainstaluj ją na urządzeniu z Androidem 14 i sprawdź wszystkie przepływy i funkcje, zwracając uwagę na ewentualne problemy. Aby ułatwić Ci testowanie, zapoznaj się ze zmianami w zachowaniu wszystkich aplikacji wprowadzonymi w Androidzie 14, które mogą wpływać na działanie aplikacji lub powodować jej zamykanie.

Pamiętaj też, aby sprawdzić i przetestować użycie ograniczonych interfejsów innych niż SDK. Należy zastąpić każdy ograniczony interfejs używany przez aplikację publicznym pakietem SDK lub jego odpowiednikiem w NDK. Zwróć uwagę na ostrzeżenia logcat, które wskazują te dostępy, i użyj metody StrictMode detectNonSdkApiUsage(), aby je przechwycić programowo.

Na koniec przetestuj biblioteki i pakiety SDK w aplikacji, aby mieć pewność, że działają one zgodnie z oczekiwaniami w Androidzie 14. Pamiętaj też o przestrzeganiu najlepszych praktyk dotyczących prywatności, wydajności, UX, obsługi danych i uprawnień. Jeśli znajdziesz problem, spróbuj zaktualizować pakiet SDK do najnowszej wersji lub skontaktuj się z jego deweloperem, aby uzyskać pomoc.

Po zakończeniu testów i wprowadzeniu aktualizacji zalecamy jak najszybsze opublikowanie zgodnej aplikacji. Dzięki temu użytkownicy mogą wcześniej przetestować aplikację, a Ty zapewnisz im płynne przejście na Androida 14.

Zaktualizuj kierowanie aplikacji i utwórz wersję z nowymi interfejsami API

Po opublikowaniu zgodnej wersji aplikacji dodaj pełną obsługę Androida 14, aktualizując targetSdkVersion i korzystając z nowych interfejsów API oraz funkcji w Androidzie 14. Możesz wprowadzić te zmiany, gdy tylko będziesz gotowy, pamiętając o wymaganiach Google Play dotyczących kierowania na nową platformę.

Planując działania mające na celu zapewnienie pełnej zgodności z Androidem 14, sprawdź zmiany w zachowaniu, które wpływają na działanie aplikacji kierowanych na tę wersję systemu. Te zmiany w działaniu kierowanym mogą powodować problemy z funkcjonalnością, które trzeba będzie rozwiązać. W niektórych przypadkach zmiany te wymagają znacznego rozwoju, dlatego zalecamy, aby jak najszybciej zapoznać się z tymi zmianami i wdrożyć je. 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 zapewnić pełną obsługę Androida 14.

Pobierz pakiet SDK Androida 14

Aby kompilować w Androidzie 14, zainstaluj najnowszą wersję podglądu Android Studio. Upewnij się, że masz urządzenie z Androidem 14 lub jego emulator.
Zaktualizuj konfigurację targetSdkVersion i inne konfiguracje kompilacji.

Sprawdzanie zmian w zachowaniu

Zapoznaj się ze zmianami zachowania, które dotyczą aplikacji kierowanych na Androida 14. Określ obszary, na które może to mieć wpływ, i zaplanuj, jak pomóc użytkownikom.

Sprawdzanie nowych zmian dotyczących prywatności

Wprowadź zmiany w kodzie i architekturze, aby obsługiwać zmiany dotyczące prywatności użytkowników na Androidzie 14.

Wdrożenie funkcji Androida 14

Korzystaj z interfejsów API Androida 14, aby dodać do swoich aplikacji nowe funkcje i możliwości. Zmien ponownie kompilację na potrzeby Androida 14.

Sprawdź

Przetestuj aplikację na urządzeniu z Androidem 14 lub w 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łaszać problemy z platformą, interfejsem API lub zewnętrznym pakietem SDK;

Ostatnia aktualizacja

Gdy interfejsy API Androida 14 zostaną sfinalizowane, ponownie zaktualizuj targetSdkVersion i inne konfiguracje kompilacji, wprowadź wszelkie dodatkowe aktualizacje i przetestuj aplikację.

Opublikuj

Podpisz, prześlij i opublikuj zaktualizowany pakiet aplikacji na Androida lub plik APK.

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

Aby rozpocząć testowanie pełnej obsługi Androida 14, użyj najnowszej wersji w podglądzie Android Studio, aby pobrać pakiet SDK Androida 14 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 14

Po skompilowaniu aplikacji i zainstalowaniu jej na urządzeniu z Androidem 14 rozpocznij testowanie, aby sprawdzić, czy aplikacja działa prawidłowo, gdy kierujesz ją na Androida 14. Niektóre zmiany zachowania mają zastosowanie tylko wtedy, gdy aplikacja jest kierowana na nową platformę, dlatego przed rozpoczęciem sprawdź te zmiany.

Podobnie jak w przypadku podstawowego testowania zgodności, sprawdź wszystkie przepływy i funkcje pod kątem problemów. Skup się na testowaniu zmian w działaniu aplikacji kierowanych na Androida 14. Warto też sprawdzić aplikację pod kątem zgodności ze podstawowymi wskazówkami dotyczącymi jakości aplikacjisprawdzonymi metodami testowania.

Sprawdź i przetestuj użycie ograniczonych interfejsów spoza pakietu SDK, które może być wymagane. 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 14, 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.

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

Android 14 zawiera przełączniki zgodności, które ułatwiają testowanie aplikacji z celowymi zmianami zachowania. W przypadku aplikacji do debugowania przełączniki umożliwiają:

  • Testuj zmiany docelowe bez faktycznej zmiany wartości targetSdkVersion 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 modyfikować wszystkie zmiany docelowe jednocześnie, możesz wyłączyć wszystkie zmiany docelowe oprócz tych, które chcesz przetestować.
  • Zarządzaj przełącznikami za pomocą adb Aby włączać i wyłączać zmiany w automatycznym środowisku testowym, możesz używać poleceń adb.
  • Szybsze debugowanie dzięki standardowym identyfikatorom zmian. Każda zmiana, którą można włączać i wyłączać, ma niepowtarzalny identyfikator i nazwę, których możesz używać do szybkiego debugowania przyczyny w wyjściu z dziennika.

Przełączniki mogą być przydatne, gdy przygotowujesz się do zmiany kierowania aplikacji lub gdy aktywnie pracujesz nad obsługą Androida 14. Więcej informacji znajdziesz w artykule Zmiany w ramach zgodności (Android 14).