> 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/italian-documentation/telefoni-cloud/connect-to-a-cloud-phone-with-adb.md).

# Connettiti a un telefono cloud con ADB

Attiva ADB per un telefono cloud in Cloud Phones → ⋮ → Abilita ADB, copia il comando adb connect e connettiti da un terminale sul tuo computer.

Vai su **Cloud Phones**, clicca sull'icona con i tre puntini (⋮) accanto al telefono e clicca su **Abilita ADB**. Quando il telefono è in funzione, clicca di nuovo sull'icona ⋮ e clicca su **Copia comando ADB**, quindi incolla il comando in un terminale.

ADB (Android Debug Bridge) è lo strumento da riga di comando di Android per gli sviluppatori. Con esso puoi installare app, eseguire comandi shell e connettere strumenti di automazione Android a un telefono cloud, proprio come un telefono collegato al tuo computer con un cavo. Hai bisogno dello strumento `adb` dagli Android SDK Platform-Tools di Google sul tuo computer.

### Attivare ADB

{% stepper %}
{% step %}

#### Apri il menu del telefono

Clicca su **Cloud Phones** nel menu a sinistra. Clicca sull'icona con i tre puntini (⋮) accanto al telefono a cui vuoi connetterti.
{% endstep %}

{% step %}

#### Abilita ADB

Clicca su **Abilita ADB**. Un messaggio conferma "ADB abilitato con successo".

**Abilita ADB** è disponibile quando il telefono è acceso o spento. Non è disponibile mentre il telefono è ancora in fase di configurazione, avvio, ripristino o cambio della versione di Android.
{% endstep %}
{% endstepper %}

ADB rimane attivo quando spegni e riaccendi il telefono. Per disattivarlo, apri il menu ⋮ e clicca su **Disabilita ADB**. Questo chiude anche la connessione ADB locale sul tuo computer.

### Copia il comando ADB

Il telefono deve essere **in funzione** prima di poterti connettere. Accendilo prima se è spento.

Ci sono due modi per copiare il comando:

* Clicca sull'icona ⋮ accanto al telefono e clicca su **Copia comando ADB**.
* Clicca sulla colonna **Indirizzo ADB** del telefono nell'elenco. Mostra **Copia** fino a quando una connessione è aperta, e l'indirizzo locale dopo.

Incogniton copia un comando come `adb connect 127.0.0.1:6555` negli appunti e mostra un messaggio che è stato copiato. **Copia comando ADB** appare solo quando il telefono è in funzione e ADB è abilitato.

### Connettersi da un terminale

Apri un terminale (Prompt dei comandi, PowerShell o Terminale), incolla il comando e premi Invio:

```
adb connect 127.0.0.1:6555
```

Dopo che `adb` segnala che è connesso, il telefono cloud appare in `adb devices` e puoi usarlo come qualsiasi altro dispositivo Android, ad esempio `adb shell` o `adb install app.apk`.

### Come funziona la connessione

Non ti connetti mai all'indirizzo proprio del telefono cloud. Incogniton apre una porta locale sul tuo computer, `127.0.0.1:<port>` (una porta tra 6555 e 6654), e inoltra la connessione in modo sicuro al tuo telefono. Ecco perché l'indirizzo inizia sempre con `127.0.0.1`.

* La porta locale rimane aperta finché il telefono è in funzione con ADB abilitato e Incogniton è aperto. Quando spegni il telefono, disabiliti ADB, ripristini il telefono o esci, la porta si chiude.
* L'indirizzo funziona solo sul computer su cui è in esecuzione Incogniton. Altri computer non possono usarlo.
* Le connessioni da un altro account utente sullo stesso computer sono rifiutate. Solo i programmi che girano sotto il tuo account computer possono usare la porta.
* Ogni volta che il telefono si avvia, copia di nuovo il comando: il numero di porta può essere diverso.

{% hint style="warning" %}
ADB dà pieno controllo sul telefono. Abilitalo solo quando ne hai bisogno e disabilitalo quando hai finito.
{% endhint %}

### Chi può usare ADB

In un team, attivare o disattivare ADB e copiare il comando ADB richiede il permesso **Gestisci telefoni cloud (modifica, proxy, ripristino, versione Android, ADB, root, app, automazione, sposta)** per quel telefono. Vedi i [permessi del team](https://docs.incogniton.com/documentation/italian-documentation/telefoni-cloud/manage-cloud-phones.md#team-permissions) per i telefoni cloud.

### Quando la connessione non funziona

* **"Accesso ADB a … è stato rifiutato. Controlla che il telefono sia acceso e che ADB sia abilitato."** Il telefono è spento o ADB è stato disattivato. Accendi il telefono, controlla che ADB sia abilitato e copia di nuovo il comando.
* **"Impossibile aprire una porta ADB locale per …"** Incogniton non è riuscito ad aprire una porta locale per il telefono. Prova di nuovo **Copia comando ADB**.
* **"Troppe connessioni ADB sono aperte. Chiudine alcune e riprova."** Disconnetti i dispositivi che non usi più con `adb disconnect`.
* **"Il servizio ADB di Incogniton non può essere raggiunto. adb continua a riprovare."** Il tuo computer non riesce a raggiungere il servizio ADB in questo momento. Controlla la tua connessione internet; `adb` si riconnette da solo.

Puoi anche ottenere l'indirizzo locale da uno script: vedi [Controlla telefoni cloud da script e client AI](https://docs.incogniton.com/documentation/italian-documentation/telefoni-cloud/control-cloud-phones-from-scripts.md).

{% hint style="info" %}
Se hai domande su ADB sui telefoni cloud, non esitare a contattare il nostro [supporto](https://incogniton.com/contact/).
{% endhint %}
