Einrichten eines Android-Geräts zum Debuggen

Während der Android-Emulator eine hervorragende Möglichkeit ist, Ihre App schnell zu entwickeln und zu testen, sollten Sie Ihre Apps auf einem echten Android-Gerät testen. Um auf einem Gerät ausgeführt zu werden, müssen Sie den Entwicklermodus auf dem Gerät aktivieren und mit Ihrem Computer verbinden. Weitere Informationen finden Sie unter Ausführen von Apps auf einem Hardwaregerät auf developer.android.com.

Aktivieren des Entwicklermodus auf dem Gerät

Ein Gerät muss den Entwicklermodus aktivieren, um eine Android-App bereitzustellen und zu testen. Der Entwicklermodus ist mit den folgenden Schritten aktiviert:

1. Wechseln Sie zum Bildschirm Einstellungen.
2. Wählen Sie Über das Telefonaus.
3. Tippen Sie auf Buildnummer sieben Mal, bis Sie sind jetzt Entwickler! ist sichtbar.

Abhängig von der Benutzeroberfläche, die auf Ihrem Gerät läuft, befindet sich die Option "Über Telefon" möglicherweise an einem anderen Ort. Lesen Sie in Ihrer Gerätedokumentation nach, wenn Sie Über das Telefonnicht finden können.

Aktivieren des USB-Debuggings

Nachdem Sie den Entwicklermodus auf Ihrem Gerät aktiviert haben, aktivieren Sie das USB-Debugging, indem Sie die folgenden Schritte ausführen:

1. Wechseln Sie zum Bildschirm Einstellungen.
2. Wählen Sie Entwickleroptionenaus.
3. Aktivieren Sie die Option USB-Debugging.

Abhängig von der Benutzeroberfläche, die auf Ihrem Gerät ausgeführt wird, befindet sich die Option USB-Debugging möglicherweise an einem anderen Ort. Lesen Sie Ihre Gerätedokumentation, wenn Sie USB-Debuggingnicht finden können.

Verbinden des Geräts mit dem Computer

Der letzte Schritt besteht darin, das Gerät mit dem Computer zu verbinden. Der einfachste und zuverlässigste Weg ist dies über USB.

Sie erhalten eine Aufforderung, dem Computer auf Ihrem Gerät zu vertrauen, wenn Sie ihn noch nicht für das Debuggen verwendet haben. Sie können auch Immer von diesem Computer zulassen aktivieren, um zu verhindern, dass diese Aufforderung jedes Mal erscheint, wenn Sie das Gerät anschließen.

Wenn Ihr Computer das Gerät nicht erkennt, wenn es angeschlossen ist, versuchen Sie, einen Treiber für das Gerät zu installieren. Wenden Sie sich an die Supportdokumentation Ihres Geräteherstellers. Sie können auch versuchen, den Google USB-Treiber über den Android SDK-Manager zu installieren:

Wlan-Debugging aktivieren

Es ist möglich, ein Android-Gerät über WLAN zu debuggen, ohne das Gerät physisch mit dem Computer verbunden zu halten. Diese Technik erfordert mehr Aufwand, könnte aber nützlich sein, wenn das Gerät zu weit vom Computer ist, um ständig über ein Kabel angeschlossen zu bleiben.

Herstellen einer Verbindung über WLAN

Standardmäßig ist die Android Debug Bridge (adb) für die Kommunikation mit einem Android-Gerät über USB konfiguriert. Es ist möglich, es neu zu konfigurieren, um TCP/IP anstelle von USB zu verwenden. Dazu müssen sich sowohl das Gerät als auch der Computer im selben WLAN-Netzwerk befinden.

Aktivieren Sie zunächst das drahtlose Debuggen auf Ihrem Android-Gerät:

1. Führen Sie die Schritte im Abschnitt Aktivieren des Entwicklermodus auf dem Gerät aus.
2. Führen Sie die Schritte im Abschnitt Aktivieren des USB-Debuggings aus.
3. Wechseln Sie zum Bildschirm Einstellungen.
4. Wählen Sie Entwickleroptionenaus.
5. Aktivieren Sie die Option Drahtloses Debuggen.

Abhängig von der Ausgeführten Benutzeroberfläche ihres Geräts befindet sich die Option drahtloses Debuggen möglicherweise an einem anderen Ort. Weitere Informationen finden Sie in der Gerätedokumentation, falls Sie drahtloses Debuggingnicht finden können.

Verwenden Sie als Nächstes adb, um eine Verbindung mit Ihrem Gerät herzustellen, zuerst über eine USB-Verbindung:

1. Ermitteln Sie die IP-Adresse Ihres Android-Geräts. Eine Möglichkeit, die IP-Adresse zu ermitteln, besteht darin, unter Einstellungen > Netzwerk & Internet > WLAN-zu suchen, und tippen Sie dann auf das WLAN-Netzwerk, mit dem das Gerät verbunden ist, und tippen Sie dann auf Erweiterten. Dadurch wird eine Dropdownliste mit Informationen zur Netzwerkverbindung geöffnet, ähnlich wie im folgenden Screenshot:

   

   In einigen Versionen von Android wird die IP-Adresse dort nicht aufgeführt, sondern finden Sie stattdessen unter Einstellungen > Über Telefon > Status.

2. Öffnen Sie in Visual Studio die adb-Eingabeaufforderung, indem Sie die Menüoption auswählen: Tools>Android>Android Adb-Eingabeaufforderung....

3. Verwenden Sie in der Eingabeaufforderung den Befehl adb tcpip, um das Gerät anweisen, TCP/IP-Verbindungen an Port 5555 abzuhören.

   adb tcpip 5555
   

4. Trennen Sie das USB-Kabel von Ihrem Gerät.

5. Stellen Sie eine Verbindung mit der IP-Adresse des Geräts mit Port 5555 her:

   adb connect 192.168.1.28:5555
   

   Nach Abschluss dieses Befehls ist das Android-Gerät über WLAN mit dem Computer verbunden.

   Wenn Sie mit dem Debuggen über WLAN fertig sind, können Sie ADB mit dem folgenden Befehl wieder auf den USB-Modus zurücksetzen:

   adb usb
   

   Um die mit dem Computer verbundenen Geräte anzuzeigen, verwenden Sie den Befehl adb devices:

   adb devices
   

Konfigurieren von Optionen für Entwickler auf Geräten

Die Einstellungs-App unter Android enthält einen Bildschirm namens Entwickleroptionen, auf dem Sie Systemverhalten konfigurieren können, die Ihnen beim Profilieren und Debuggen der App-Leistung helfen. Weitere Informationen finden Sie unter Konfigurieren von Optionen für Entwickler auf Geräten auf developer.android.com.

Debuggen einer App auf einem Android-Gerät

So debuggen Sie eine App auf einem Android-Gerät:

1. Schließen Sie das Gerät an Ihren Computer an, und wählen Sie es als Debugziel in Visual Studio oder Visual Studio Code aus.
2. Führen Sie die App aus.

Informationen zum Auswählen eines Debugziels in Visual Studio finden Sie unter Erstellen Ihrer ersten App. Informationen zum Auswählen eines Debugziels in Visual Studio Code finden Sie unter Erstellen Ihrer ersten App.