Отладка приложения Wear OS

Чтобы отладить приложение Wear OS на физических часах, подключите компьютер для разработки к часам по Wi-Fi или Bluetooth. Если на часах есть USB-порт, подключитесь через USB .

Вы также можете тестировать рабочие процессы, охватывающие несколько устройств, например, часы и телефон, если вашему приложению требуется такая поддержка. Чтобы узнать больше о настройке подключения для тестирования, посетите страницу «Подключение часов к телефону» .

Примечание: если у вас нет физических часов, вы также можете протестировать и запустить свое приложение на эмуляторе в Android Studio.

Обновление до последней версии Wear OS

Чтобы убедиться, что ваше приложение работает ожидаемым образом на последней версии программного обеспечения, убедитесь, что на вашем тестовом устройстве установлена ​​самая последняя версия Wear OS, поддерживаемая вашим устройством.

Чтобы проверить наличие обновления системы на тестовом устройстве, выполните следующие действия:

  1. Подключите устройство к сети Wi-Fi.
  2. Начните заряжать устройство.
  3. Подождите, пока аккумулятор устройства зарядится до 50% или выше.

  4. На тестовом устройстве перейдите в раздел Настройки > Система > Обновления системы .

    Если доступно обновление системы, оно будет загружено и установлено на ваше тестовое устройство.

Установить определенную версию Wear OS (необязательно)

Если тест вашего приложения зависит от определённой версии Wear OS, вы можете установить образ прошивки на часы, поддерживающие USB-подключение. Например, вы можете установить заводской образ или полный OTA-образ на устройства Google Pixel Watch 3 или Google Pixel Watch 2.

Включите параметры разработчика на ваших часах

Прежде чем приступить к отладке на часах, включите режим разработчика. Это нужно сделать только один раз. Режим разработчика остаётся включенным, пока вы его не отключите. Чтобы включить режим разработчика, выполните следующие действия:

  1. Откройте настройки часов.
  2. Нажмите Система > О системе > Версии .
  3. Нажмите на пункт «Номер сборки» семь раз.
  4. Появится сообщение, подтверждающее, что теперь вы разработчик.

Отладка по Wi-Fi

Прежде чем начать, включите параметры разработчика на часах, как описано ранее.

Подключите часы к сети Wi-Fi.

  1. Откройте настройки часов.
  2. Нажмите «Подключение» > «Wi-Fi» .
  3. Выберите сеть и при необходимости введите ее пароль.

    Примечание: Часы и компьютер разработчика должны быть подключены к одной сети. Не все точки доступа подходят. Возможно, вам потребуется использовать точку доступа с правильно настроенным брандмауэром для поддержки adb .

Включить отладку Wi-Fi

  1. Откройте настройки часов.
  2. Нажмите «Параметры разработчика» > «Отладка по Wi-Fi» .
  3. Через мгновение на экране отобразится IP-адрес часов, например, 192.168.1.100 . Он понадобится вам для следующего шага, поэтому запишите его.

Подключите отладчик к часам

  1. На устройстве Wear OS найдите параметры беспроводной отладки в системных настройках. Выберите «Подключить новое устройство» .
  2. Запишите код сопряжения Wi-Fi , а также IP-адрес и порт.
  3. В окне терминала на компьютере разработчика введите следующую команду: 
    adb pair IP_ADDRESS:PORT
  4. При появлении запроса введите код сопряжения Wi-Fi, полученный из шага 2. Терминал выдаст сообщение об успешном сопряжении. Например: 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
После сопряжения хост-компьютер появится в списке сопряженных устройств на экране отладки беспроводных сетей вашего устройства Wear OS.

Подключите отладчик к часам

  1. Подключите часы и машину для разработки к одной сети.

  2. Подключите отладчик к часам, используя IP-адрес часов и номер порта. Например, если IP-адрес — 192.168.1.100 , а номер порта — 5555 , команда adb connect и её ответ будут выглядеть следующим образом: 

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

Теперь часы подключены к отладчику, и вы готовы к отладке. Отправьте команды adb часам с флагом -s , указав IP-адрес часов и номер порта:

adb -s 192.168.1.100:5555 <command>

Если вы не используете эмулятор и для отладки подключено только одно устройство, то адрес указывать не нужно:

adb <command>

Отладка по Bluetooth

Примечание : отладка по Bluetooth работает только для сопряженных с Android часов под управлением Wear OS 2.

Прежде чем начать, выполните сопряжение часов с телефоном и включите режим разработчика на часах, как описано ранее. Убедитесь, что на телефоне включены режим разработчика, открыв меню настроек телефона и найдя раздел «Параметры разработчика» . При необходимости включите режим разработчика на телефоне.

Включите отладку по USB на телефоне

  1. Откройте меню настроек телефона.
  2. Выберите «Параметры разработчика» и включите отладку по USB .

Включите отладку ADB или Bluetooth на часах

  1. Откройте меню настроек часов.
  2. Прокрутите до раздела «Параметры разработчика» .
  3. Убедитесь, что отладка ADB включена.
  4. Включить отладку по Bluetooth .

Включить отладку Bluetooth на телефоне

  1. Откройте на телефоне сопутствующее приложение Wear OS.
  2. Прокрутите до пункта «Дополнительные настройки» и коснитесь его, чтобы просмотреть параметры дополнительных настроек .
  3. Включить отладку по Bluetooth . Под опцией появится следующее сообщение о состоянии: 
    Host: disconnected
Target: connected

На этом этапе машина разработки (хост) не взаимодействует с часами (целью). Вам необходимо установить связь.

Примечание : отладка возможна только с одним устройством одновременно. Если у вас подключено несколько часов, отладка по Bluetooth будет доступна только для устройства, выбранного на главном экране.

Подключите отладчик к часам

На этом последнем этапе вы используете все: отладчик, телефон и часы.

  1. Подключите телефон к компьютеру разработчика с помощью USB-кабеля.
  2. Выполните эти две команды в отладчике: 
    adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444

    Примечание : необходимо использовать IP-адрес 127.0.0.1. Используйте любой доступный порт на компьютере разработчика и один и тот же порт в обеих командах. В данном примере это порт 4444.

  3. После ввода команды подключения часы попросят вас подтвердить, что вы разрешаете отладку ADB .
  4. На телефоне проверьте отображение статуса в приложении-компаньоне Wear OS на предмет следующего: 
    Host: connected
Target: connected

    5. Теперь часы подключены к отладчику, и вы готовы начать отладку.

При отладке часов по Bluetooth adb всегда использует IP-адрес 127.0.0.1 и назначенный вами порт. В этом примере это порт 4444 Все команды adb используют следующий формат:

adb -s 127.0.0.1:4444 <command>

Если вы не используете эмулятор и для отладки подключено только одно устройство, то адрес указывать не нужно: 

adb <command>