# Guia de conexão ADB

Este guia fornece instruções detalhadas para conectar-se a dispositivos de telefone na nuvem via ADB, compatíveis com as versões **Android 12/15** e **Android 13/14**.

## 1. Conexão ADB para telefones em nuvem Android 12/Android 15

### Etapa 1: Conecte-se ao IP e à porta do Cloud Phone

Use o comando `adb connect` para conectar-se diretamente ao endereço IP e à porta do telefone na nuvem.

```bash
adb connect 172.168.10.1:123456
```

> Substitua `172.168.10.1:123456` pelo IP e porta reais do seu telefone na nuvem.


### Etapa 2: autenticar com código de conexão

Após a conexão bem-sucedida, autentique usando o código de conexão.

```bash
adb shell 123456
```

Após a autenticação bem-sucedida, você será padronizado para entrar no telefone na nuvem e poderá usar "exit" para sair

```bash
exit
```

Ou especifique o endereço do dispositivo:

```bash
adb -s 172.168.10.1:123456 shell 123456
```

> Nota: O código de conexão geralmente é fornecido pela plataforma de telefonia em nuvem. Certifique-se de que foi digitado corretamente.


## 2. Conexão ADB para telefones em nuvem Android 13 / Android 14 / Android 15A / Android 16

Para estas versões, um túnel SSH deve ser estabelecido para encaminhar a porta ADB. Isso requer duas etapas.

### Etapa 1: estabelecer o túnel SSH (abrir a primeira janela CMD)

Execute o seguinte comando SSH para mapear a porta ADB remota para sua máquina local:

```bash
ssh -oHostKeyAlgorithms=+ssh-rsa 10.2.179.250_1763627294587@107.151.131.2 -p 1824 -L 9897:adb-proxy:14566 -Nf
```

> Notas:
- Substitua o nome de usuário, IP e porta no comando pela sua configuração real.
- Quando for solicitada uma senha, cole a senha SSH e pressione Enter.
- O comando não produzirá nenhuma saída se for bem-sucedido, indicando que o túnel está sendo executado em segundo plano.



### Etapa 2: Conecte-se à porta ADB local (abra a segunda janela CMD)

Em uma nova janela, execute o comando de conexão ADB:

```bash
adb connect localhost:9897
```

Exemplo de saída bem-sucedida:

```
connected to localhost:9897
```

## Exemplo completo de fluxo de trabalho

### 1. Primeira janela CMD (túnel SSH):

```bash
ssh -oHostKeyAlgorithms=+ssh-rsa 10.2.179.250_1763627294587@107.151.131.2 -p 1824 -L 9897:adb-proxy:14566 -Nf
```

Em seguida, insira a senha da conexão SSH

### 2. Segunda janela CMD (conexão ADB):

```bash
adb connect localhost:9897
```

## Verifique o status da conexão

Execute o seguinte comando para verificar se o dispositivo está conectado:

```bash
adb devices
```

Resultado esperado:

```
List of devices attached
localhost:9897     Device
```

## Referência de comandos ADB comuns

| Comando | Descrição |
|  --- | --- |
| `adb devices` | Listar dispositivos conectados |
| `adb shell` | Entre no terminal shell do dispositivo |
| `adb shell pm list packages` | Listar aplicativos instalados |
| `adb install app.apk` | Instale o arquivo APK |
| `adb uninstall package.name` | Desinstalar aplicativo |
| `adb reboot` | Reinicializar dispositivo |


## Notas importantes

- Certifique-se de ter instalado [ferramentas da plataforma Android SDK](https://developer.android.com/studio/releases/platform-tools) e configurado variáveis de ambiente.
- O método de túnel SSH para Android 13/14/15A é criptografado e seguro – recomendado para uso.
- Se a conexão expirar, verifique as configurações de rede, regras de firewall e configurações de porta.
- Sempre confirme se o telefone na nuvem está ligado e o acesso ADB está habilitado antes de conectar.


Siga estas etapas para conectar com êxito seu telefone na nuvem para tarefas de depuração e automação do ADB.