Tworzenie i uruchamianie 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 File > New > New Project (Plik > Nowy > Nowy projekt). Pojawi się okno Nowy projekt.
  2. W panelu Szablony kliknij 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 utworzy początkową wersję projektu.

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

    • Android 15.0 („VanillaIceCream”) (API na poziomie 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”) (API na poziomie 34), który zawiera obraz systemu Wear OS 5 ARM 64 v8a i obraz systemu Wear OS 5 Intel x86 Atom_64.
    • Androida 13.0 („Tiramisu”) (API na poziomie 33), który obejmuje obraz systemu Wear OS 4 ARM 64 v8a i obraz systemu Wear OS 4 Intel x86 Atom_64.

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

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

Uruchamianie aplikacji w emulatorze

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

Konfigurowanie emulatora

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

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

    Uwaga: obrazy systemu dla emulatora Wear OS zawierają informacje o plikach i kodzie źródłowym innych firm. Informacje o oprogramowaniu innych firm w przypadku konkretnego obrazu systemu możesz wyświetlić, otwierając plik NOTICE.txt, który znajduje 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ści domyślne wszystkich ustawień na tym ekranie, chyba że chcesz dostosować emulator. Kliknij Zakończ.

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

Otwieranie aplikacji w emulatorze

  1. Kliknij Uruchom > Wybierz urządzenie. Wybierz utworzony emulator.
  2. Na pasku narzędzi Android Studio kliknij Uruchom . Emulator uruchomi się i otworzy Twoją aplikację.
  3. Po chwili w emulatorze powinien pojawić się komunikat „Hello...”.

Testowanie dźwięku Bluetooth za pomocą emulatora

Na obrazach systemu z Wear OS 4 lub nowszym emulator obsługuje emulowany Bluetooth, który umożliwia testowanie dźwięku Bluetooth w różnych przypadkach użycia.

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

Obrazy systemu emulatora 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 (który nie jest napisany w językach programowania Kotlin ani Java), sprawdź, czy zawiera biblioteki natywne 32-bitowe i 64-bitowe.

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

Uruchamianie aplikacji na fizycznym zegarku (opcjonalnie)

Uruchamianie i debugowanie aplikacji na prawdziwym 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ź opcję Numer kompilacji i kliknij ją 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.

Łą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

Połącz zegarek, wykonując 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 zegarek nie ma portu USB, dowiedz się, jak połączyć go przez Wi-Fi lub Bluetooth.

Instalowanie konkretnej wersji Wear OS (opcjonalnie)

Jeśli przypadek testowy aplikacji zależy od konkretnej wersji Wear OS, możesz wgrać obraz oprogramowania na zegarki obsługujące przewodowe połączenie USB. 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 urządzeniem.
  2. Na pasku narzędzi Android Studio kliknij Uruchom . Emulator uruchomi się i otworzy Twoją aplikację.
  3. Po chwili na zegarku powinien pojawić się komunikat „Hello...”.