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

Всегда тестируйте свое 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. Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» в диалоговом окне «Сопряжение новых устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» . Появится шестизначный код. Когда ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , введите шестизначный код, указанный на вашем устройстве, и выберите «Сопряжение» .

      

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

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

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

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

Вы можете отразить свое физическое устройство в окне «Работающие устройства» в 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, выполните следующие действия:

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

,

Всегда тестируйте свое 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. Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» в диалоговом окне «Сопряжение новых устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» . Появится шестизначный код. Когда ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , введите шестизначный код, указанный на вашем устройстве, и выберите «Сопряжение» .

      

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

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

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

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

Вы можете отразить свое физическое устройство в окне «Работающие устройства» в 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, выполните следующие действия:

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

,

Всегда тестируйте свое 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. Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» в диалоговом окне «Сопряжение новых устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» . Появится шестизначный код. Когда ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , введите шестизначный код, указанный на вашем устройстве, и выберите «Подключиться» .

      

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

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

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

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

Вы можете отразить свое физическое устройство в окне «Работающие устройства» в 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, выполните следующие действия:

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 Security Key

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

,

Всегда тестируйте свое приложение для Android на реальном устройстве, прежде чем выпустить его пользователям. На этой странице описывается, как настроить вашу среду разработки и устройство Android для тестирования и отладки под соединением Bridge Debug Debug (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/ Directory. При подключении вы увидите указанное устройство.
• Выполните любую команду adb с флагом -d для нацеливания на ваше устройство.

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

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

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

1. Убедитесь, что ваша рабочая станция и устройство подключены к одной и той же беспроводной сети.
2. Убедитесь, что ваше устройство работает Android 11 или выше. Для получения дополнительной информации см. Проверьте и обновите версию Android .
3. Убедитесь, что у вас есть последняя версия Android Studio. Загрузите его здесь .
4. На вашей рабочей станции обновите последнюю версию инструментов платформы SDK .

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

1. Откройте Android Studio и выберите парные устройства, используя Wi-Fi из меню Configurations.

   

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

   

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

   

4. Коснитесь беспроводной отладки и соедините свое устройство:
   1. Чтобы соединить свое устройство с QR -кодом, выберите «Пару» с QR -кодом и сканируйте QR -код, показанный на рисунке 2.
   2. Чтобы сочетать ваше устройство с кодом спаривания, выберите «Парное устройство» с кодом спаривания из пары новых устройств через диалог Wi-Fi . На вашем устройстве выберите пару, используя код спаривания . Появляется шестизначный код. Как только ваше устройство появляется на паре устройствах через окно Wi-Fi , введите шестизначный код, показанный на вашем устройстве, и выберите Pare .

      

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

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

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

Устройство зеркалирования

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

Зеркалирование устройства всегда доступно, когда к компьютеру подключены устройства, которые имеют USB или беспроводную отладку. Вы можете запустить и остановить зеркальное зеркальное зеркальное оборудование, используя окно Hung Devices или диспетчер устройств ( View> Tool Windows> Device Manager ). Вы также можете настроить, когда зеркалирование устройства активируется в его настройках ( Настройки> Инструменты> Зеркальное зеркальное устройство ).

Перенаправить аудио

Когда вы используете зеркалирование устройства, вы можете перенаправить звук из подключенных физических устройств на динамики компьютера или наушники. С помощью перенаправления аудио, держите наушники подключенными к компьютеру и прослушайте как компьютер, так и подключенный телефон, не подключаясь к одному устройству вручную, а затем другое. Чтобы включить перенаправление звука, перейдите в файл ( Android Studio на MacOS)> Настройки > Инструменты > Зеркалирование устройства и выберите перенаправление аудио с локальных устройств . Обратите внимание, что аудио всегда перенаправляется, независимо от настройки, для устройств для испытательных лабораторий Firebase, работающих на Android 12 или выше.

Известные проблемы

Некоторые устройства могут быть не способны кодировать в битрейте, достаточном для поддержки зеркалирования устройства. В этих ситуациях вы можете увидеть ошибку в окне Hung Devices , а также журналы, аналогичные следующим.

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 : подключение Assistant сначала побуждает вас подключить устройство к USB и предоставляет кнопку Rescan USB -устройства , где вы можете запустить новое сканирование для подключенных устройств.
• Включить отладку USB : ассистент подключения сообщает вам, как включить USB-отладку в вариантах разработчика на устройствах.
• Перезагрузите сервер ADB : если вы все еще не видите свое устройство в списке доступных устройств, используйте кнопку перезагрузки ADB Server на последней странице помощника подключения. Перезапуск сервера 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 Security Key

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