Отладка приложения 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
   

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

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

adb -s 127.0.0.1:4444 <command> 

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

adb <command>

Использовать запись экрана для Wear OS

Если вы занимаетесь разработкой на macOS, вы можете использовать инструмент Android проекта GitHub для Mac, чтобы записать видео с устройства Wear OS.

Либо запишите видео с устройства Wear OS, выполнив следующие действия:

1. Запишите необработанные кадры на часы:

   adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

2. Скопируйте необработанный файл на свою машину разработки:

   adb pull /sdcard/video.raw video.raw

3. Используйте ffmpeg для преобразования необработанного файла в MP4:

   ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

   Примечание. Инструкции по загрузке и установке см. на веб-сайте FFmpeg .

Обратитесь к следующим соответствующим ресурсам:

• Мост отладки Android (adb)
• Отладка вашего приложения
• Принципы проектирования
• Захват экранов пользовательского интерфейса Wear