Всегда тестируйте свое Android-приложение на реальном устройстве, прежде чем выпускать его для пользователей. На этой странице описано, как настроить среду разработки и устройство Android для тестирования и отладки через соединение Android Debug Bridge (ADB).
Настройка устройства для разработки
Прежде чем начать отладку на своем устройстве, решите, хотите ли вы подключиться к устройству с помощью USB-кабеля или Wi-Fi. Затем сделайте следующее:
На устройстве откройте приложение «Настройки» , выберите «Параметры разработчика» , а затем включите отладку по USB (если применимо).
Настройте свою систему на обнаружение вашего устройства.
- 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
- Каждый пользователь, желающий использовать ADB, должен состоять в группе
Подключитесь к устройству с помощью USB
Когда вы настроитесь и подключитесь через USB, нажмите « Выполнить» . в Android Studio, чтобы создать и запустить приложение на устройстве.
Вы также можете использовать adb
для выдачи команд следующим образом:
- Убедитесь, что ваше устройство подключено, выполнив команду
adb devices
из каталогаandroid_sdk /platform-tools/
. Если подключение установлено, вы увидите устройство в списке. - Введите любую команду
adb
с флагом-d
, чтобы настроить таргетинг на ваше устройство.
Подключитесь к устройству с помощью Wi-Fi
Android 11 и более поздних версий поддерживает развертывание и отладку вашего приложения по беспроводной сети с вашей рабочей станции через Android Debug Bridge (ADB). Например, вы можете развернуть отлаживаемое приложение на нескольких удаленных устройствах, не подключая его физически через USB и не сталкиваясь с распространенными проблемами USB-подключения, такими как установка драйвера.
Чтобы использовать беспроводную отладку, необходимо выполнить сопряжение устройства с рабочей станцией с помощью кода сопряжения. Для начала выполните следующие шаги:
- Убедитесь, что ваша рабочая станция и устройство подключены к одной беспроводной сети.
- Убедитесь, что ваше устройство работает под управлением Android 11 или более поздней версии. Дополнительную информацию см. в разделе Проверка и обновление версии Android .
- Убедитесь, что у вас установлена последняя версия Android Studio. Загрузите его здесь .
- На своей рабочей станции обновите SDK Platform Tools до последней версии.
Чтобы подключиться к вашему устройству, выполните следующие действия:
- Откройте Android Studio и выберите «Подключить устройства с помощью Wi-Fi» в меню настроек запуска. Появится диалоговое окно «Сопряжение устройств через Wi-Fi» , как показано на рисунке 2.
Рисунок 1. Меню запуска настроек. Рис. 2. Диалоговое окно для сопряжения устройств с помощью QR-кода или кода сопряжения. - Включите параметры разработчика на вашем устройстве.
- Включите отладку по Wi-Fi на вашем устройстве.
Рисунок 3. Параметры отладки беспроводной сети на телефоне Google Pixel. - Нажмите «Беспроводная отладка» и выполните сопряжение устройства:
- Чтобы выполнить сопряжение устройства с помощью QR-кода, выберите «Сопряжение устройства с QR-кодом» и отсканируйте QR-код, показанный на рисунке 2.
- Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» в диалоговом окне «Сопряжение новых устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» . Появится шестизначный код. Когда ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , введите шестизначный код, указанный на вашем устройстве, и выберите «Сопряжение» .
Рисунок 4. Пример ввода шестизначного кода сопряжения.
- После сопряжения вы можете попытаться развернуть приложение на своем устройстве.
Чтобы выполнить сопряжение другого устройства или забыть это устройство на рабочей станции:
- Перейдите к беспроводной отладке на вашем устройстве.
- Коснитесь имени своей рабочей станции в разделе «Сопряженные устройства» .
- Выберите Забыть .
Зеркальное отображение устройств
Вы можете отразить свое физическое устройство в окне «Работающие устройства» в 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, выполните следующие действия:
- Откройте Диспетчер устройств .
- Создайте новый AVD, если у вас его еще нет.
- Запустите эмулятор, используя AVD.
- Выполните одно из следующих действий:
- Если Android Studio не может подключиться к эмулятору, загрузите последнюю версию инструментов платформы SDK и повторите попытку.
- Если эмулятор запускается успешно, проверьте USB-кабель, как описано в следующем разделе.
Проверьте USB-кабель
Чтобы проверить, не связана ли проблема с неисправным USB-кабелем, выполните действия, описанные в этом разделе.
Если у вас есть другой USB-кабель:
- Подключите устройство с помощью вторичного кабеля.
- Проверьте, может ли теперь Помощник по подключению обнаружить устройство.
- Если устройство не обнаружено, попробуйте еще раз использовать основной кабель.
- Если устройство по-прежнему не обнаружено, предположим, что проблема связана с устройством, и проверьте, настроено ли устройство для разработки, как описано в следующем разделе.
Если у вас нет другого USB-кабеля, но есть другое устройство Android:
- Подключите дополнительное устройство к компьютеру.
Если Помощник по подключению может обнаружить дополнительное устройство, предположим, что проблема связана с основным устройством, и проверьте, настроено ли устройство для разработки .
Если вторичное устройство не обнаружено, возможно, проблема связана с USB-кабелем.
Проверьте, настроено ли устройство для разработки
Чтобы проверить, вызвана ли проблема настройками устройства, выполните следующие действия:
- Выполните действия, описанные в разделе «Настройка устройства для разработки» .
- Если это не решит проблему, обратитесь за помощью в службу поддержки OEM-производителя устройства. Сообщите представителю службы поддержки, что устройство не подключается к Android Studio с помощью ADB.
Решение проблем с беспроводным подключением
Если у вас возникли проблемы с беспроводным подключением к вашему устройству, вы можете попробовать следующие шаги по устранению неполадок, чтобы решить эту проблему:
Проверьте, соответствуют ли ваша рабочая станция и устройство предварительным требованиям.
Чтобы выполнить предварительные условия для беспроводной отладки, убедитесь, что:
- Ваша рабочая станция и устройство подключены к одной беспроводной сети.
- Ваше устройство работает под управлением Android 11 или более поздней версии. Дополнительную информацию см. в разделе Проверка и обновление версии Android .
- У вас установлена последняя версия Android Studio. Скачать его можно с главной страницы Android Studio .
- На вашей рабочей станции установлена последняя версия инструментов платформы SDK .
Проверьте наличие других известных проблем
Ниже приведен список текущих известных проблем с беспроводной отладкой в 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
не могут быть выполнены, если вы не сможете разблокировать устройство и подтвердить диалог.