> 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/spanish/telefonos-en-la-nube/connect-to-a-cloud-phone-with-adb.md).

# Conectar a un teléfono en la nube con ADB

Activa ADB para un teléfono en la nube en Teléfonos en la Nube → ⋮ → Habilitar ADB, copia el comando de conexión adb y conéctate desde un terminal en tu computadora.

Ve a **Teléfonos en la Nube**, haz clic en el icono de tres puntos (⋮) junto al teléfono y haz clic en **Habilitar ADB**. Cuando el teléfono esté funcionando, haz clic nuevamente en el icono ⋮ y haz clic en **Copiar comando ADB**, luego pega el comando en un terminal.

ADB (Android Debug Bridge) es la herramienta de línea de comandos de Android para desarrolladores. Con ella puedes instalar aplicaciones, ejecutar comandos de shell y conectar herramientas de automatización de Android a un teléfono en la nube, tal como un teléfono conectado a tu computadora con un cable. Necesitas la herramienta `adb` del SDK de Android de Google en tu computadora.

### Activar ADB

{% stepper %}
{% step %}

#### Abrir el menú del teléfono

Haz clic en **Teléfonos en la Nube** en el menú lateral izquierdo. Haz clic en el icono de tres puntos (⋮) junto al teléfono al que deseas conectarte.
{% endstep %}

{% step %}

#### Habilitar ADB

Haz clic en **Habilitar ADB**. Un mensaje confirma "ADB habilitado exitosamente".

**Habilitar ADB** se ofrece cuando el teléfono está encendido o apagado. No se ofrece mientras el teléfono aún se está configurando, iniciando, reiniciando o cambiando su versión de Android.
{% endstep %}
{% endstepper %}

ADB permanece activado cuando apagas y enciendes el teléfono nuevamente. Para desactivarlo, abre el menú ⋮ y haz clic en **Desactivar ADB**. Esto también cierra la conexión ADB local en tu computadora.

### Copiar el comando ADB

El teléfono debe estar **funcionando** antes de que puedas conectarte. Enciéndelo primero si está apagado.

Hay dos maneras de copiar el comando:

* Haz clic en el icono ⋮ junto al teléfono y haz clic en **Copiar comando ADB**.
* Haz clic en la columna **Dirección ADB** del teléfono en la lista. Muestra **Copiar** hasta que se abra una conexión, y la dirección local después de eso.

Incogniton copia un comando como `adb connect 127.0.0.1:6555` en tu portapapeles y muestra un mensaje de que fue copiado. **Copiar comando ADB** solo aparece cuando el teléfono está funcionando y ADB está habilitado.

### Conectar desde un terminal

Abre un terminal (Símbolo del sistema, PowerShell o Terminal), pega el comando y presiona Enter:

```
adb connect 127.0.0.1:6555
```

Después de que `adb` informa que está conectado, el teléfono en la nube aparece en `adb devices` y puedes usarlo como cualquier otro dispositivo Android, por ejemplo `adb shell` o `adb install app.apk`.

### Cómo funciona la conexión

Nunca te conectas a la dirección propia del teléfono en la nube. Incogniton abre un puerto local en tu computadora, `127.0.0.1:<puerto>` (un puerto entre 6555 y 6654), y retransmite la conexión de forma segura a tu teléfono. Por eso la dirección siempre comienza con `127.0.0.1`.

* El puerto local permanece abierto mientras el teléfono esté funcionando con ADB habilitado y Incogniton esté abierto. Cuando apagas el teléfono, desactivas ADB, reinicias el teléfono o cierras sesión, el puerto se cierra.
* La dirección solo funciona en la computadora donde Incogniton está ejecutándose. Otras computadoras no pueden usarla.
* Las conexiones desde otra cuenta de usuario en la misma computadora son rechazadas. Solo los programas que se ejecutan bajo tu propia cuenta de computadora pueden usar el puerto.
* Cada vez que el teléfono se inicia, copia el comando nuevamente: el número de puerto puede ser diferente.

{% hint style="warning" %}
ADB da control total sobre el teléfono. Solo habilítalo cuando lo necesites y desactívalo cuando hayas terminado.
{% endhint %}

### Quién puede usar ADB

En un equipo, activar o desactivar ADB y copiar el comando ADB requiere el permiso **Gestionar teléfonos en la nube (editar, proxy, reiniciar, versión de Android, ADB, root, aplicaciones, automatización, mover)** para ese teléfono. Consulta los [permisos del equipo](https://docs.incogniton.com/documentation/spanish/telefonos-en-la-nube/manage-cloud-phones.md#team-permissions) para teléfonos en la nube.

### Cuando la conexión no funciona

* **"Se rechazó el acceso ADB a … Verifica que el teléfono esté encendido y ADB esté habilitado."** El teléfono está apagado o ADB fue desactivado. Enciende el teléfono, verifica que ADB esté habilitado y copia el comando nuevamente.
* **"No se pudo abrir un puerto ADB local para …"** Incogniton no pudo abrir un puerto local para el teléfono. Intenta **Copiar comando ADB** nuevamente.
* **"Demasiadas conexiones ADB están abiertas. Cierra algunas y vuelve a intentarlo."** Desconecta dispositivos que ya no usas con `adb disconnect`.
* **"No se puede alcanzar el servicio ADB de Incogniton. adb sigue intentando."** Tu computadora no puede alcanzar el servicio ADB en este momento. Verifica tu conexión a internet; `adb` se reconecta por sí solo.

También puedes obtener la dirección local desde un script: consulta [Controlar teléfonos en la nube desde scripts y clientes de IA](https://docs.incogniton.com/documentation/spanish/telefonos-en-la-nube/control-cloud-phones-from-scripts.md).

{% hint style="info" %}
Si tienes alguna pregunta sobre ADB en teléfonos en la nube, no dudes en contactar a nuestro [departamento de soporte](https://incogniton.com/contact/).
{% endhint %}
