Wear OS 5.1

Wear OS 5.1 jest dostępny na wybranych urządzeniach i w oficjalnym emulatorze w Android Studio. Po zaktualizowaniu docelowej wersji pakietu SDK sprawdź, czy aplikacja działa zgodnie z oczekiwaniami.

Wear OS 5.1 jest oparty na Androidzie 15 (poziom API 35), co wymaga przetestowania aplikacji, które są już kierowane na poziom API 34 dla Wear OS 5.

Przygotowanie obsługiwanego urządzenia do testowania

Wear OS 5.1 może działać na tych urządzeniach:

• Google Pixel Watch 3
• Google Pixel Watch 2
• Google Pixel Watch

Na urządzeniu powinna zostać zainstalowana aktualizacja oprogramowania OTA. Możesz też ręcznie zaktualizować urządzenie, wykonując jedną z tych czynności:

• W aplikacji Ustawienia kliknij kolejno System > Aktualizacje systemu.
• Po włączeniu Opcji programisty zainstaluj na urządzeniach, które obsługują przewodowe połączenie USB do transmisji danych, konkretny obraz oprogramowania. Możesz na przykład zainstalować obraz fabryczny lub pełny obraz OTA.

Przygotowanie 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 używać tego obrazu systemu.

Pobieranie i instalowanie obrazu systemu

Aby pobrać i zainstalować prawidłowy obraz systemu, wykonaj te czynności:

1. Jeśli nie masz jeszcze najnowszej wersji Android Studio Ladybug Feature Drop lub nowszej, pobierz ją i zainstaluj.
2. W Android Studio kliknij kolejno Narzędzia > Menedżer SDK.

3. Na karcie Platformy 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:

   

4. Kliknij OK. Gdy pojawi się okno Potwierdź zmianę, ponownie kliknij OK.

5. Poczekaj, aż Android Studio pobierze i zainstaluje obraz systemu, a następnie kliknij Zakończ.

Tworzenie urządzenia wirtualnego

Aby utworzyć urządzenie wirtualne, które będzie używać tego obrazu systemu w oficjalnym emulatorze, wykonaj te czynności:

1. W Android Studio otwórz Menedżera urządzeń, klikając kolejno Narzędzia > Menedżer urządzeń. Pojawi się panel Menedżer urządzeń.
2. Na pasku narzędzi w panelu Menedżer urządzeń kliknij Dodaj nowe urządzenie > Utwórz urządzenie wirtualne.
3. W panelu Format wybierz Wear OS i profil sprzętowy. Kliknij Dalej.
4. Wybierz obraz systemu Wear OS 5.1. Obraz systemu powinien mieć poziom API równy 35.
5. Kliknij Dalej, a potem kliknij Zakończ.

Testowanie aplikacji w emulatorze

Aby przetestować aplikację na utworzonym urządzeniu wirtualnym, wykonaj te czynności:

1. Na pasku narzędzi Android Studio wybierz urządzenie wirtualne.
2. Kliknij Uruchom .
3. Zainstaluj aplikację na urządzeniu wirtualnym i przetestuj różne przepływy pracy, z których korzystają użytkownicy.

Zmiany, które mają wpływ na wszystkie aplikacje

Podczas testowania aplikacji w Wear OS 5.1 sprawdź, jak aplikacja radzi sobie ze zmianami w działaniu systemu , które mają wpływ na wszystkie aplikacje w Androidzie 15, który używa tego samego poziomu API co Wear OS 5.1.

W Wear OS 5.1 nie obowiązuje kilka zmian w działaniu systemu:

• Przestrzenie prywatne nie są obsługiwane w Wear OS 5.1.
• Animacje przewidywanego przejścia wstecz mogą się nie pojawiać.

Aktualizowanie docelowej wersji pakietu SDK aplikacji

Możesz zwiększyć zgodność aplikacji z Wear OS 5.1, aktualizując docelową wersję pakietu SDK aplikacji do poziomu API 35. (Jest to ten sam poziom 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 7.0.0 lub nowsza

Jeśli używasz AGP w wersji 7.0.0 lub nowszej, zaktualizuj plik build.gradle lub build.gradle.kts aplikacji o te wartości dla Wear OS 5.1:

Dynamiczny

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Kotlin

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 lub starsza

Jeśli używasz AGP w wersji 4.2.0 lub starszej, zaktualizuj plik aplikacji build.gradle lub build.gradle.kts o te wartości dla Wear OS 5.1:

Dynamiczny

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 API 35

Po zaktualizowaniu docelowej wersji pakietu SDK do poziomu API 35 wprowadź zmiany w aplikacjach kierowanych na Androida 15, który używa tego samego poziomu API co Wear OS 5.1.

Poznaj nowe funkcje

Wear OS 5.1 wprowadza kilka funkcji, które pomagają zwiększyć komfort korzystania z aplikacji na Wear OS.

Uwaga: zanim dodasz te funkcje do aplikacji, przygotuj ją na zmiany w działaniu, które wprowadza Wear OS 5.1.

Warto zapoznać się z tymi funkcjami:

• Obsługa Credential Manager: interfejs Credential Manager API zapewnia ujednolicone rozwiązanie do uwierzytelniania, które obsługuje przepływy logowania za pomocą haseł, kluczy dostępu i tożsamości sfederowanej (np. Zaloguj się przez Google). Dane logowania użytkownika są przechowywane u dostawcy danych logowania, który synchronizuje informacje o koncie na różnych urządzeniach.
• Odtwarzanie dźwięku 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 urządzenie wyjściowe, jeśli Twoja aplikacja jest zintegrowana z przełącznikiem wyjścia 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 wydania	18 marca 2025 r. w przypadku Google Pixel Watch 3 LTE, Google Pixel Watch 2 LTE i Google Pixel Watch (Bluetooth/Wi-Fi i LTE) 4 marca 2025 r. w przypadku Google Pixel Watch 3 Bluetooth/Wi-Fi i Google Pixel Watch 2 Bluetooth/Wi-Fi
Kompilacja	BP1A.250305.019.W3 na Google Pixel Watch 3 i Google Pixel Watch 2 BP1A.250305.019.W2 na Google Pixel Watch AP4A.241205.004.F4 w emulatorze
Obsługa emulatora	x86 (64-bitowy), ARM (v8-A)

Znane problemy

Obraz systemu, który zawiera Wear OS 5.1, ma te znane problemy:

• Emulator nie zawsze pozwala użytkownikowi dodać konto podczas konfiguracji po zresetowaniu urządzenia.
• Gdy użytkownik kliknie powiadomienie, aplikacja, która je wysłała, otworzy się dopiero po przewinięciu ekranu.
• Usługi Wear Health Services czasami nie mogą rozpocząć ćwiczenia.
• Jeśli w aplikacji kierowanej na poziom API 35 uzyskasz dostęp do bibliotek androidx.wear.tiles lub androidx.wear:wear-phone-interactions, może wystąpić wyjątek SecurityException. Aby rozwiązać ten problem, zaktualizuj bibliotekę androidx.wear.tiles do wersji 1.5.0-alpha05 lub nowszej albo bibliotekę androidx.wear:wear-phone-interactions do wersji 1.1.0 lub nowszej.