Tworzenie i uruchamianie aplikacji na Wear OS

Na tej stronie znajdziesz przewodnik, który pomoże Ci utworzyć pierwszą aplikację na Wear OS za pomocą szablonu w Android Studio. Aplikacja pokazuje różne sposoby wyświetlania informacji na urządzeniach z Wear OS oraz przedstawia sprawdzone metody tworzenia aplikacji na tę platformę.

Ten przewodnik opiera się na wcześniejszej znajomości platformy Android i środowiska IDE Android Studio. Jeśli nie masz żadnego doświadczenia z Androidem, utwórz aplikację za pomocą tego ćwiczenia kodu. Aby dowiedzieć się więcej o możliwościach Android Studio, otwórz stronę Poznaj Android Studio.

Uwaga: aby używać najnowszych obrazów systemowych dostępnych dla emulatora, zainstaluj Android Studio Hedgehog lub nowszą wersję.

Tworzenie aplikacji na Wear OS

Po pobraniu i zainstalowaniu najnowszej wersji Android Studio wykonaj czynności w kreatorze „nowy projekt”:

1. Otwórz Android Studio i kliknij Plik > Nowy > Nowy projekt. Pojawi się okno Nowy projekt.
2. W panelu Szablony wybierz Wear OS. Następnie na panelu głównym wybierz Pusta aplikacja Wear.
3. Nazwij projekt i kliknij Zakończ. Android Studio pobierze niezbędne zależności i utworzy początkową wersję projektu.

4. Kliknij Narzędzia > Menedżer pakietu SDK, a następnie Pokaż szczegóły pakietu i zainstaluj te pakiety:

   • Android 15.0 („VanillaIceCream”) (poziom interfejsu API 35-ext15), który obejmuje obraz systemu Wear OS 5.1 ARM 64 v8a i obraz systemu Wear OS 5.1 Intel x86 Atom_64.
   • Android 14.0 („UpsideDownCake”) (poziom API 34), który obejmuje obraz systemu Wear OS 5 ARM 64 v8a i obraz systemu Wear OS 5 Intel x86 Atom_64.
   • Android 13.0 („Tiramisu”) (poziom API 33), który obejmuje obraz systemu Wear OS 4 ARM 64 v8a i obraz systemu Wear OS 4 Intel x86 Atom_64.
   Uwaga: najnowsza stabilna wersja Wear OS, Wear OS 5.1, jest oparta na Androidzie 15.

   Aby zamknąć Menedżera SDK, kliknij OK.

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

Uwaga: domyślnie kreator Nowy projekt tworzy samodzielną, niezależną aplikację Wear OS, która nie musi być połączona z innym urządzeniem, aby działać.

Aplikacja na Wear OS powinna działać niezależnie od aplikacji na telefon, zapewniając użytkownikom największą elastyczność w wyborze telefonu. Jeśli ze względu na złożoność lub specyfikę aplikacji konieczne jest połączenie z telefonem, zapoznaj się z instrukcją łączenia zegarka z telefonem.

Uruchamianie aplikacji na emulatorze

Najprostszym sposobem uruchomienia pierwszej aplikacji na Wear OS jest skonfigurowanie emulatora.

Uwaga: jeśli planujesz udostępnić aplikacje na Wear OS w Chinach, zapoznaj się też ze stroną Tworzenie aplikacji na Wear OS na rynek chiński.

Konfigurowanie emulatora

Aby skonfigurować emulator w Android Studio:

1. W Menedżerze pakietów SDK otwórz kartę Narzędzia pakietu SDK. Sprawdź, czy masz najnowszą wersję pakietu Android SDK Platform-Tools.
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. W przypadku obrazów systemowych używanych poza Chinami wybierz nazwę wersji UpsideDownCake. Ta wersja jest kierowana na Androida 14.0 (Wear OS 5). W przypadku obrazów systemowych używanych w Chinach wybierz nazwę wersji R. Ta wersja jest przeznaczona dla Androida 11.0 (Wear OS 3). Jeśli nie masz jeszcze zainstalowanego obrazu systemu Wear OS 5, który odpowiada definicji urządzenia, kliknij Pobierz obok Nazwa wersji. Kliknij Dalej.

   Uwaga: obrazy systemu dla emulatora Wear OS zawierają powiadomienia o plikach i źródle kodu innych firm. Aby wyświetlić powiadomienia innych firm dotyczące konkretnego obrazu systemu, otwórz plik NOTICE.txt znajdujący się w jednym z tych katalogów:

   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI dla emulatorów używanych poza Chinami.
   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI dla emulatorów używanych w Chinach.

6. Na tym ekranie możesz zachować wartości domyślne wszystkich ustawień, chyba że chcesz dostosować emulator. Kliknij Zakończ.

Więcej informacji o używaniu emulatorów znajdziesz w przewodniku uruchamiania aplikacji na emulatorze Androida.

Otwórz aplikację w emulatorze.

1. Kliknij Uruchom > Wybierz urządzenie. Wybierz utworzony właśnie emulator.
2. Na pasku narzędzi Android Studio kliknij Uruchom . Emulator uruchamia i otwiera aplikację.
3. Po chwili na emulatorze powinien wyświetlić się komunikat „Cześć…”.

Testowanie dźwięku Bluetooth za pomocą emulatora

W przypadku obrazów systemowych z Wear OS 4 lub nowszym emulator obsługuje emulowany Bluetooth, co umożliwia testowanie dźwięku Bluetooth w różnych zastosowaniach.

Najnowsze obrazy systemowe obsługują tylko 64-bitowe architektury.

Obrazy systemu emulatora dla Wear OS 4 i nowszych obsługują tylko te 64-bitowe architektury: x86-64 i arm64-v8a. Jeśli wiesz lub podejrzewasz, że Twoja aplikacja używa kodu natywnego (który nie jest napisany w językach programowania Kotlin ani Java), sprawdź, czy zawiera on 32- i 64-bitowe biblioteki natywne.

Dowiedz się więcej o obsługiwaniu architektur 64-bitowych.

Uruchamianie aplikacji na zegarku (opcjonalnie)

Uruchamianie i debugowanie aplikacji na rzeczywistym zegarku pozwala lepiej ocenić ogólne wrażenia użytkownika. Jest to szczególnie ważne, jeśli aplikacja korzysta ze specjalnego sprzętu, np. czujników lub procesora graficznego.

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

Przygotowanie 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. Przejdź na dół menu. Jeśli nie widzisz opcji Opcje dla deweloperów, wykonaj te czynności. W przeciwnym razie przejdź do następnego kroku.
   1. Kliknij System > Informacje lub System > Informacje > Wersje.
   2. Znajdź element Numer kompilacji i kliknij go 7 razy. Jeśli zegarek jest chroniony kodem PIN lub wzorem, wpisz go, gdy pojawi się taka prośba.
3. W menu Ustawienia kliknij Opcje programisty.
4. Włącz opcję Debugowanie ADB.

Łączenie zegarka z kompjuterem

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 programistycznego 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 Twój zegarek nie ma portu USB, dowiedz się, jak połączyć go przez Wi-Fi lub Bluetooth.

Zainstaluj określoną wersję Wear OS (opcjonalnie)

Jeśli przypadek testowy aplikacji zależy od konkretnej wersji Wear OS, możesz wgrać obraz oprogramowania na zegarkach, które obsługują połączenie danych przez USB (przewodowe). Na przykład możesz wgrać obraz fabryczny lub pełny obraz OTA na zegarek Google Pixel Watch 3 lub Google Pixel Watch 2.

Otwórz aplikację na zegarku.

1. Kliknij Uruchom > Wybierz urządzenie. Wybierz zegarek połączony z Twoim urządzeniem.
2. Na pasku narzędzi Android Studio kliknij Uruchom . Emulator uruchamia i otwiera aplikację.
3. Po chwili na zegarku powinien pojawić się komunikat „Cześć…”.