Uwaga: Format tarczy zegarka jest wymagany w przypadku tarcz zegarka, które mają być instalowane na urządzeniach z preinstalowanym systemem Wear OS 5 lub nowszym, oraz w przypadku wszystkich nowych tarcz zegarka publikowanych w Google Play.
Od stycznia 2026 r. format tarczy zegarka będzie wymagany, aby można było instalować tarcze zegarka na wszystkich urządzeniach z Wear OS.
Więcej informacji o zmianach widocznych dla użytkowników znajdziesz w tym artykule w Centrum pomocy.
Tarcza zegarka to pierwsza rzecz, którą użytkownik widzi, gdy patrzy na zegarek. Jest to najczęściej używana powierzchnia Wear OS. Użytkownicy korzystają z tarcz zegarka, aby dostosować zegarki do swojego stylu i szybko sprawdzać informacje.
Opcje tworzenia tarcz zegarka
Format tarczy zegarka (WFF) sprawia, że tworzenie tarcz zegarka jest łatwiejsze niż kiedykolwiek. Format tarczy zegarka został opracowany we współpracy z firmą Samsung. Jest to deklaratywny format XML, który służy do konfigurowania wyglądu i działania tarcz zegarka. W odróżnieniu od innych interfejsów API tarcz zegarka, w przypadku których plik APK musi zawierać kod do renderowania tarczy zegarka, Format tarczy zegarka wymaga tylko zasobów i instrukcji deklaratywnych. Platforma Wear OS obsługuje logikę potrzebną do renderowania tarczy zegarka, dzięki czemu możesz skupić się na kreatywnych pomysłach, a nie na optymalizacji kodu czy wydajności baterii.
Udostępniamy kilka sposobów tworzenia tarcz zegarka:
- Jeśli wolisz narzędzie w stylu WYSIWYG, które umożliwia bezpośrednie projektowanie tarczy zegarka, użyj Watch Face Studio, które obsługujemy we współpracy z firmą Samsung.
- Jeśli jako projektant czujesz się swobodnie w korzystaniu z Figmy lub jeśli jako deweloper chcesz przyspieszyć pierwsze kroki tworzenia tarczy zegarka, użyj Watch Face Designer, do którego dostęp uzyskasz za pomocą wtyczki w Figmie.
Jeśli wolisz ręcznie zarządzać konfiguracją zegarka i publikować w swoim sklepie z aplikacjami, możesz zdefiniować tarcze zegarka za pomocą formatu XML, a następnie opublikować je za pomocą narzędzia Watch Face Push.
Android Studio obsługuje też tworzenie i uruchamianie tarcz zegarka korzystających z Formatu tarczy zegarka.
Tarcze zegarka utworzone w tym formacie wymagają mniej uwagi i aktualizacji niż te, które zostały utworzone przy użyciu starszych bibliotek Jetpack Watch Face. Nie musisz na przykład aktualizować tarczy zegara, aby korzystać z ulepszeń wydajności lub zużycia baterii ani z najnowszych poprawek błędów.
Informacje o formacie
Podstawą tarczy zegarka w formacie WFF jest dokument, który określa układ i działanie tarczy. Ten dokument jest napisany w formacie XML, zgodnie ze specyfikacją WFF.
System Wear OS zawiera komponent renderowania tarczy zegarka. Ten komponent analizuje dokument XML WFF i renderuje na jego podstawie tarczę zegarka. Inne zasoby, takie jak obrazy i czcionki, są pobierane w razie potrzeby.
Dzięki temu wystarczy, że opiszesz, jak ma wyglądać tarcza zegarka, a Wear OS zajmie się całym kodem potrzebnym do jej narysowania.
Aby wdrożyć tarczę zegarka w formacie Format tarczy zegarka na urządzeniu, spakuj dokument XML w standardowym pakiecie AAB lub APK.
Poniższy diagram przedstawia ogólny zarys tego podejścia:
Obsługa wersji w WFF
Wraz z rozwojem WFF dodawane są kolejne funkcje, które są reprezentowane przez więcej elementów, atrybutów i źródeł danych, które korzystają z formatu tarczy zegarka.
Na przykład w WFF w wersji 2 wprowadzono obsługę danych pogodowych jako źródła danych, która nie jest dostępna w WFF w wersji 1.
Projektując tarczę zegarka, pamiętaj, z których funkcji chcesz korzystać i w jakiej wersji są one dostępne. W przewodniku po funkcjach wszystkie funkcje są oznaczone informacją o ich dostępności.
Każda wersja WFF jest zgodna z wersją Wear OS:
| Wersja WFF | Minimalna wersja Wear OS | Minimalny poziom interfejsu API |
|---|---|---|
| 1 | 4 | 33 |
| 2 | 5 | 34 |
| 3 | 5.1 | 35 |
| 4 | 6 | 36 |
Zapoznaj się z tym przewodnikiem, aby prawidłowo skonfigurować plik kompilacji AndroidManifest.xml i Gradle.
Więcej informacji
Więcej informacji o formacie tarczy zegarka znajdziesz w tych przewodnikach:
- Dostępne funkcje: poznaj funkcje tarczy zegarka, które są obsługiwane w poszczególnych wersjach Formatu tarczy zegarka.
- Wytyczne dotyczące projektowania: poznaj sprawdzone metody dotyczące układu tarczy zegarka i wygody użytkowników.
- Watch Face Designer: dowiedz się, jak używać wtyczki Figma do tworzenia tarczy zegarka.
- Konfiguracja: skonfiguruj pakiet aplikacji na Androida, który obsługuje format tarczy zegarka.
- Przykłady w GitHubie: zacznij od utworzenia przykładowych tarcz zegarka i wdrożenia ich w emulatorze Wear OS lub na urządzeniu fizycznym.
- Optymalizacja wykorzystania pamięci: dowiedz się, jak skonfigurować tarczę zegarka, aby system zużywał jak najmniej pamięci podczas jej renderowania.
- Dokumentacja XML: zapoznaj się z poszczególnymi elementami, które wchodzą w skład pliku Formatu tarczy zegarka. Element główny to zawsze
WatchFace. Uwaga: aby wyświetlić funkcje z określonej wersji Formatu tarczy zegarka w dokumentacji XML, upewnij się, że u góry strony dokumentacji jest wybrany odpowiedni przycisk wersji. - Przewodnik po publikowaniu: dowiedz się, jak publikować i zarabiać na tarczach zegarka w Sklepie Play i za pomocą innych metod.
- Walidator WFF i pamięci: użyj tych narzędzi open source, aby sprawdzić, czy plik w formacie tarczy zegarka nie zawiera błędów, i potwierdzić dopuszczalne wykorzystanie pamięci przed przesłaniem go do Google Play.