> 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/pt-br-documentation/telefones-na-nuvem/connect-to-a-cloud-phone-with-adb.md).

# Conectar a um telefone na nuvem com ADB

Ative o ADB para um telefone em nuvem em Cloud Phones → ⋮ → Enable ADB, copie o comando adb connect e conecte-se a partir de um terminal no seu computador.

Vá para **Cloud Phones**, clique no ícone de três pontos (⋮) ao lado do telefone e clique em **Enable ADB**. Quando o telefone estiver em execução, clique novamente no ícone ⋮ e clique em **Copy ADB command**, depois cole o comando em um terminal.

ADB (Android Debug Bridge) é a ferramenta de linha de comando do Android para desenvolvedores. Com ele, você pode instalar aplicativos, executar comandos de shell e conectar ferramentas de automação Android a um telefone em nuvem, assim como um telefone conectado ao seu computador com um cabo. Você precisa da ferramenta `adb` do Android SDK Platform-Tools do Google no seu computador.

### Ativar o ADB

{% stepper %}
{% step %}

#### Abra o menu do telefone

Clique em **Cloud Phones** no menu à esquerda. Clique no ícone de três pontos (⋮) ao lado do telefone que você deseja conectar.
{% endstep %}

{% step %}

#### Ativar ADB

Clique em **Enable ADB**. Uma mensagem confirma "ADB successfully enabled".

**Enable ADB** é oferecido quando o telefone está ligado ou desligado. Não é oferecido enquanto o telefone ainda está sendo configurado, iniciando, reiniciando ou trocando sua versão do Android.
{% endstep %}
{% endstepper %}

O ADB permanece ativado quando você desliga e liga o telefone novamente. Para desativá-lo, abra o menu ⋮ e clique em **Disable ADB**. Isso também fecha a conexão ADB local no seu computador.

### Copiar o comando ADB

O telefone deve estar **em execução** antes que você possa se conectar. Ligue-o primeiro se estiver desligado.

Existem duas maneiras de copiar o comando:

* Clique no ícone ⋮ ao lado do telefone e clique em **Copy ADB command**.
* Clique na coluna **ADB Address** do telefone na lista. Ela mostra **Copy** até que uma conexão seja aberta, e o endereço local depois disso.

O Incogniton copia um comando como `adb connect 127.0.0.1:6555` para sua área de transferência e mostra uma mensagem de que foi copiado. **Copy ADB command** só aparece quando o telefone está em execução e o ADB está ativado.

### Conectar a partir de um terminal

Abra um terminal (Prompt de Comando, PowerShell ou Terminal), cole o comando e pressione Enter:

```
adb connect 127.0.0.1:6555
```

Após o `adb` relatar que está conectado, o telefone em nuvem aparece em `adb devices` e você pode usá-lo como qualquer outro dispositivo Android, por exemplo, `adb shell` ou `adb install app.apk`.

### Como a conexão funciona

Você nunca se conecta ao próprio endereço do telefone em nuvem. O Incogniton abre uma porta local no seu computador, `127.0.0.1:<port>` (uma porta entre 6555 e 6654), e retransmite a conexão de forma segura para o seu telefone. É por isso que o endereço sempre começa com `127.0.0.1`.

* A porta local permanece aberta enquanto o telefone estiver em execução com o ADB ativado e o Incogniton estiver aberto. Quando você desliga o telefone, desativa o ADB, reinicia o telefone ou faz logout, a porta fecha.
* O endereço só funciona no computador onde o Incogniton está em execução. Outros computadores não podem usá-lo.
* Conexões de outra conta de usuário no mesmo computador são recusadas. Apenas programas que rodam sob sua própria conta de computador podem usar a porta.
* Cada vez que o telefone inicia, copie o comando novamente: o número da porta pode ser diferente.

{% hint style="warning" %}
O ADB dá controle total sobre o telefone. Ative-o apenas quando necessário e desative-o quando terminar.
{% endhint %}

### Quem pode usar o ADB

Em uma equipe, ativar ou desativar o ADB e copiar o comando ADB requer a permissão **Manage cloud phones (edit, proxy, reset, Android version, ADB, root, apps, automation, move)** para aquele telefone. Veja as [permissões da equipe](https://docs.incogniton.com/documentation/pt-br-documentation/telefones-na-nuvem/manage-cloud-phones.md#team-permissions) para telefones em nuvem.

### Quando a conexão não funciona

* **"ADB access to … was refused. Check that the phone is on and ADB is enabled."** O telefone está desligado ou o ADB foi desativado. Ligue o telefone, verifique se o ADB está ativado e copie o comando novamente.
* **"Could not open a local ADB port for …"** O Incogniton não conseguiu abrir uma porta local para o telefone. Tente **Copy ADB command** novamente.
* **"Too many ADB connections are open. Close some and try again."** Desconecte dispositivos que você não usa mais com `adb disconnect`.
* **"The Incogniton ADB service cannot be reached. adb keeps retrying."** Seu computador não consegue acessar o serviço ADB no momento. Verifique sua conexão com a internet; o `adb` reconecta automaticamente.

Você também pode obter o endereço local a partir de um script: veja [Controlar telefones em nuvem a partir de scripts e clientes de IA](https://docs.incogniton.com/documentation/pt-br-documentation/telefones-na-nuvem/control-cloud-phones-from-scripts.md).

{% hint style="info" %}
Se você tiver alguma dúvida sobre o ADB em telefones em nuvem, não hesite em contatar nosso [departamento de suporte](https://incogniton.com/contact/).
{% endhint %}
