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

Перед публикацией приложения для 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, нажмите Run (Запустить) в Android Studio, чтобы собрать и запустить приложение на устройстве.

Вы также можете использовать adb для выполнения команд, как описано ниже.

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

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

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

В Android 17 и adb 37.0.0 появилась функция adb Wi-Fi 2.0, которая решает многие проблемы с удобством использования предыдущей версии. В частности, устройство будет автоматически подключаться к рабочей станции, когда оно подключается к доверенной сети беспроводной отладки.

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

  1. Убедитесь, что рабочая станция и устройство подключены к одной беспроводной сети.
  2. Убедитесь, что на устройстве установлена ОС Android 11 или более поздней версии. Подробнее о том, как проверить и обновить версию Android…
  3. Убедитесь, что у вас установлена последняя версия Android Studio. Скачать
  4. Обновите SDK Platform Tools на рабочей станции до последней версии.

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

  1. Включите Для разработчиков на устройстве.
  2. На своем устройстве нажмите "Отладка по Wi-Fi".

    Телефон Pixel с запросом на отладку по Wi-Fi.
    Рисунок 1. Беспроводная отладка на телефоне Google Pixel.

  3. Разрешите отладку по Wi-Fi в сети. Если установить флажок Всегда разрешать в этой сети, сеть станет доверенной для беспроводной отладки. Беспроводная отладка будет разрешена всегда, когда устройство подключено к этой сети.

    Телефон Pixel, на котором открыт раздел настроек "Отладка по Wi-Fi".
    Рисунок 2. Настройка Отладка по Wi-Fi на телефоне Google Pixel.

  4. Откройте Android Studio и в меню конфигураций запуска выберите Pair Devices Using Wi-Fi (Подключить устройства по Wi-Fi).

    Раскрывающийся список конфигураций запуска
    Рисунок 3. Run configurations (Запустить конфигурации).

  5. Появится диалоговое окно Подключить устройства по Wi-Fi, как показано на рисунке 4.

    Всплывающее окно "Подключение устройств по Wi-Fi"
    Рисунок 4. Диалоговое окно для подключения устройств по Wi-Fi.

    Вы также можете подключить устройство в Диспетчере устройств. Пример: My Pixel.

    Диспетчер устройств с устройством, доступным для подключения по Wi-Fi
    Рисунок 5. Диспетчер устройств с устройством, доступным для подключения по Wi-Fi.

  6. Нажмите Pair рядом с устройством, которое нужно подключить. Появится диалоговое окно подключения устройств.

    1. Чтобы подключить устройство с помощью QR-кода, выберите Подключить устройство с помощью QR-кода и отсканируйте QR-код.
      Всплывающее окно "Подключение устройств по Wi-Fi"
      Рисунок 6. Диалоговое окно для подключения устройства с помощью QR-кода.
    2. Чтобы подключить устройство с помощью кода, в диалоговом окне Подключить новые устройства по Wi-Fi выберите Подключить устройство с помощью кода. На устройстве выберите Подключить с помощью кода подключения. Появится шестизначный код. Когда устройство появится в окне Подключение устройств по Wi-Fi, введите шестизначный код, показанный на устройстве, и выберите Подключить.
      Пример ввода кода подключения
      Рисунок 7. Пример ввода шестизначного кода подключения.
  7. После этого вы можете попробовать развернуть приложение на устройстве.

Чтобы отключить рабочую станцию, перейдите в раздел Отладка по Wi-Fi на устройстве. В разделе Подключенные устройства нажмите на название рабочей станции и выберите Удалить. Вы также можете нажать Отозвать доступ для отладки с помощью ADB на странице настроек устройства, чтобы отключить рабочую станцию и все другие ранее подключенные рабочие станции.

Дублирование экрана устройства

Вы можете дублировать экран физического устройства в окне Активные устройства в Android Studio. Транслируя экран устройства непосредственно в Android Studio, вы можете использовать IDE Studio для выполнения распространенных действий, таких как запуск приложений и взаимодействие с ними, поворот экрана, складывание и раскладывание телефона, а также изменение громкости.

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

Дублирование экрана устройства в окне "Активные устройства" в Android Studio
Рисунок 8. интерфейс Running Devices.

Аудиокреатив с переадресацией

При дублировании экрана устройства вы можете перенаправить аудио с подключенных физических устройств на динамики или наушники компьютера. Благодаря перенаправлению аудио вы можете подключить наушники к компьютеру и слушать аудио с компьютера и подключенного телефона, не переключаясь между устройствами вручную. Чтобы включить перенаправление аудио, выберите File (Файл) (Android Studio в macOS) > Settings (Настройки) > Tools (Инструменты) > Device Mirroring (Дублирование экрана устройства) и нажмите Redirect audio from local devices (Перенаправлять аудио с локальных устройств). Обратите внимание, что на устройствах 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, попробуйте выполнить следующие действия:

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

В Connection Assistant есть пошаговые инструкции по настройке и использованию устройства через ADB.

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

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

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

Как устранить неполадки с USB-подключением

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Убедитесь, что рабочая станция и устройство соответствуют требованиям.

Ознакомьтесь с руководством по устранению неполадок с adb

Следуйте руководству по устранению неполадок с adb.

Электронный ключ RSA

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