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

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

Примечание. Используйте эмулятор Android , чтобы протестировать свое приложение на разных версиях платформы Android и экранах разных размеров. Рассмотрите возможность использования Firebase Test Lab для запуска вашего приложения на самых разных реальных устройствах, размещенных в облачной инфраструктуре.

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

Прежде чем начать отладку на своем устройстве, решите, хотите ли вы подключиться к устройству с помощью 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.

   

   Рис. 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» > «Диспетчер устройств» ). Вы также можете настроить время активации зеркального отображения устройства в его настройках ( Настройки > Инструменты > Зеркальное отображение устройства ).

Примечание. Если вы используете определенные устройства, например Xiaomi Redmi K40, Poco F3 или Mi 11X, с Android 12, вам необходимо включить параметры отладки по USB и отладки по 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

Если Помощник по подключению не обнаруживает ваше устройство через 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 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 не могут быть выполнены, если вы не сможете разблокировать устройство и подтвердить диалог.