Запуск приложений на аппаратном устройстве

Всегда тестируйте свое Android-приложение на реальном устройстве, прежде чем выпускать его для пользователей. На этой странице описано, как настроить среду разработки и устройство Android для тестирования и отладки через соединение Android Debug Bridge (ADB).

Настройка устройства для разработки

Прежде чем начать отладку на своем устройстве, решите, хотите ли вы подключиться к устройству с помощью USB-кабеля или Wi-Fi. Затем сделайте следующее:

  1. На устройстве откройте приложение «Настройки» , выберите «Параметры разработчика» , а затем включите отладку по USB (если применимо).

  2. Настройте свою систему на обнаружение вашего устройства.

    • ChromeOS : дополнительная настройка не требуется.
    • macOS : дополнительная настройка не требуется.
    • Windows : установите драйвер USB для ADB (если применимо). Руководство по установке и ссылки на OEM-драйверы см. в разделе Установка OEM-драйверов USB .
    • Ubuntu Linux : настройте следующее:

      • Каждый пользователь, желающий использовать ADB, должен состоять в группе plugdev . Если вы видите сообщение об ошибке, в котором говорится, что вы не входите в группу plugdev , добавьте себя в нее с помощью следующей команды:
      sudo usermod -aG plugdev $LOGNAME
      

      Группы обновляются только при входе в систему, поэтому вам необходимо выйти из системы, чтобы это изменение вступило в силу. Когда вы снова войдете в систему, вы можете использовать id чтобы убедиться, что вы находитесь в группе plugdev .

      • В системе должны быть установлены правила udev , распространяющиеся на устройство. Пакет android-sdk-platform-tools-common содержит поддерживаемый сообществом набор правил udev по умолчанию для устройств Android. Чтобы установить его, используйте следующую команду:
      apt-get install android-sdk-platform-tools-common
      

Подключитесь к устройству с помощью USB

Когда вы настроитесь и подключитесь через USB, нажмите «Выполнить». в Android Studio, чтобы создать и запустить приложение на устройстве.

Вы также можете использовать adb для выдачи команд следующим образом:

  • Убедитесь, что ваше устройство подключено, выполнив команду adb devices из каталога android_sdk /platform-tools/ . Если подключение установлено, вы увидите устройство в списке.
  • Введите любую команду adb с флагом -d , чтобы настроить таргетинг на ваше устройство.

Подключитесь к устройству с помощью Wi-Fi

Android 11 и более поздних версий поддерживает развертывание и отладку вашего приложения по беспроводной сети с вашей рабочей станции через Android Debug Bridge (ADB). Например, вы можете развернуть отлаживаемое приложение на нескольких удаленных устройствах, не подключая его физически через USB и не сталкиваясь с распространенными проблемами USB-подключения, такими как установка драйвера.

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

  1. Убедитесь, что ваша рабочая станция и устройство подключены к одной беспроводной сети.
  2. Убедитесь, что ваше устройство работает под управлением Android 11 или более поздней версии. Дополнительную информацию см. в разделе Проверка и обновление версии Android .
  3. Убедитесь, что у вас установлена ​​последняя версия Android Studio. Загрузите его здесь .
  4. На своей рабочей станции обновите SDK Platform Tools до последней версии.

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

  1. Откройте Android Studio и выберите «Подключить устройства с помощью Wi-Fi» в меню настроек запуска.
    Раскрывающийся список «Выполнить конфигурации»
    Рисунок 1. Меню запуска настроек.

    Появится диалоговое окно «Сопряжение устройств через Wi-Fi» , как показано на рисунке 2.
    Снимок экрана сопряжения устройств во всплывающем окне Wi-Fi.
    Рис. 2. Диалоговое окно для сопряжения устройств с помощью QR-кода или кода сопряжения.
  2. Включите параметры разработчика на вашем устройстве.
  3. Включите отладку по Wi-Fi на вашем устройстве.
    Снимок экрана пиксельного телефона, на котором показаны настройки систем беспроводной отладки.
    Рисунок 3. Параметры отладки беспроводной сети на телефоне Google Pixel.
  4. Нажмите «Беспроводная отладка» и выполните сопряжение устройства:
    1. Чтобы выполнить сопряжение устройства с помощью QR-кода, выберите «Сопряжение устройства с QR-кодом» и отсканируйте QR-код, показанный на рисунке 2.
    2. Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» в диалоговом окне «Сопряжение новых устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» . Появится шестизначный код. Когда ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , введите шестизначный код, указанный на вашем устройстве, и выберите «Сопряжение» .
      Снимок экрана: пример ввода кода сопряжения
      Рисунок 4. Пример ввода шестизначного кода сопряжения.
  5. После сопряжения вы можете попытаться развернуть приложение на своем устройстве.

Чтобы выполнить сопряжение другого устройства или забыть это устройство на рабочей станции:

  1. Перейдите к беспроводной отладке на вашем устройстве.
  2. Коснитесь имени своей рабочей станции в разделе «Сопряженные устройства» .
  3. Выберите Забыть .

Зеркальное отображение устройств

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

Зеркальное отображение устройств всегда доступно, если к компьютеру подключены устройства с включенной отладкой по USB или беспроводной сети. Вы можете запускать и останавливать зеркалирование с помощью окна «Работающие устройства» или диспетчера устройств ( «Просмотр» > «Инструменты Windows» > «Диспетчер устройств» ). Вы также можете настроить время активации зеркального отображения устройства в его настройках ( Настройки > Инструменты > Зеркальное отображение устройства ).

Пользовательский интерфейс запущенных устройств

Перенаправить аудио

Когда вы используете зеркалирование устройств, вы можете перенаправлять звук с подключенных физических устройств на динамики или наушники вашего компьютера. Благодаря перенаправлению звука держите наушники подключенными к компьютеру и слушайте как с компьютера, так и с подключенного телефона без необходимости вручную повторно подключаться к одному устройству, а затем к другому. Чтобы включить перенаправление звука, выберите «Файл» ( Android Studio на macOS) > «Настройки» > «Инструменты» > «Зеркалирование устройств» и выберите «Перенаправить звук с локальных устройств» . Обратите внимание, что звук всегда перенаправляется, независимо от настроек, для устройств Firebase Test Lab под управлением Android 12 или более поздней версии.

Известные проблемы

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

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

Уведомление о конфиденциальности

В зависимости от настроек зеркального отображения устройства Android Studio может автоматически запускать зеркальное отображение любого подключенного и сопряженного устройства. Это может привести к раскрытию информации об устройствах, подключенных с помощью команды adb tcpip поскольку информация и команды зеркалирования передаются по незашифрованному каналу. Кроме того, Android Studio использует незашифрованный канал для связи с сервером adb, поэтому информация зеркалирования может быть перехвачена другими пользователями на вашем хост-компьютере.

Устранение неполадок с подключением устройства

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

Устранение неполадок с помощью Помощника по подключению

Помощник по подключению предоставляет пошаговые инструкции, которые помогут вам настроить и использовать устройство через соединение ADB.

Чтобы запустить помощник, выберите «Инструменты» > «Устранение неполадок с подключениями устройств» .

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

  • Подключите устройство через USB : Ассистент подключения сначала предложит вам подключить устройство через USB и предоставит кнопку «Повторное сканирование USB-устройств» , с помощью которой вы можете начать новое сканирование подключенных устройств.
  • Включить отладку по USB . Ассистент подключения сообщит вам, как включить отладку по USB в настройках разработчика на устройстве.
  • Перезапустите сервер ADB . Если вы по-прежнему не видите свое устройство в списке доступных устройств, используйте кнопку «Перезапустить сервер ADB» на последней странице Помощника по подключению. Перезапуск сервера ADB также заставляет ADB снова сканировать устройства. Если вы по-прежнему не видите свое устройство в списке доступных устройств, попробуйте выполнить действия по устранению неполадок, описанные в следующем разделе.

Решение проблем с подключением USB

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

Убедитесь, что Android Studio подключается к эмулятору Android.

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

  1. Откройте Диспетчер устройств .
  2. Создайте новый AVD, если у вас его еще нет.
  3. Запустите эмулятор, используя AVD.
  4. Выполните одно из следующих действий:
    • Если Android Studio не может подключиться к эмулятору, загрузите последнюю версию инструментов платформы SDK и повторите попытку.
    • Если эмулятор запускается успешно, проверьте USB-кабель, как описано в следующем разделе.

Проверьте USB-кабель

Чтобы проверить, не связана ли проблема с неисправным USB-кабелем, выполните действия, описанные в этом разделе.

Если у вас есть другой USB-кабель:

  1. Подключите устройство с помощью вторичного кабеля.
  2. Проверьте, может ли теперь Помощник по подключению обнаружить устройство.
  3. Если устройство не обнаружено, попробуйте еще раз использовать основной кабель.
  4. Если устройство по-прежнему не обнаружено, предположим, что проблема связана с устройством, и проверьте, настроено ли устройство для разработки , как описано в следующем разделе.

Если у вас нет другого USB-кабеля, но есть другое устройство Android:

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

    Если дополнительное устройство не обнаружено, возможно, проблема связана с USB-кабелем.

Проверьте, настроено ли устройство для разработки

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

  1. Выполните действия, описанные в разделе «Настройка устройства для разработки» .
  2. Если это не решит проблему, обратитесь за помощью в службу поддержки OEM-производителя устройства. Сообщите представителю службы поддержки, что устройство не подключается к Android Studio с помощью ADB.

Решение проблем с беспроводным подключением

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

Проверьте, соответствуют ли ваша рабочая станция и устройство предварительным требованиям.

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

Проверьте наличие других известных проблем

Ниже приведен список текущих известных проблем с беспроводной отладкой в ​​Android Studio и способы их решения:

  • Wi-Fi не подключается . Некоторые сети Wi-Fi, например корпоративные сети Wi-Fi, могут блокировать p2p-соединения и не позволять вам подключаться через Wi-Fi. Попробуйте подключиться с помощью кабеля или другой сети Wi-Fi.
  • ADB через Wi-Fi иногда автоматически отключается . Это может произойти, если устройство переключает сети Wi-Fi или отключается от сети.

Ключ безопасности RSA

Когда вы подключаете к компьютеру устройство под управлением Android 4.2.2 (уровень API 17) или выше, система отображает диалоговое окно с вопросом, принять ли ключ RSA, позволяющий отладку через этот компьютер. Этот механизм безопасности защищает пользовательские устройства, поскольку отладка USB и другие команды adb не могут быть выполнены, если вы не сможете разблокировать устройство и подтвердить диалог.