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

Всегда тестируйте свое приложение 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» в меню конфигураций запуска.

   

   
   
   Появится диалоговое окно « Сопряжение устройств по Wi-Fi» , как показано на рисунке 2.

   

2. Включите параметры разработчика на вашем устройстве.
3. Включите отладку по Wi-Fi на вашем устройстве.

   

4. Нажмите «Беспроводная отладка» и подключите свое устройство:
   1. Чтобы связать устройство с QR-кодом, выберите «Связать устройство с QR-кодом» и отсканируйте QR-код, показанный на рисунке 2.
   2. Чтобы подключить устройство с помощью кода сопряжения, выберите Pair device with pairing code в диалоговом окне Pair new devices over Wi-Fi . На устройстве выберите Pair using pairing code . Появится шестизначный код. Когда ваше устройство появится в окне Pair devices over Wi-Fi , введите шестизначный код, показанный на вашем устройстве, и выберите Pair .

      

5. После сопряжения вы можете попытаться развернуть приложение на своем устройстве.

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

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

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

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

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

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

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

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

Connection Assistant предоставляет инструкции, элементы управления в контексте и список подключенных устройств в серии страниц на панели Assistant . Используйте кнопки Next и Previous в нижней части панели Assistant для работы со страницами по мере необходимости:

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

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

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

Проверьте, что Android Studio подключается к Android Emulator.

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

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