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

# Se connecter à un téléphone cloud avec ADB

Activez ADB pour un téléphone cloud dans Cloud Phones → ⋮ → Activer ADB, copiez la commande adb connect et connectez-vous depuis un terminal sur votre ordinateur.

Allez dans **Cloud Phones**, cliquez sur l'icône à trois points (⋮) à côté du téléphone et cliquez sur **Activer ADB**. Lorsque le téléphone est en marche, cliquez à nouveau sur l'icône ⋮ et cliquez sur **Copier la commande ADB**, puis collez la commande dans un terminal.

ADB (Android Debug Bridge) est l'outil en ligne de commande d'Android pour les développeurs. Avec lui, vous pouvez installer des applications, exécuter des commandes shell et connecter des outils d'automatisation Android à un téléphone cloud, comme un téléphone connecté à votre ordinateur avec un câble. Vous avez besoin de l'outil `adb` des Android SDK Platform-Tools de Google sur votre ordinateur.

### Activer ADB

{% stepper %}
{% step %}

#### Ouvrir le menu du téléphone

Cliquez sur **Cloud Phones** dans le menu de gauche. Cliquez sur l'icône à trois points (⋮) à côté du téléphone auquel vous souhaitez vous connecter.
{% endstep %}

{% step %}

#### Activer ADB

Cliquez sur **Activer ADB**. Un message confirme "ADB activé avec succès".

**Activer ADB** est proposé lorsque le téléphone est allumé ou éteint. Il n'est pas proposé pendant que le téléphone est en cours de configuration, de démarrage, de réinitialisation ou de changement de version Android.
{% endstep %}
{% endstepper %}

ADB reste activé lorsque vous éteignez et rallumez le téléphone. Pour le désactiver, ouvrez le menu ⋮ et cliquez sur **Désactiver ADB**. Cela ferme également la connexion ADB locale sur votre ordinateur.

### Copier la commande ADB

Le téléphone doit être **en marche** avant que vous puissiez vous connecter. Allumez-le d'abord s'il est éteint.

Il y a deux façons de copier la commande :

* Cliquez sur l'icône ⋮ à côté du téléphone et cliquez sur **Copier la commande ADB**.
* Cliquez sur la colonne **Adresse ADB** du téléphone dans la liste. Elle affiche **Copier** jusqu'à ce qu'une connexion soit ouverte, et l'adresse locale après cela.

Incogniton copie une commande comme `adb connect 127.0.0.1:6555` dans votre presse-papiers et affiche un message indiquant qu'elle a été copiée. **Copier la commande ADB** n'apparaît que lorsque le téléphone est en marche et que ADB est activé.

### Se connecter depuis un terminal

Ouvrez un terminal (Invite de commandes, PowerShell ou Terminal), collez la commande et appuyez sur Entrée :

```
adb connect 127.0.0.1:6555
```

Après que `adb` indique qu'il est connecté, le téléphone cloud apparaît dans `adb devices` et vous pouvez l'utiliser comme n'importe quel autre appareil Android, par exemple `adb shell` ou `adb install app.apk`.

### Comment fonctionne la connexion

Vous ne vous connectez jamais à l'adresse propre du téléphone cloud. Incogniton ouvre un port local sur votre ordinateur, `127.0.0.1:<port>` (un port entre 6555 et 6654), et relaye la connexion de manière sécurisée vers votre téléphone. C'est pourquoi l'adresse commence toujours par `127.0.0.1`.

* Le port local reste ouvert tant que le téléphone est en marche avec ADB activé et qu'Incogniton est ouvert. Lorsque vous éteignez le téléphone, désactivez ADB, réinitialisez le téléphone ou vous déconnectez, le port se ferme.
* L'adresse ne fonctionne que sur l'ordinateur où Incogniton est en cours d'exécution. Les autres ordinateurs ne peuvent pas l'utiliser.
* Les connexions depuis un autre compte utilisateur sur le même ordinateur sont refusées. Seuls les programmes qui s'exécutent sous votre propre compte d'ordinateur peuvent utiliser le port.
* Chaque fois que le téléphone démarre, copiez à nouveau la commande : le numéro de port peut être différent.

{% hint style="warning" %}
ADB donne un contrôle total sur le téléphone. Ne l'activez que lorsque vous en avez besoin, et désactivez-le lorsque vous avez terminé.
{% endhint %}

### Qui peut utiliser ADB

Dans une équipe, activer ou désactiver ADB et copier la commande ADB nécessitent l'autorisation **Gérer les téléphones cloud (modifier, proxy, réinitialiser, version Android, ADB, root, applications, automatisation, déplacer)** pour ce téléphone. Voir les [autorisations d'équipe](https://docs.incogniton.com/documentation/french-documentation/telephones-cloud/manage-cloud-phones.md#team-permissions) pour les téléphones cloud.

### Quand la connexion ne fonctionne pas

* **"L'accès ADB à … a été refusé. Vérifiez que le téléphone est allumé et que ADB est activé."** Le téléphone est éteint, ou ADB a été désactivé. Allumez le téléphone, vérifiez que ADB est activé et copiez à nouveau la commande.
* **"Impossible d'ouvrir un port ADB local pour …"** Incogniton n'a pas pu ouvrir un port local pour le téléphone. Essayez à nouveau **Copier la commande ADB**.
* **"Trop de connexions ADB sont ouvertes. Fermez-en certaines et réessayez."** Déconnectez les appareils que vous n'utilisez plus avec `adb disconnect`.
* **"Le service ADB d'Incogniton ne peut pas être atteint. adb continue de réessayer."** Votre ordinateur ne peut pas atteindre le service ADB pour le moment. Vérifiez votre connexion internet ; `adb` se reconnecte automatiquement.

Vous pouvez également obtenir l'adresse locale à partir d'un script : voir [Contrôler les téléphones cloud depuis des scripts et des clients IA](https://docs.incogniton.com/documentation/french-documentation/telephones-cloud/control-cloud-phones-from-scripts.md).

{% hint style="info" %}
Si vous avez des questions sur ADB sur les téléphones cloud, n'hésitez pas à contacter notre [service support](https://incogniton.com/contact/).
{% endhint %}
