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

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

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

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

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

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

    • ChromeOS : Дополнительная настройка не требуется.
    • macOS : Дополнительная настройка не требуется.
    • Windows : Установите драйвер USB для ADB (если применимо). Инструкцию по установке и ссылки на драйверы OEM см. в разделе «Установка драйверов USB OEM» .

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

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

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

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

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

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

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

Перенаправление аудио

При использовании функции зеркального отображения устройств вы можете перенаправлять звук с подключенных физических устройств на динамики компьютера или наушники. Благодаря перенаправлению звука, наушники останутся подключенными к компьютеру, и вы сможете слушать звук как с компьютера, так и с подключенного телефона, не переподключаясь вручную к одному устройству, а затем к другому. Чтобы включить перенаправление звука, перейдите в меню «Файл» ( 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-подключением

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

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

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

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

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

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

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

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

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

  1. Подключите дополнительное устройство к компьютеру.

  2. Если программа Connection Assistant обнаруживает дополнительное устройство, предположите, что проблема связана с основным устройством, и проверьте, настроено ли устройство для разработки .

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

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

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

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

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

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

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

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

  • Ваша рабочая станция и устройство подключены к одной и той же беспроводной сети.
  • На вашем устройстве установлена ​​версия Android 11 или выше. Для получения дополнительной информации см. раздел «Проверка и обновление версии Android» .
  • У вас установлена ​​последняя версия Android Studio. Вы можете скачать её с главной страницы Android Studio .
  • На вашей рабочей станции установлена ​​последняя версия SDK Platform Tools .

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

Ниже приведён список известных на данный момент проблем с беспроводной отладкой в ​​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 не могут быть выполнены, если вы не можете разблокировать устройство и подтвердить сообщение в диалоговом окне.