Poznaj najnowszą wersję Wear OS, która jest dostępna na wybranych urządzeniach i w oficjalnym emulatorze w Android Studio. Sprawdź, czy aplikacja działa zgodnie z oczekiwaniami po zaktualizowaniu docelowej wersji pakietu SDK.
Wear OS 5.1 jest oparty na Androidzie 15 (API na poziomie 35), co wymaga przetestowania aplikacji, które są już kierowane na API na poziomie 34 w przypadku Wear OS 5.
Przygotowywanie obsługiwanego urządzenia do testowania
Wear OS 5.1 można zainstalować na tych urządzeniach:
- Google Pixel Watch 3
- Google Pixel Watch 2
- Google Pixel Watch
Urządzenie powinno otrzymać aktualizację oprogramowania bezprzewodowo (OTA). Możesz też ręcznie zaktualizować urządzenie, wykonując jedną z tych czynności:
- W aplikacji Ustawienia wybierz System > Aktualizacje systemu.
- Po włączeniu opcji programisty wgraj określony obraz oprogramowania na urządzenia obsługujące przewodowe połączenie USB. Możesz na przykład wgrać obraz fabryczny lub pełny obraz OTA.
Przygotowywanie emulatora do testowania
Aby uruchomić Wear OS 5.1 w oficjalnym emulatorze, musisz najpierw pobrać i zainstalować obraz systemu, który działa w emulatorze. Następnie musisz utworzyć urządzenie wirtualne, które będzie uruchamiać ten obraz systemu.
Pobieranie i instalowanie obrazu systemu
Aby pobrać i zainstalować prawidłowy obraz systemu, wykonaj te czynności:
- Pobierz i zainstaluj najnowszą wersję pakietu nowych funkcji Android Studio Ladybug lub nowszą, jeśli nie masz jej jeszcze na urządzeniu.
- W Android Studio otwórz Tools > SDK Manager (Narzędzia > Menedżer SDK).
Na karcie Platformy pakietu SDK kliknij Pokaż szczegóły pakietu i rozwiń sekcję Android 15.0 („VanillaIceCream”), która zawiera artefakty dla poziomu API 35-ext15. Następnie wybierz Wear OS 5.1 ARM 64 v8a System Image lub Wear OS 5.1 Intel x86_64 Atom System Image:
Kliknij OK. Gdy pojawi się okno Potwierdź zmianę, ponownie kliknij OK.
Poczekaj, aż Android Studio pobierze i zainstaluje obraz systemu, a potem kliknij Zakończ.
Tworzenie urządzenia wirtualnego
Aby utworzyć urządzenie wirtualne, które będzie uruchamiać ten obraz systemu w oficjalnym emulatorze, wykonaj te czynności:
- W Android Studio otwórz Menedżera urządzeń, klikając Narzędzia > Menedżer urządzeń. Pojawi się panel Menedżer urządzeń.
- Na pasku narzędzi w panelu Menedżer urządzeń kliknij Dodaj nowe urządzenie
> Utwórz urządzenie wirtualne.
- W panelu Format wybierz Wear OS i profil sprzętowy. Kliknij Dalej.
- Wybierz obraz systemu Wear OS 5.1, którego chcesz użyć. Obraz systemu powinien mieć poziom API 35.
- Kliknij Dalej, a potem Zakończ.
Testowanie aplikacji w emulatorze
Aby przetestować aplikację na utworzonym urządzeniu wirtualnym, wykonaj te czynności:
- Na pasku narzędzi Android Studio wybierz urządzenie wirtualne.
- Kliknij Bieg
.
- Zainstaluj aplikację na urządzeniu wirtualnym i przejdź przez różne przepływy pracy widoczne dla użytkownika, z których korzysta aplikacja.
Zmiany, które mają wpływ na wszystkie aplikacje
Podczas testowania aplikacji na Wear OS 5.1 sprawdź, jak radzi sobie ona ze zmianami w działaniu systemu, które wpływają na wszystkie aplikacje na Androida 15, który korzysta z tego samego poziomu interfejsu API co Wear OS 5.1.
Niektóre zmiany w zachowaniu nie są wprowadzane w Wear OS 5.1:
- Przestrzenie prywatne nie są obsługiwane w Wear OS 5.1.
- Animacje przewidywanego przejścia wstecz mogą się nie wyświetlać.
Aktualizowanie docelowej wersji pakietu SDK aplikacji
Aby zwiększyć zgodność aplikacji z Wear OS 5.1, zaktualizuj docelową wersję pakietu SDK aplikacji do poziomu interfejsu API 35. (Jest to ten sam poziom interfejsu API, którego używa Android 15).
Aby to zrobić, otwórz plik build.gradle
lub build.gradle.kts
na poziomie modułu i zaktualizuj go o wartości dla Wear OS 5.1.
Sposób formatowania wartości w pliku kompilacji zależy od używanej wersji wtyczki Androida do obsługi Gradle (AGP).
AGP w wersji 7.0.0 lub nowszej
Jeśli używasz AGP w wersji 7.0.0 lub nowszej, zaktualizuj plik build.gradle
lub build.gradle.kts
aplikacji, podając te wartości dla Wear OS 5.1:
Groovy
android { compileSdk 35 ... defaultConfig { targetSdk 35 } }
Kotlin
android { compileSdk = 35 ... defaultConfig { targetSdk = 35 } }
AGP 4.2.0 lub starsze
Jeśli używasz AGP w wersji 4.2.0 lub starszej, zaktualizuj plik build.gradle
lub build.gradle.kts
aplikacji, podając te wartości dla Wear OS 5.1:
Groovy
android { compileSdkVersion "35" ... defaultConfig { targetSdkVersion "35" } }
Kotlin
android { compileSdkVersion = "35" ... defaultConfig { targetSdkVersion = "35" } }
Zmiany, które mają wpływ tylko na aplikacje kierowane na poziom interfejsu API 35
Po zaktualizowaniu docelowej wersji pakietu SDK do poziomu API 35 obsłuż zmiany w przypadku aplikacji kierowanych na Androida 15, który korzysta z tego samego poziomu API co Wear OS 5.1.
Poznaj nowe funkcje
Wear OS 5.1 wprowadza kilka funkcji, które poprawiają komfort korzystania z aplikacji na Wear OS.
Warto zwrócić uwagę na te funkcje:
- Obsługa menedżera danych logowania: interfejs Credential Manager API udostępnia ujednolicone rozwiązanie do uwierzytelniania, które obsługuje przepływy logowania przy użyciu haseł, kluczy dostępu i tożsamości sfederowanej (np. Logowanie przez Google). Dane logowania użytkownika są przechowywane u dostawcy danych logowania, który synchronizuje informacje o koncie na różnych urządzeniach.
- Odtwarzanie na głośniku zegarka: na urządzeniach, które obsługują odtwarzanie multimediów przez głośnik zegarka, użytkownicy mogą wybrać ten głośnik jako preferowane wyjście multimediów, jeśli Twoja aplikacja jest zintegrowana z przełącznikiem wyjścia na Wear.
Informacje o wersji
Najnowszy obraz systemu Wear OS 5.1, który jest dostępny na obsługiwanych urządzeniach i w emulatorze, ma te cechy:
Data premiery | 18 marca 2025 r. w przypadku zegarków Google Pixel Watch 3 LTE, Google Pixel Watch 2 LTE i Google Pixel Watch (wersje Bluetooth/Wi-Fi i LTE) 4 marca 2025 r. w przypadku zegarków Google Pixel Watch 3 Bluetooth/Wi-Fi i Google Pixel Watch 2 Bluetooth/Wi-Fi |
Tworzenie |
BP1A.250305.019.W3 na zegarkach Google Pixel Watch 3 i Google Pixel Watch 2 BP1A.250305.019.W2 na zegarku Google Pixel Watch AP4A.241205.004.F4 na emulatorze |
Obsługa emulatorów | x86 (64-bitowy), ARM (v8-A) |
Znane problemy
Obraz systemu zawierający Wear OS 5.1 ma te znane problemy:
- Emulator nie zawsze pozwala użytkownikowi dodać konto podczas procesu konfiguracji po przywróceniu ustawień urządzenia.
- Gdy użytkownik kliknie powiadomienie, aplikacja, która je wysłała, nie otworzy się, dopóki nie przewinie ekranu.
- Usługi Wear Health Services czasami nie mogą rozpocząć ćwiczenia.
- Jeśli uzyskasz dostęp do bibliotek
androidx.wear.tiles
lubandroidx.wear:wear-phone-interactions
w aplikacji, która jest przeznaczona na poziom interfejsu API 35, może wystąpićSecurityException
. Aby rozwiązać ten problem, zaktualizuj pakiet do wersjiandroidx.wear.tiles
1.5.0-alpha05 lub nowszej alboandroidx.wear:wear-phone-interactions
1.1.0 lub nowszej.