Tworzenie i uruchamianie pierwszej aplikacji na Wear OS

Na tej stronie znajdziesz przewodnik, który pomoże Ci utworzyć pierwszą aplikację na Wear OS przy użyciu szablonu z Android Studio. Aplikacja pokazuje różne sposoby wyświetlania informacji na urządzeniach z Wear OS i przedstawia sprawdzone metody tworzenia aplikacji na tej platformie.

Ten przewodnik opiera się na podstawowej wiedzy o platformie Android i środowisku IDE Android Studio. Jeśli dopiero zaczynasz przygodę z Androidem, utwórz aplikację, korzystając z tego ćwiczenia. Więcej informacji o możliwościach Android Studio znajdziesz na stronie Poznaj Android Studio.

Tworzenie aplikacji na Wear OS

Po pobraniu i zainstalowaniu najnowszej wersji Android Studio wykonaj czynności opisane w kreatorze Nowy projekt:

  1. Otwórz Android Studio, a następnie kliknij Plik > Nowy > Nowy projekt. Pojawi się okno Nowy projekt.
  2. W panelu Szablony wybierz Wear OS. Następnie w głównym panelu wybierz Empty Wear App (Pusta aplikacja na Wear).
  3. Nadaj nazwę projektowi, a następnie kliknij Zakończ. Android Studio pobierze niezbędne zależności i skompiluje projekt.

Możesz teraz uruchomić pierwszą aplikację na Wear OS.

Uruchamianie aplikacji w emulatorze

Prostym sposobem na uruchomienie aplikacji na Wear OS jest użycie emulatora.

Konfigurowanie emulatora

Aby skonfigurować emulator w Android Studio, wykonaj te czynności:

  1. W Menedżerze SDK otwórz kartę SDK Tools. Sprawdź, czy masz najnowszą wersję narzędzi platformy Android SDK. Zamknij Menedżera SDK.
  2. Kliknij Narzędzia > Menedżer urządzeń.
  3. Kliknij Utwórz (+). Pojawi się kreator Konfiguracja urządzenia wirtualnego.
  4. W panelu Kategoria wybierz Wear OS i profil sprzętowy, np. Wear OS Small Round. Kliknij Dalej.
  5. Jeśli nie potrzebujesz konkretnych dostosowań, zachowaj domyślne ustawienia na tym ekranie. Android Studio domyślnie wybiera najnowszy interfejs API i obraz systemu. Kliknij Zakończ.

Więcej informacji o korzystaniu z emulatorów znajdziesz w przewodniku Uruchamianie aplikacji w emulatorze Androida.

Otwieranie aplikacji w emulatorze

  1. Na głównym pasku narzędzi znajdź Uruchom widżet. W menu urządzenia wybierz utworzony emulator i kliknij przycisk Uruchom „Uruchom przycisk”, aby uruchomić aplikację.
  2. Po chwili w emulatorze pojawi się komunikat „Hello...”.

Uruchamianie aplikacji na fizycznym zegarku (opcjonalnie)

Uruchamianie i debugowanie aplikacji na fizycznym zegarku pozwala lepiej ocenić ogólne wrażenia użytkownika. Jest to szczególnie ważne, jeśli aplikacja korzysta z określonego sprzętu, np. czujników lub GPU.

Aby uruchomić aplikację na fizycznym zegarku, przygotuj urządzenie do testowania, a następnie połącz je z komputerem deweloperskim.

Przygotowywanie zegarka do testowania

Aby przygotować zegarek do testowania, włącz debugowanie ADB, wykonując te czynności:

  1. Na zegarku otwórz menu Ustawienia.
  2. Przewiń menu w dół. Jeśli nie widzisz pozycji Opcje programisty, wykonaj te czynności: W przeciwnym razie przejdź do następnego kroku.
    1. Kliknij System > Informacje lub System > Informacje > Wersje.
    2. Znajdź Numer kompilacji i kliknij go 7 razy. Jeśli zegarek jest chroniony kodem PIN lub wzorem, wpisz go, gdy pojawi się odpowiednia prośba.
  3. W menu Ustawienia kliknij Opcje programisty.
  4. Włącz opcję Debugowanie ADB.

Więcej informacji znajdziesz w artykule Konfigurowanie opcji programisty na urządzeniu.

Łączenie zegarka z maszyną deweloperską

Niektóre zegarki umożliwiają połączenie przez USB. Inne wymagają połączenia bezprzewodowego.

Konfigurowanie połączenia przewodowego przez USB

Aby połączyć zegarek, wykonaj te czynności:

  1. Podłącz zegarek do komputera deweloperskiego za pomocą kabla USB.
  2. Na zegarku włącz opcję Zawsze zezwalaj z tego komputera, a potem kliknij OK.

Konfigurowanie połączenia bezprzewodowego

Jeśli debugowanie zegarka przez port USB nie jest możliwe, zapoznaj się z artykułem Łączenie z urządzeniem za pomocą Wi-Fi.

Otwórz aplikację na zegarku

  1. Na pasku narzędzi głównego kliknij Uruchom widżet, a potem w menu urządzenia wybierz urządzenie fizyczne.
  2. Kliknij przycisk Uruchom „Uruchom przycisk” w widżecie Uruchom.
  3. Po chwili na urządzeniu pojawi się komunikat „Hello...”.

Planowanie architektury aplikacji

Teraz, gdy masz już działającą podstawową aplikację, możesz wyjść poza szablon. Zanim zaczniesz dodawać nowe funkcje, warto zastanowić się nad kluczowymi decyzjami dotyczącymi architektury, które będą kształtować Twoją aplikację. W kolejnych sekcjach znajdziesz ważne pytania, które warto rozważyć.

Model aplikacji: samodzielna, niesamodzielna lub hybrydowa

Zastanów się, w jakim stopniu aplikacja zależy od sparowanego telefonu:

  • Hybrydowe (zalecane w przypadku większości aplikacji): to najpopularniejsze i najbardziej elastyczne podejście. Podstawowe funkcje aplikacji działają bez telefonu (np. śledzenie treningu), ale po podłączeniu telefonu oferuje ona dodatkowe funkcje, takie jak synchronizacja danych czy łatwiejsza konfiguracja.
  • Samodzielna: aplikacja działa w pełni samodzielnie, bez konieczności korzystania z telefonu w przypadku funkcji podstawowych. Jest to przydatne w przypadku aplikacji, które mogą działać offline lub korzystać z własnego połączenia internetowego. Szablon „Pusta aplikacja na Wear” domyślnie tworzy samodzielną aplikację.
  • Niesamodzielna: aplikacja wymaga telefonu do obsługi głównej funkcjonalności.

Więcej informacji i wskazówki dotyczące tego wyboru znajdziesz w artykule Samodzielne i niesamodzielne aplikacje na Wear OS.

Tworzenie interfejsu

Compose na Wear OS to nowoczesny deklaratywny framework, który jest zalecanym sposobem tworzenia interfejsów aplikacji na Wear OS. Użyty szablon został utworzony za pomocą Compose, co stanowi świetny punkt wyjścia.

Podczas tworzenia aplikacji za pomocą Compose używaj bibliotek zaprojektowanych specjalnie z myślą o Wear OS. Zawierają one komponenty zoptymalizowane pod kątem zegarków, które są niezbędne, aby zapewnić użytkownikom jak najlepsze wrażenia.

Zamiast standardowego elementu LazyColumn użyj na przykład elementu TransformingLazyColumn, który automatycznie stosuje efekty skalowania i przezroczystości do elementów na krawędzi okrągłego ekranu.

Podobnie w przypadku nawigacji użyj funkcji SwipeDismissableNavHost z biblioteki nawigacji Wear OS, aby zintegrować ją z gestem odrzucania przez przesunięcie w systemie.

Przechowywanie i synchronizacja danych

Sposób zarządzania danymi to podstawowy wybór architektoniczny. W przypadku trwałości na urządzeniu opcje są takie same jak na urządzeniach mobilnych. Zalecane nowoczesne rozwiązania to DataStore do przechowywania danych w formie par klucz-wartość lub obiektów z określonym typem oraz Room do przechowywania bardziej złożonych danych strukturalnych.

  • Najpierw przechowuj dane na urządzeniu: zaprojektuj aplikację tak, aby działała przede wszystkim w trybie offline, przechowując niezbędne dane bezpośrednio na zegarku, dzięki czemu będzie działać bez połączenia z telefonem.
  • Synchronizowanie danych z telefonem: gdy musisz zsynchronizować lub przesyłać strumieniowo dane (np. ustawienia użytkownika lub dane treningu) z aplikacją towarzyszącą na telefonie, użyj interfejsu Data Layer API. Udostępnia kanał komunikacji działający przez Bluetooth i Wi-Fi.

Zarządzanie długotrwałymi zadaniami

Wiele podstawowych funkcji Wear OS, takich jak treningi czy odtwarzanie multimediów, działa przez dłuższy czas. Prawidłowe zarządzanie tymi procesami jest kluczowe dla utrzymania niezawodności i oszczędzania baterii.

  • W przypadku długotrwałych zadań inicjowanych przez użytkownika: gdy użytkownik rozpoczyna zadanie, które musi być kontynuowane nawet po przejściu do innej aplikacji (np. śledzenie biegu), musisz użyć usługi na pierwszym planie. W Wear OS połącz tę usługę z interfejsem Ongoing Activity API. Spowoduje to utworzenie stałego powiadomienia i ikony, w którą można kliknąć na tarczy zegarka, co umożliwi użytkownikowi powrót do aplikacji.
  • W przypadku zadań w tle, które można odłożyć: w przypadku zadań, które nie muszą być wykonywane od razu (np. okresowa synchronizacja danych), używaj WorkManagera. Jest on energooszczędny i uwzględnia optymalizacje systemowe, takie jak tryb uśpienia, dzięki czemu dobrze sprawdza się w przypadku niepilnego przetwarzania w tle.

Wyjdź poza aplikację: platformy i możliwości

Pamiętaj, że środowisko Wear OS to nie tylko główna aplikacja.

  • Obsługa innych interfejsów: aby utworzyć atrakcyjną aplikację wysokiej jakości, zaplanuj obsługę innych interfejsów zoptymalizowanych pod kątem zegarków. Rozważ utworzenie kafelka z szybkimi działaniami i informacjami oraz widżetu, który będzie wyświetlać ważne dane bezpośrednio na tarczy zegarka użytkownika.
  • Zaplanuj efektywność energetyczną: żywotność baterii jest kluczowa w przypadku urządzenia do noszenia. Od samego początku projektuj aplikację tak, aby była energooszczędna. Oznacza to, że musisz starannie przemyśleć sposób pobierania danych, korzystania z czujników i wykonywania zadań w tle. Odłożenie pracy do czasu, gdy zegarek będzie się ładować, jest często dobrą strategią. Więcej informacji znajdziesz w przewodniku po oszczędzaniu energii.