Ta strona zawiera informacje o wersjach Wear OS, takich jak pakiet SDK na urządzenia noszące i bibliotek obsługujących urządzenia noszące.
.2024-listopada-21 Wearable SDK 19.0.0
Wersja 19.0.0 pakietu SDK na urządzenia noszące zawiera drobne aktualizacje. Aktualizacje obejmują:
- Zaktualizowaliśmy zależności bibliotek do najnowszych wersji.
- Usunięto nieobsługiwany wariant interfejsu API
sendMessage()
, który zawierał parametrMessageOptions
.
31 sierpnia 2023 r. – Wearable SDK 18.1.0
Pakiet SDK na urządzenia noszące w wersji 18.1.0 zawiera drobne aktualizacje interfejsu API, które umożliwiają obsługę kolejnej wersji biblioteki pomocy na urządzenia noszące. Aktualizacje obejmują:
- Więcej informacji znajdziesz w
NodeClient.OnNodeMigratedListener
. - Dodatkowa dokumentacja dotycząca wysyłania i odpowiadania na wiadomości w aplikacji
MessageClient
- Zaktualizowano linki w opisach interfejsów API.
2022-09-20 Wearable SDK 18.0.0
Wersja pakietu SDK na urządzenia noszące 18.0.0 zawiera drobne aktualizacje interfejsu API, które umożliwiają obsługę kolejnej wersji biblioteki pomocy na urządzenia noszące. Aktualizacje obejmują:
WearableListenerService
obsługa aplikacji kierowanych na Androida 13 – problem 235538840.- Nowa metoda
MessageClient.sendRequest()
.
16 lutego 2022 r. – biblioteka obsługująca urządzenia noszone w wersji 2.9.0
W wersji 2.9.0 Biblioteki obsługi urządzeń noszonych wszystkie pozostałe klasy zostały wycofane. Zamiast tego użyj bibliotek Jetpacka na Wear OS.
2021-October-29 Wear OS Jetpack Library
Biblioteki Jetpacka na Wear OS zastępują biblioteki pomocy na urządzeniach do noszenia i nie są przeznaczone do używania razem. Biblioteka Wearable Support Library nie działa na Wear OS 3.
27 kwietnia 2021 r. – Wearable SDK 17.1.0
Pakiet SDK na urządzenia noszące w wersji 17.1.0 zawiera drobne aktualizacje interfejsu API, które umożliwiają obsługę kolejnej wersji biblioteki pomocy na urządzenia noszące.
28 września 2020 r. – biblioteka obsługująca urządzenia noszone w wersji 2.8.1
Wersja 2.8.1 biblioteki obsługującej urządzenia do noszenia zawiera następującą zmianę.
Zezwalanie na wyłączenie Jetifiera podczas używania szablonu tarczy zegarka
Szablon tarczy zegarka w Android Studio korzysta teraz z zależności AndroidX, aby umożliwić wyłączenie Jetifiera. Te poprawki dotyczą korzystania z szablonu tarczy zegarka w Android Studio 4.2 lub nowszej wersji.
24 września 2020 r. – Wearable Support Library w wersji 2.8.0
Wersja 2.8.0 biblioteki obsługującej urządzenia do noszenia zawiera te zmiany.
Możliwość użycia alternatywnego sposobu wyświetlania domyślnych dostawców widżetów innych niż systemowe
Tarcze zegarka mogą teraz używać elementu setDefaultComplicationProviderWithFallbacks
, aby określić co najmniej 1 dostawcę widżetów niesystemowych, który ma być używany domyślnie. Jeśli żaden z podanych dostawców zewnętrznych nie jest zainstalowany, system użyje domyślnego dostawcy systemowego.
wycofanie WearableActivity,
Właściwość WearableActivity
została wycofana. Zamiast tego użyj kolumny AmbientModeSupport
.
Użycie parametru SKIP_CONFIRMATION_UI jest nieaktualne
Właściwość ActionConfirmationActivity.SKIP_CONFIRMATION_UI
została wycofana. Ta dodatkowa funkcja nie była używana od czasu wydania Wear 2.0.
15 maja 2020 r. – biblioteka pomocy dla urządzeń noszonych w wersji 2.7.0
Wersja 2.7.0 biblioteki obsługi urządzeń noszonych zawiera te funkcje:
Sprzętowa akceleracja tarcz zegarka
Teraz możesz poprosić o użycie canvasa z akceleracją sprzętową podczas korzystania z klasy CanvasWatchFaceService
. Korzystaj z przyspieszania sprzętowego, aby zwiększyć wydajność tarczy zegarka i uzyskać dostęp do większej ilości danych o wydajności interfejsu.
Więcej informacji znajdziesz w artykule Zwiększanie wydajności tarczy zegarka dzięki akceleracji sprzętowej.
2020-04-21 Wearable Support Library v2.6.0
Wersja 2.6.0 biblioteki obsługi urządzeń noszonych zawiera te usprawnienia:
Migracja do Android Jetpack
Biblioteka obsługująca urządzenia noszone została przeniesiona do Android Jetpack.
Istniejące biblioteki są teraz mapowane i dostępne w AndroidX za pomocą przestrzeni nazw androidx
, a wszystkie zależności od wycofanej biblioteki wsparcia zostały usunięte.
Ta zmiana umożliwia też korzystanie z bibliotek obsługujących urządzenia noszone w Android Studio 4.0 lub nowszej wersji, co rozwiązuje problemy takie jak problem 147972079.
28 sierpnia 2019 r. – biblioteka obsługująca urządzenia do noszenia w wersji 2.5.0
Wersja 2.5.0 biblioteki Wearable Support Library zawiera te ulepszenia:
Poprawka dotycząca klasy ComplicationDrawable, gdy wywoływana jest metoda startActivity() z typem widżetu TYPE_NO_PERMISSION
ComplicationDrawable
obejmie teraz flagę NEW_TASK
, która zapewni, że wywołania startActivity()
pochodzące z WatchFaceService
będą zawierać FLAG_ACTIVITY_NEW_TASK
, aby uniknąć błędu android.util.AndroidRuntimeException
.
Ta zmiana umożliwia tarczy typu TYPE_NO_PERMISSION
prawidłowe uruchamianie aktywności prośby o zgodę zamiast zawieszania tarczy.
25 września 2018 r. – Wearable SDK 16.0.0
Pakiet SDK na urządzenia noszące w wersji 16.0.0 wymaga Usług Google Play w wersji 8.6 zamiast 12.4. Ta zmiana umożliwia aktualizację dotychczasowych aplikacji do najnowszej wersji pakietu SDK na urządzenia noszące, bez konieczności aktualizowania pliku APK Usług Google Play.
11.06.2018 Aktualizacja do wersji Wear OS dla programistów 2
Niedawna aktualizacja przez Internet do Wear OS w wersji dla programistów 2 ponownie włączyła alarmy i zadania dla aplikacji działających w tle.
Ta zmiana zasad zwiększa elastyczność w rozwijaniu aplikacji, ale alarmy i procesy w tle nadal podlegają innym ograniczeniom Androida P, w tym tym dotyczącym grup w trybie gotowości aplikacji. Stosuj sprawdzone metody, aby zapewnić prawidłowe działanie aplikacji niezależnie od tego, do której grupy należą.
Ta aktualizacja zwiększa też prywatność danych i danych wprowadzanych przez użytkownika, ograniczając dostęp aplikacji działających w tle do danych sensorów i danych wprowadzanych przez użytkownika. W zależności od wymagań aplikacji możesz potrzebować usługi na pierwszym planie, aby umożliwić stały dostęp do danych z czujników.
2018-05-08 Wear OS Developer Preview 2
Wersja Developer Preview 2 systemu Wear OS zawiera m.in. ulepszone funkcje Asystenta Google.
Przesyłaj błędy i opinie za pomocą śledzika problemów Wear OS by Google. Im wcześniej je prześlesz, tym większe prawdopodobieństwo, że poprawki zostaną uwzględnione w ostatecznej wersji.
Znane problemy
Ta sekcja zawiera znane problemy w wersji w wersji wstępnej 2.
Problemy z obrazem na Wear OS
- Gdy używasz aplikacji i naciskasz przycisk zasilania na boku zegarka, możesz wrócić do poprzedniego ekranu, a nie do tarczy zegarka.
Problemy z obrazem na potrzeby wersji Wear OS na rynek chiński
- Gdy używasz aplikacji i naciskasz przycisk zasilania na boku zegarka, możesz wrócić do poprzedniego ekranu, a nie do tarczy zegarka.
- Ustawienia dźwięku związane z głośnością nie są zapisywane. Na przykład połączenie przychodzące powoduje, że zegarek dzwoni, nawet jeśli dźwięk na zegarku jest wyłączony. Jeśli zmienisz głośność alarmu, zmiana ta nie będzie miała żadnego wpływu.
- Wiele trwających powiadomień może nie wyświetlać się prawidłowo. Jeśli na przykład ustawisz zarówno minutnik, jak i stoper, powiadomienia nie będą się wyświetlać. Zalecamy przetestowanie aplikacji z 1 powiadomieniem, a nie z większą liczbą.
- Sklep z aplikacjami Wear w wersji chińskiej nie działa. Deweloperzy nie mogą aktualizować ani instalować nowych aplikacji za pomocą tego kanału. Zalecamy użycie polecenia „adb” jako obejścia problemu, aby załadować aplikację do testowania.
Problemy z emulatorem Wear
- Połączenia przychodzące na telefony towarzyszące nie są wyświetlane ani _odbione_ jako połączenia przychodzące na sparowanym emulatorze.
- Jeśli używasz Menedżera pakietu SDK do zainstalowania lub potwierdzenia, że masz najnowszą wersję Androida P lub wersję na rynek chiński, pola wyboru obok tych opcji mogą zostać odznaczone po ich wybraniu. Jeśli zostaną odznaczone, zaznacz je ponownie.
- Gdy emulator wykona zimny rozruch, może wyświetlić się ten komunikat o błędzie: „Wystąpił wewnętrzny błąd urządzenia. Aby uzyskać szczegółowe informacje, skontaktuj się z producentem”. Nie wpłynie to na funkcjonalność. Aby rozpocząć testowanie aplikacji, przewiń w dół i kliknij OK.
- Odpowiedź głosowa może nie działać na emulatorze. Jeśli na przykład na emulowanym urządzeniu Wear otrzymasz powiadomienie o wiadomości z Google Hangouts i próbujesz odpowiedzieć na nią głosowo, pojawi się komunikat o błędzie „Google ciągle się zatrzymuje” i nie będzie można odpowiedzieć głosowo.
- Funkcja Instant Run może być niezgodna z emulatorem Wear.
- Robienie zrzutu ekranu za pomocą programów, takich jak „adb” lub raport o błędzie, może nie działać. Aby zrobić zrzut ekranu, kliknij przycisk aparatu na pasku narzędzi emulatora.
Problemy z wersją emulatora Wear na rynek chiński
- Połączenia przychodzące na telefony towarzyszące mogą nie być wyświetlane lub _odbijane_ jako połączenia przychodzące na sparowanym emulatorze. W związku z tym powiadomienia o nieodebranych połączeniach mogą nie wyświetlać się w emulatorze. Dodatkowo możesz nie mieć możliwości odebrania połączenia z emulatora. W takim przypadku połączenie będzie nadal dzwonić.
- Jeśli używasz Menedżera pakietu SDK do zainstalowania najnowszej wersji Androida P lub do potwierdzenia, że masz zainstalowaną tę wersję lub wersję chińską, pola wyboru obok tych opcji mogą zostać odznaczone po ich wybraniu. Jeśli zostaną odznaczone, zaznacz je ponownie.
- Gdy emulator wykona zimny rozruch, może wyświetlić się ten błąd: „W Twoim urządzeniu wystąpił problem wewnętrzny. Aby uzyskać szczegółowe informacje, skontaktuj się z producentem”. Nie wpłynie to na funkcjonalność. Aby rozpocząć testowanie aplikacji, przewiń w dół i kliknij OK.
- Funkcja Instant Run może być niezgodna z emulatorem Wear.
- Robienie zrzutu ekranu za pomocą programów, takich jak „adb” lub raport o błędzie, może nie działać. Aby zrobić zrzut ekranu, kliknij przycisk aparatu na pasku narzędzi emulatora.
Asystent Google na Wear
Ulepszona obsługa Asystenta na Wear OS umożliwia tworzenie aplikacji na urządzenia noszące bez konieczności pisania kodu na Androida. W szczególności możesz tworzyć aplikacje na platformie Actions on Google, aby pomagać użytkownikom w wykonaniu zadań przy użyciu Twoich produktów i usług.
Ponadto Wear OS obsługuje teraz szybsze interakcje za pomocą głosu i dotyku. Obsługiwane są też elementy sugestii. Są to:
- Pomaganie użytkownikom w szybszym zakończeniu interakcji
- Podawanie użytkownikom wskazówek dotyczących możliwości działania
Ponadto Wear OS obsługuje teraz więcej kart wizualnych, a także listy i karuzele.
Aby tworzyć usługi w Google na Wear OS, możesz więc używać DialogFlow
, szablonów lub pakietu SDK Actions. Możesz też korzystać z nowych szablonów odpowiedzi, które są przeznaczone do oglądania. Sprawdzone metody dotyczące działań w Google:
- Krótki, zwięzły dialog
- Włączanie sygnałów wizualnych i głosowych
Te ulepszenia Asystenta na Wear OS nie zależą od Androida P i są wprowadzane u wszystkich użytkowników Wear 2.0. Więcej informacji o tworzeniu aplikacji Actions on Google znajdziesz w artykule Integracja z Asystentem Google.
Oszczędzanie baterii w wersji zapoznawczej 2
Jak opisano w sekcji poniżej, w celu wydłużenia czasu pracy na baterii dostępne są funkcje związane z zasilaniem. Informacje w tej sekcji dotyczące wersji dla deweloperów 2 zastępują informacje związane z zasilaniem w wersji dla deweloperów 1.
Nowy tryb: Ulepszone oszczędzanie baterii
Gdy zegarek jest w trybie oszczędzania baterii, wyświetla się domyślna tarcza zegara zoptymalizowana pod kątem oszczędzania energii. Wyłączone są te opcje:
- Radia
- Ekran dotykowy
- Funkcja przechyl, aby wybudzić
Użytkownicy mogą sprawdzić godzinę, krótko naciskając przycisk boczny. Długie naciśnięcie umożliwia użytkownikowi przełączenie się z trybu oszczędzania energii w tryb pełnego działania i wykonywanie zadań, takich jak płatność za pomocą NFC czy odpowiadanie na wiadomość. Załóżmy, że aplikacje, tarcze zegarka i dostawcy danych widżetów są niedostępne w trybie oszczędzania baterii.
Ograniczona aktywność w tle
Aby poprawić zarządzanie energią, aplikacje w tle nie mogą już uruchamiać alarmów ani zadań, chyba że zegarek jest podłączony do ładowarki. Wyjątkiem są tarcze zegarka i aktywne widżety.
Uwaga: jeśli aplikacja musi być zawsze uruchomiona, np. do monitorowania w tle, zalecamy użycie usługi na pierwszym planie za pomocą metody
startForegroundService()
. Więcej informacji znajdziesz w sekcji Ograniczenia usługi działającej w tle. Usługa na pierwszym planie jest odpowiednia w wyjątkowych przypadkach użycia, takich jak monitorowanie stanu zdrowia.
Ulepszona zgodność aplikacji
Aby zwiększyć zgodność aplikacji, w Androidzie P zaczęliśmy stosować pewne ograniczenia dotyczące interfejsów spoza pakietu SDK. Zaplanuj migrację z metod i pól nieobejmujących pakiet SDK. Jeśli w przypadku Twojego przypadku użycia nie ma publicznego odpowiednika, daj nam znać.
ciemny motyw interfejsu,
Od początku 2018 roku Wear OS używa domyślnego motywu interfejsu z ciemniejszym tłem dla strumienia powiadomień i wybierania systemu. Ta zmiana ma na celu ułatwienie szybkiego przeglądania aplikacji. Sprawdź, czy w nowej tematyce interfejsu aplikacja jest nadal dostępna dla osób z ograniczonymi możliwościami.
Dostępne są zaktualizowane ćwiczenia z programowania
Aby pomóc Ci poznać ważne sposoby tworzenia aplikacji na Wear OS, udostępniliśmy zaktualizowane ćwiczenia z programowania. Aby na przykład poeksperymentować z językiem domen specyficznych dla Kotlina (DSL), wykonaj nowe ćwiczenie z programowania dotyczące tarczy zegarka na podstawie Kotlina.
2018-03-27 Wear OS Developer Preview 1
Ta sekcja zawiera informacje o wersji zapoznawczej 1 dla deweloperów Wear OS by Google. Przed wydaniem finalnej wersji produkcyjnej spodziewamy się kilku aktualizacji tej wersji w podglądzie. Przesyłaj znalezione błędy za pomocą śledzika problemów z Wear OS by Google. Im wcześniej je prześlesz, tym większe prawdopodobieństwo, że uda nam się uwzględnić poprawki w wersji końcowej.
Znane problemy
- W aplikacji towarzyszącej Wear OS kliknięcie opcji Zgłoś błąd na urządzeniu wydaje się działać, ale raport o błędzie nie jest generowany.
Aby obejść ten problem, użyj
adb bugreport
. - Odbieranie połączeń telefonicznych za pomocą zegarka nie zawsze się udaje. Jeśli się nie uda, użytkownik musi zaakceptować połączenie bezpośrednio z telefonu.
- Po sparowaniu lub uruchomieniu wstępnie załadowanej aplikacji może pojawić się komunikat o błędzie „Wykryto problemy z zgodnością interfejsu API”. Komunikat ten znika po chwili i nie wpływa na użyteczność.
- W menu Ustawienia na zegarku i w emulatorze dwukrotnie wyświetla się opcja Zgłoś błąd. Aby przesłać zgłoszenie błędu, spróbuj użyć obu opcji, ponieważ tylko jedna z nich działa. Gdy klikniesz opcję funkcjonalną, pojawi się komunikat, że generowany jest raport o błędzie.
- W wersji chińskiej wprowadzanie tekstu za pomocą mowy powoduje awarię aplikacji. Dzieje się tak na przykład w przypadku wyszukiwania głosowego lub dodawania przypomnienia głosowego, ponieważ te funkcje korzystają z interfejsów API do wprowadzania głosowego. Podczas testowania zamiast głosowego wprowadzania tekstu użyj klawiatury lub ręcznego wpisywania.
- Sklep z aplikacjami Wear w wersji chińskiej nie działa. Deweloperzy nie mogą aktualizować ani instalować nowych aplikacji za pomocą tego kanału. Zalecamy użycie narzędzia adb jako obejścia problemu, aby załadować aplikację do testów.
Najważniejsze informacje o tej wersji dla programistów
Wersja dla deweloperów 1 zawiera te funkcje do testowania aplikacji:
-
Ograniczona aktywność w tle: aby poprawić zarządzanie zasilaniem, aplikacje działające w tle nie mogą już używać alarmów ani zadań. Wyjątkiem są tarcze zegarka i widżety wybrane przez użytkownika. Ta funkcja będzie wdrażana stopniowo w wersjach przedpremierowych dla programistów, więc możesz nie zauważyć jej od razu na zegarku.
Uwaga: jeśli aplikacja musi działać zawsze, zmodyfikuj ją, aby stała się usługą na pierwszym planie, używając metody
startForegroundService()
. Więcej informacji znajdziesz w artykule Ograniczenia dotyczące usług działających w tle. - Ograniczenia korzystania z interfejsów spoza pakietu SDK przez aplikacje: aby zwiększyć zgodność aplikacji, w Androidzie P zaczęliśmy stosować pewne ograniczenia korzystania z interfejsów spoza pakietu SDK. Zaplanuj migrację z metod i pól innych niż SDK. Jeśli w przypadku Twojego przypadku użycia nie ma publicznego odpowiednika, daj nam znać.
- Ciemny motyw interfejsu systemu: od początku 2018 roku system Wear OS używa domyślnego motywu interfejsu z ciemniejszym tłem dla strumienia powiadomień i wyskakującego okienka. Ta zmiana ma na celu poprawę czytelności Twoich aplikacji. Sprawdź, czy w nowej tematyce interfejsu aplikacja jest nadal dostępna dla osób z ograniczonymi możliwościami.
- Radio jest wyłączone, gdy zegarek jest odłączony od ciała: aby poprawić zarządzanie energią, radio Bluetooth, radio Wi-Fi i radio komórkowe są wyłączone, gdy zegarek jest wykrywany jako odłączony od ciała przez dłuższy czas. Ta funkcja będzie wdrażana stopniowo w ramach wersji dla programistów, więc początkowo możesz jej nie zauważyć na zegarku. Jeśli ta funkcja
sprawia problemy w procesie tworzenia, możesz ją wyłączyć za pomocą polecenia „adb”:
adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
- Wi-Fi jest wyłączone, gdy Bluetooth jest rozłączony: aby poprawić zarządzanie energią, zegarek nie łączy się automatycznie z Wi-Fi, gdy rozłączy się z Bluetooth. Wyjątkiem jest sytuacja, gdy aplikacja wymaga sieci o dużej przepustowości, oraz sytuacja, gdy zegarek jest podłączony do ładowarki. Ta funkcja będzie wdrażana stopniowo w ramach wersji dla programistów, więc początkowo możesz jej nie zauważyć na zegarku.
Aktualizacje biblioteki pomocy dotyczącej urządzeń noszonych, wersja 2.3.0
Aktualizacja dokumentacji do wersji 2.3.0 Biblioteki pomocy dla urządzeń do noszenia zawiera zmiany związane z rebrandingiem.
Dodatkowo biblioteka w wersji 2.3.0 zawiera aktualizacje dotyczące funkcji
ComplicationDrawable
i
TextRenderer
w przypadku tekstu, do którego dołączone są obiekty znaczników w zakresie tekstowym.
Te klasy mają ulepszoną obsługę tekstów z przeplataniem.
Tylko określony podzbiór elementów może być renderowany (patrz metoda
setText
dotycząca typów elementów, które mogą być renderowane), aby elementy te nie wyglądały nie na swoim miejscu po renderowaniu na tarczy zegarka.
2018-03-15 Zmiana nazwy Wear
Ta sekcja zawiera informacje o funkcjach Wear OS.
Nowa nazwa Androida Wear
Android Wear został przemianowany na Wear OS by Google.
27 lutego 2018 r.: aktualizacja trybu Ambient
Ta sekcja zawiera informacje o nowych funkcjach Androida Wear.
Nowa klasa obsługująca tryb nieaktywny
Wersja 27.1.0 biblioteki pomocy Androida zawiera nową klasę
AmbientModeSupport
, która zastępuje wycofaną klasę
AmbientMode
. Aktualizacje próbek są zaplanowane na najbliższe tygodnie.
2018-Jan-25 Final emulator and more
Ta sekcja zawiera informacje o nowych funkcjach Androida Wear.
Emulator Androida: aktualizacja dla Wear
Ostatnia aktualizacja emulatora Androida związana z Wear jest dostępna do testowania aplikacji opartych na interfejsie API w wersji 26.
Ulepszenia w bibliotece obsługującej urządzenia do noszenia w wersji 2.2.0
Wersja 2.2.0 biblioteki obsługującej urządzenia noszące zawiera zmiany opisane poniżej.
nowy wskaźnik nieprzeczytanych powiadomień;
Użytkownicy chcą wiedzieć, czy mają nieprzeczytane powiadomienia, dlatego udostępniliśmy nowy wskaźnik: kropkę w kółku na dole tarczy zegara. Jeśli wolisz samodzielnie zarządzać powiadomieniami, możesz użyć
setHideNotificationIndicator
, aby ukryć domyślny wskaźnik i wyświetlić własny, lub
setHideNotificationIndicator
, aby wyświetlić liczbę powiadomień na pasku stanu.
setShowUnreadCountIndicator
Dostosuj kolor zewnętrznego pierścienia wskaźnika nieprzeczytanych powiadomień za pomocą metody
setAccentColor
.
Uwaga: wskaźnik nieprzeczytanych powiadomień nie jest włączony w wersji produkcyjnej Wear 2.8.0. Zamiast tego przetestuj implementację za pomocą najnowszego emulatora Wear. Począwszy od kolejnej wersji Wear (2.9.0) przeznaczonej dla użytkowników, wskaźnik nieprzeczytanych powiadomień będzie wyświetlany domyślnie.
Ulepszenia klasy ComplicationDrawable
Klasa
ComplicationDrawable
inicjuje żądanie uprawnień dla tarczy zegarka, która jest dotykana, gdy system wskazuje wartość
TYPE_NO_PERMISSION
, co oznacza, że tarcza zegarka nie ma uprawnień do uzyskiwania danych z komplikacji.
Dodatkowo klasa ComplicationDrawable
staje się nieprawidłowa, gdy skończy się wczytywanie obrazów lub gdy wygaśnie podświetlenie po kliknięciu. Aby odpowiedzieć na to unieważnienie, np. narysować tarczę zegarka, dodaj
Drawable.Callback
.
Znane problemy
- Jeśli w emulatorze włączysz tryb kinowy, zgodnie z instrukcjami w artykule Zmienianie ustawień ekranu i jasności, emulacja może się zawiesić w trybie kinowym. Aby rozwiązać ten problem, musisz wyczyścić dane emulatora. W tym celu skorzystaj z instrukcji uruchamiania i zatrzymywania emulatora oraz czyszczenia danych.
- W oknie emulatora dla poziomu interfejsu API 25 lub 26 przycisk zasilania nie działa. Zamiast tego użyj innych przycisków niż przycisk zasilania. Aby przełączyć się do trybu spoczynkowego (np. gdy użytkownik przykrywa ekran dłonią), użyj przycisku zasilania na pasku narzędzi emulatora po prawej stronie wyświetlacza. Aby uruchomić program uruchamiający w trybie interaktywnym, kliknij przycisk strony głównej na pasku narzędzi emulatora.
- Jeśli w wersji emulatora dla Chin używasz metody wprowadzania pismem odręcznym, ekran może zacząć migać. Gdy klikniesz przycisk klawiatury ekranowej, klawiatura zajmie połowę ekranu.
2017-Dec-18 Nowy dostęp do usług Google Play
Ta sekcja zawiera informacje o nowych funkcjach Androida Wear.
Migracja z klasy GoogleApiClient
Począwszy od wersji
11.8.0 Usług Google Play należy przenieść aplikacje na Wear OS z klasy GoogleApiClient
do klasy
GoogleApi
i zamiast niej używać obiektów klienta interfejsu API opartych na klasie
GoogleApi
i interfejsie Tasks API.
Uwaga: ta aktualizacja nie dotyczy aplikacji na Androida Wear w Chinach, które zwykle korzystają z wersji 10.2.0 Usług Google Play.
Więcej informacji znajdziesz w tych artykułach:
- Migracja aplikacji na Wear do GoogleApi
- Dostęp do interfejsów API Google
-
Wearable
class documentation
New components for connecting with Google Play services
When you use classes that extend the
GoogleApi
class, such as
DataClient
and
MessageClient
, the Google Play services SDK manages
connections to Google Play services for you. Apps that use these classes no longer need to
create and manage GoogleApiClient
objects. See the blog post
Moving Past GoogleApiClient for more information.
For the replacements of Wear-related components for connecting to Google
Play services, see
Replacements for deprecated components.
For releases and known issues related to
Google Play services, see the Release Notes for
Google Play services.
Note: If you compile your app with the latest version of
Google Play services, users are prompted to update their devices to that
latest version. However, a known issue for apps that target API version
26 might prevent users from being prompted to update their devices. This
issue is described in the Release Notes for
Google Play services.
2017-Oct-25 Ambient mode and more
This section contains information about new Android Wear features.
Android Support Library, v27.0.0: Features and bugfixes
The
27.0.0 version of the Android Support Library contains new features
for Wear. Review the following section.
New, preferred way to support ambient mode
Ambient mode lets a Wear app remain visible to a user when the
device goes idle. The Android Support Library has a new,
preferred way for your apps to use ambient mode. The Wear team seeks
developer feedback about this significant change.
Specifically, using the
AmbientMode
class offers the following benefits:
- The
Activity
subclasses in the Android Support Library, such as
FragmentActivity
. Functionality for
support library fragments is available.
-
Architecture components, which are
lifecycle aware.
- Better support for Google
Sign-In.
Manifest metadata constants in the Android Support Library
Constants for Android Wear apps, used in the meta-data
tag
in the Android Manifest file, are now
available in the Android Support Library. To use the constants—for
standalone apps, notification bridging mode, and watch face preview
images—add a reference to the following in the dependencies section of
the app module's build.gradle
file, which requires the latest
version of the Google Repository:
Groovy
implementation 'com.android.support:wear:27.0.0'
Kotlin
implementation("com.android.support:wear:27.0.0")
Action drawer updates
Updates are available to the
WearableActionDrawerView
class, which is used for creating a wearable
action drawer. In the latest version:
- When menu items are modified, the action drawer properly updates.
- If set for an action drawer, the title displays correctly.
Inflation of the RoundedDrawable class
Assuming an API level of at least 24, the
RoundedDrawable
class can now be inflated from a drawable XML file;
see
Custom drawables.
Wearable Support Library, v2.1.0: Enhancements and more
The
2.1.0 version of the Wearable Support Library includes the updates
described in the following section, and requires Android Support Library version 26.0.2 or
higher.
Supply burn-in-safe images for ambient mode
The
ComplicationDrawable
class lets you supply burn-in-safe
images for ambient mode. Specifically, a
ComplicationData
object's burn-in protection small
image field lets a watch face display a small image in the
SMALL_IMAGE
complication type, in ambient mode, when burn-in
protection is enabled.
Tap event updates for complications
The
ComplicationDrawable
class has a new onTap
method
that lets your watch face pass tap events to complications. The new
method builds on the existing functionality in which a tap on the watch
face triggers the
WatchFaceService.Engine.onTapCommand
method.
You can pass the coordinates to a ComplicationDrawable
with
an onTap
call to launch the action associated with the
ComplicationDrawable
that contains the tap coordinates. When
the new onTap
method is called, you can use a return value
of true
to see whether a ComplicationDrawable
launched the action associated with it.
Additionally, the setHighlightDuration
method sets the
duration for a complication to remain highlighted after the
onTap
method is called.
Progress bar for ranged value complications
If you prefer to draw your own progress bar for ranged value
complications in your watch face, use the
setRangedValueProgressHidden
method of the
ComplicationDrawable
class to hide the ranged value progress
that's drawn by the ComplicationDrawable
.
2017-Oct-02 Android Wear beta
Date: 2017-Oct-02
Build: OWP4.170828.008
Supported device: LG Watch Sport
This section contains known issues for an Android Wear beta release. For
information about the beta program or to enroll,
see the
Android beta page.
Known issues
- Google Pay and its cards do not function with this Android Wear beta
release.
- Even if cellular connectivity is on, it is turned off after the beta
is installed. As a workaround, turn on cellular connectivity after
the beta is installed by navigating to
Settings > Connectivity > Cellular.
- If notifications are erratic or missing after a beta update,
or contacts were not synced, factory-reset your watch.
- In the Wear tutorial, which starts after a watch is set up, some cards
behave erratically, but they can be dismissed normally with a swipe.
- On Android 6.0 phones, phone call notifications are not
received on the watch.
- Heart rate monitoring sometimes fails after an update. As a workaround,
reboot the watch.
- The OTA card in the stream sometimes fails to enable an installation.
As a workaround, navigate to
Settings > System > About > System Updates.