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 dopiero zaczynasz przygodę 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 w panelu głównym kliknij Pusta aplikacja na Wear.
3. Nazwij projekt i kliknij Zakończ. Android Studio pobiera niezbędne zależności i tworzy wstępną wersję projektu.

4. Kliknij Narzędzia > Menedżer pakietu SDK i zainstaluj oba te pakiety:

   • 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 interfejsu API 33): obraz systemowy Wear OS 4 ARM 64 v8a i obraz systemu Atom_64 z Wear OS 4 Intel x86.
   Uwaga: najnowsza stabilna wersja Wear OS, Wear OS 5, jest oparta na Androidzie 14.

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

Teraz możesz uruchomić swoją 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 telefony, co zapewnia użytkownikom największą elastyczność. 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 w 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 potrzeby Chin.

Konfigurowanie emulatora

Aby skonfigurować emulator w Android Studio:

1. W Menedżerze pakietów SDK otwórz kartę Narzędzia pakietu SDK. Upewnij się, że 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 systemowe 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 w przypadku emulatorów używanych poza Chinami.
   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI w przypadku emulatorów używanych w Chinach.

6. Możesz zachować wartość domyślną wszystkich ustawień na tym ekranie, 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 przed chwilą 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 systemu z Wear OS 4 lub nowszym emulator obsługuje emulowany Bluetooth, który pozwala przetestować dźwięk Bluetooth w różnych przypadkach użycia.

Ostatnie obrazy systemu obsługują tylko architektury 64-bitowe

Obrazy systemu emulatora na potrzeby 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 korzysta z kodu natywnego (nie napisanego w języku programowania Kotlin ani Java), sprawdź, czy zawiera ona zarówno 32-bitowe, jak i 64-bitowe biblioteki natywne.

Dowiedz się więcej o obsłudze 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 zegarku fizycznym, przygotuj urządzenie do testów, a potem podłącz je do komputera, którego używasz do programowania.

Przygotowanie zegarka do testowania

Aby przygotować zegarek do testów, 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ź 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

Połącz zegarek, wykonując te czynności:

1. Podłącz zegarek do komputera programistycznego za pomocą kabla USB.
2. Na zegarku włącz 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 urządzeniu 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 wyświetlić się komunikat „Cześć…”.