Wear OS 5.1

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 (poziom API 35), dlatego musisz przetestować aplikacje, które są już kierowane na poziom API 34 w 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 (Bluetooth/Wi-Fi)
  • Google Pixel Watch 2 (Bluetooth/Wi-Fi)

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

Przygotowanie emulatora do testowania

Aby uruchomić Wear OS 5.1 na oficjalnym emulatorze, musisz najpierw pobrać i zainstalować obraz systemu, który działa na emulatorze. Następnie musisz utworzyć urządzenie wirtualne, na którym będzie działać ten obraz systemu.

Pobieranie i instalowanie obrazu systemu

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

  1. Pobierz i zainstaluj najnowszą wersję Android Studio Ladybug Feature Drop lub nowszą, jeśli nie została jeszcze zainstalowana.
  2. W Android Studio kliknij Narzędzia > Menedżer pakietu SDK.
  3. Na karcie Platformy SDK kliknij Pokaż szczegóły pakietu i rozwiń sekcję Android 15.0 („VanillaIceCream”), która zawiera artefakty dla poziomu interfejsu API 35-ext15. Następnie wybierz Obraz systemu Wear OS 5.1 ARM 64 v8a lub Obraz systemu Wear OS 5.1 Intel x86_64 Atom:

    „Obrazy kompilacji emulatora są widoczne w grupie obrazów kompilacji dla interfejsu API 35 Androida”

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

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

Tworzenie urządzenia wirtualnego

Aby utworzyć urządzenie wirtualne, na którym działa ten obraz systemu w oficjalnym emulatorze, wykonaj te czynności:

  1. W Android Studio otwórz Menedżera urządzeń, klikając 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 wybierz profil sprzętowy. Kliknij Dalej.
  4. Wybierz obraz systemu Wear OS 5.1, którego chcesz użyć. Obraz systemu powinien mieć poziom API 35.
  5. Kliknij Dalej, a następnie Zakończ.

Testowanie aplikacji na emulatorze

Aby przetestować aplikację na utworzonym przez siebie 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 procesy, z których korzysta aplikacja.

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

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

Niektóre zmiany zachowania nie są stosowane w Wear OS 5.1:

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, używając wartości dla Wear OS 5.1.

Sposób formatowania wartości w pliku kompilacji zależy od wersji używanej przez Ciebie wtyczki Androida do obsługi Gradle (AGP).

AGP 7.0.0 lub nowsza

Jeśli używasz AGP 7.0.0 lub nowszej wersji, zaktualizuj plik build.gradle lub build.gradle.kts aplikacji, aby zawierał 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 starsza

Jeśli używasz AGP 4.2.0 lub starszej wersji, zaktualizuj plik build.gradle lub build.gradle.kts aplikacji, aby zawierał 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 interfejsu API 35 musisz uwzględnić zmiany w przypadku aplikacji kierowanych na Androida 15, który używa tego samego poziomu interfejsu API co Wear OS 5.1.

Poznaj nowe funkcje

W Wear OS 5.1 znajdziesz kilka funkcji, które ułatwią korzystanie z aplikacji na Wear OS.

Warto zwrócić uwagę na te funkcje:

  • Obsługa Credential Manager: interfejs Credential Manager API zapewnia ujednolicone rozwiązanie uwierzytelniania, obsługujące procesy logowania przy użyciu haseł, kluczy dostępu i tożsamości sfederowanej (np. Logowania przez Google). Dane logowania użytkownika są przechowywane w dostawcy danych logowania, który synchronizuje informacje o koncie na różnych urządzeniach.
  • Odtwarzanie przez głośnik zegarka: na urządzeniach obsługujących odtwarzanie multimediów przez głośnik zegarka użytkownicy mogą wybrać ten głośnik jako preferowane wyjście multimedialne, jeśli aplikacja integruje się 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 na emulatorze, ma te cechy:

Data premiery 4 marca 2025 r.
Kompilacja

BP1A.250305.019.W3 na urządzeniach

AP4A.241205.004.F4 na emulatorze

Obsługa emulatora x86 (64-bitowy), ARM (v8-A)

Znane problemy

Obraz systemu z Wear OS 5.1 ma te znane problemy:

  • Podczas konfiguracji po przywróceniu ustawień fabrycznych urządzenia emulator nie zawsze pozwala użytkownikowi dodać konto.
  • Gdy użytkownik kliknie powiadomienie, aplikacja, która je wysłała, nie otworzy się, dopóki nie przewinie ekranu.
  • Czasami usługi zdrowotne Wear nie mogą rozpocząć ćwiczenia.
  • Jeśli w aplikacji kierowanej na poziom interfejsu API 35 otworzysz biblioteki androidx.wear.tiles lub androidx.wear:wear-phone-interactions, może wystąpić błąd SecurityException. Aby rozwiązać ten problem, zaktualizuj każdą bibliotekę do najnowszej wersji.