> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/russian-documentation/oblachnye-telefony/connect-to-a-cloud-phone-with-adb.md).

# Подключение к облачному телефону с помощью ADB

Включите ADB для облачного телефона в Cloud Phones → ⋮ → Enable ADB, скопируйте команду adb connect и подключитесь из терминала на вашем компьютере.

Перейдите в **Cloud Phones**, нажмите на значок с тремя точками (⋮) рядом с телефоном и выберите **Enable ADB**. Когда телефон работает, снова нажмите на значок ⋮ и выберите **Copy ADB command**, затем вставьте команду в терминал.

ADB (Android Debug Bridge) — это инструмент командной строки Android для разработчиков. С его помощью вы можете устанавливать приложения, выполнять команды оболочки и подключать инструменты автоматизации Android к облачному телефону, так же как к телефону, подключенному к вашему компьютеру с помощью кабеля. Вам понадобится инструмент `adb` из Android SDK Platform-Tools от Google на вашем компьютере.

### Включение ADB

{% stepper %}
{% step %}

#### Откройте меню телефона

Нажмите **Cloud Phones** в меню слева. Нажмите на значок с тремя точками (⋮) рядом с телефоном, к которому вы хотите подключиться.
{% endstep %}

{% step %}

#### Включите ADB

Нажмите **Enable ADB**. Появится сообщение "ADB успешно включен".

**Enable ADB** доступен, когда телефон включен или выключен. Он недоступен, пока телефон все еще настраивается, запускается, сбрасывается или переключает свою версию Android.
{% endstep %}
{% endstepper %}

ADB остается включенным, когда вы выключаете и снова включаете телефон. Чтобы отключить его, откройте меню ⋮ и нажмите **Disable ADB**. Это также закрывает локальное подключение ADB на вашем компьютере.

### Копирование команды ADB

Телефон должен быть **включен** перед подключением. Сначала включите его, если он выключен.

Есть два способа скопировать команду:

* Нажмите на значок ⋮ рядом с телефоном и выберите **Copy ADB command**.
* Нажмите на столбец **ADB Address** телефона в списке. Он показывает **Copy** до открытия соединения, а затем локальный адрес.

Incogniton копирует команду, такую как `adb connect 127.0.0.1:6555`, в ваш буфер обмена и показывает сообщение, что она была скопирована. **Copy ADB command** появляется только тогда, когда телефон работает и ADB включен.

### Подключение из терминала

Откройте терминал (Command Prompt, PowerShell или Terminal), вставьте команду и нажмите Enter:

```
adb connect 127.0.0.1:6555
```

После того как `adb` сообщит, что подключение установлено, облачный телефон появится в `adb devices`, и вы сможете использовать его как любое другое устройство Android, например `adb shell` или `adb install app.apk`.

### Как работает подключение

Вы никогда не подключаетесь к собственному адресу облачного телефона. Incogniton открывает локальный порт на вашем компьютере, `127.0.0.1:<port>` (порт между 6555 и 6654), и безопасно передает соединение на ваш телефон. Поэтому адрес всегда начинается с `127.0.0.1`.

* Локальный порт остается открытым, пока телефон работает с включенным ADB и Incogniton открыт. Когда вы выключаете телефон, отключаете ADB, сбрасываете телефон или выходите из системы, порт закрывается.
* Адрес работает только на компьютере, где запущен Incogniton. Другие компьютеры не могут его использовать.
* Подключения с другой учетной записи пользователя на том же компьютере отклоняются. Только программы, работающие под вашей собственной учетной записью компьютера, могут использовать порт.
* Каждый раз при запуске телефона копируйте команду снова: номер порта может быть другим.

{% hint style="warning" %}
ADB предоставляет полный контроль над телефоном. Включайте его только тогда, когда это необходимо, и отключайте, когда закончите.
{% endhint %}

### Кто может использовать ADB

В команде включение или отключение ADB и копирование команды ADB требуют разрешения **Manage cloud phones (edit, proxy, reset, Android version, ADB, root, apps, automation, move)** для этого телефона. См. [разрешения команды](https://docs.incogniton.com/documentation/russian-documentation/oblachnye-telefony/manage-cloud-phones.md#team-permissions) для облачных телефонов.

### Когда подключение не работает

* **"ADB access to … was refused. Check that the phone is on and ADB is enabled."** Телефон выключен или ADB был отключен. Включите телефон, убедитесь, что ADB включен, и скопируйте команду снова.
* **"Could not open a local ADB port for …"** Incogniton не смог открыть локальный порт для телефона. Попробуйте снова **Copy ADB command**.
* **"Too many ADB connections are open. Close some and try again."** Отключите устройства, которые вы больше не используете, с помощью `adb disconnect`.
* **"The Incogniton ADB service cannot be reached. adb keeps retrying."** Ваш компьютер не может в данный момент подключиться к службе ADB. Проверьте ваше интернет-соединение; `adb` автоматически переподключается.

Вы также можете получить локальный адрес из скрипта: см. [Управление облачными телефонами из скриптов и AI-клиентов](https://docs.incogniton.com/documentation/russian-documentation/oblachnye-telefony/control-cloud-phones-from-scripts.md).

{% hint style="info" %}
Если у вас есть вопросы о ADB на облачных телефонах, не стесняйтесь обращаться в наш [отдел поддержки](https://incogniton.com/contact/).
{% endhint %}
