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

# Mit ADB zu einem Cloud Phone verbinden

Aktivieren Sie ADB für ein Cloud-Telefon in Cloud Phones → ⋮ → ADB aktivieren, kopieren Sie den adb connect-Befehl und verbinden Sie sich von einem Terminal auf Ihrem Computer.

Gehen Sie zu **Cloud Phones**, klicken Sie auf das Drei-Punkte-Symbol (⋮) neben dem Telefon und klicken Sie auf **ADB aktivieren**. Wenn das Telefon läuft, klicken Sie erneut auf das ⋮-Symbol und klicken Sie auf **ADB-Befehl kopieren**, dann fügen Sie den Befehl in ein Terminal ein.

ADB (Android Debug Bridge) ist das Befehlszeilenwerkzeug für Entwickler von Android. Damit können Sie Apps installieren, Shell-Befehle ausführen und Android-Automatisierungstools mit einem Cloud-Telefon verbinden, genau wie ein Telefon, das mit einem Kabel an Ihren Computer angeschlossen ist. Sie benötigen das `adb`-Tool aus den Android SDK Platform-Tools von Google auf Ihrem Computer.

### ADB einschalten

{% stepper %}
{% step %}

#### Öffnen Sie das Menü des Telefons

Klicken Sie im linken Menü auf **Cloud Phones**. Klicken Sie auf das Drei-Punkte-Symbol (⋮) neben dem Telefon, mit dem Sie sich verbinden möchten.
{% endstep %}

{% step %}

#### ADB aktivieren

Klicken Sie auf **ADB aktivieren**. Eine Nachricht bestätigt "ADB erfolgreich aktiviert".

**ADB aktivieren** wird angeboten, wenn das Telefon ein- oder ausgeschaltet ist. Es wird nicht angeboten, während das Telefon noch eingerichtet, gestartet, zurückgesetzt oder seine Android-Version gewechselt wird.
{% endstep %}
{% endstepper %}

ADB bleibt eingeschaltet, wenn Sie das Telefon aus- und wieder einschalten. Um es auszuschalten, öffnen Sie das ⋮-Menü und klicken Sie auf **ADB deaktivieren**. Dadurch wird auch die lokale ADB-Verbindung auf Ihrem Computer geschlossen.

### Den ADB-Befehl kopieren

Das Telefon muss **laufen**, bevor Sie sich verbinden können. Schalten Sie es zuerst ein, wenn es ausgeschaltet ist.

Es gibt zwei Möglichkeiten, den Befehl zu kopieren:

* Klicken Sie auf das ⋮-Symbol neben dem Telefon und klicken Sie auf **ADB-Befehl kopieren**.
* Klicken Sie auf die **ADB-Adresse**-Spalte des Telefons in der Liste. Es zeigt **Kopieren** an, bis eine Verbindung geöffnet ist, und die lokale Adresse danach.

Incogniton kopiert einen Befehl wie `adb connect 127.0.0.1:6555` in Ihre Zwischenablage und zeigt eine Nachricht an, dass er kopiert wurde. **ADB-Befehl kopieren** erscheint nur, wenn das Telefon läuft und ADB aktiviert ist.

### Vom Terminal aus verbinden

Öffnen Sie ein Terminal (Eingabeaufforderung, PowerShell oder Terminal), fügen Sie den Befehl ein und drücken Sie Enter:

```
adb connect 127.0.0.1:6555
```

Nachdem `adb` meldet, dass es verbunden ist, erscheint das Cloud-Telefon in `adb devices` und Sie können es wie jedes andere Android-Gerät verwenden, zum Beispiel `adb shell` oder `adb install app.apk`.

### Wie die Verbindung funktioniert

Sie verbinden sich nie mit der eigenen Adresse des Cloud-Telefons. Incogniton öffnet einen lokalen Port auf Ihrem Computer, `127.0.0.1:<port>` (ein Port zwischen 6555 und 6654), und leitet die Verbindung sicher zu Ihrem Telefon weiter. Deshalb beginnt die Adresse immer mit `127.0.0.1`.

* Der lokale Port bleibt offen, solange das Telefon mit aktiviertem ADB läuft und Incogniton geöffnet ist. Wenn Sie das Telefon ausschalten, ADB deaktivieren, das Telefon zurücksetzen oder sich abmelden, schließt sich der Port.
* Die Adresse funktioniert nur auf dem Computer, auf dem Incogniton läuft. Andere Computer können sie nicht verwenden.
* Verbindungen von einem anderen Benutzerkonto auf demselben Computer werden abgelehnt. Nur Programme, die unter Ihrem eigenen Computerkonto laufen, können den Port nutzen.
* Jedes Mal, wenn das Telefon startet, kopieren Sie den Befehl erneut: Die Portnummer kann unterschiedlich sein.

{% hint style="warning" %}
ADB gibt vollständige Kontrolle über das Telefon. Aktivieren Sie es nur, wenn Sie es benötigen, und deaktivieren Sie es, wenn Sie fertig sind.
{% endhint %}

### Wer ADB verwenden kann

In einem Team benötigen das Ein- oder Ausschalten von ADB und das Kopieren des ADB-Befehls die Berechtigung **Cloud-Telefone verwalten (bearbeiten, Proxy, zurücksetzen, Android-Version, ADB, Root, Apps, Automatisierung, verschieben)** für dieses Telefon. Siehe die [Team-Berechtigungen](https://docs.incogniton.com/documentation/german-documentation-1/cloud-phones/manage-cloud-phones.md#team-permissions) für Cloud-Telefone.

### Wenn die Verbindung nicht funktioniert

* **"ADB-Zugriff auf … wurde verweigert. Überprüfen Sie, ob das Telefon eingeschaltet ist und ADB aktiviert ist."** Das Telefon ist ausgeschaltet oder ADB wurde ausgeschaltet. Schalten Sie das Telefon ein, überprüfen Sie, ob ADB aktiviert ist, und kopieren Sie den Befehl erneut.
* **"Konnte keinen lokalen ADB-Port für … öffnen."** Incogniton konnte keinen lokalen Port für das Telefon öffnen. Versuchen Sie **ADB-Befehl kopieren** erneut.
* **"Zu viele ADB-Verbindungen sind geöffnet. Schließen Sie einige und versuchen Sie es erneut."** Trennen Sie Geräte, die Sie nicht mehr verwenden, mit `adb disconnect`.
* **"Der Incogniton ADB-Dienst kann nicht erreicht werden. adb versucht es weiterhin."** Ihr Computer kann den ADB-Dienst derzeit nicht erreichen. Überprüfen Sie Ihre Internetverbindung; `adb` verbindet sich von selbst erneut.

Sie können die lokale Adresse auch aus einem Skript abrufen: siehe [Cloud-Telefone von Skripten und KI-Clients steuern](https://docs.incogniton.com/documentation/german-documentation-1/cloud-phones/control-cloud-phones-from-scripts.md).

{% hint style="info" %}
Wenn Sie Fragen zu ADB auf Cloud-Telefonen haben, zögern Sie nicht, unseren [Support](https://incogniton.com/contact/) zu kontaktieren.
{% endhint %}
