Ausführen und Debuggen Ihrer Android-Anwendung auf einem Remote-Android-Gerät
Nach oben zu Mobile Android-Anwendungsentwicklung
Inhaltsverzeichnis
Auf dieser Seite wird beschrieben, wie eine Android-Anwendung auf einem über ein Netzwerk verbundenen Android-Gerät gedebuggt wird. Diese Methode wird auch als ADB via Netzwerk
oder TCP/IP-Debugging
bezeichnet.
Lesen Sie zuerst Mobile Android-Anwendungsentwicklung, um die erforderlichen Schritte zum Einrichten und Verwenden eines Android-Gerätes für die Entwicklung kennenzulernen.
Vorteile dieser Methode:
- Drahtlose Verbindung zu dem Android-Gerät, kein USB-Kabel erforderlich (für nicht gerootete Geräte benötigen Sie das USB-Kabel, um in den Debug-Modus zu wechseln).
- Vereinfacht die gemeinsame Nutzung eines Android-Gerätes für das Debuggen durch mehrere Entwickler.
- Hinweis: Alle ADB-Befehle auf dieser Seite funktionieren, wenn nur ein Android-Gerät mit Ihren Computer verbunden ist. Wenn mehrere Android-Geräte verbunden sind, finden Sie unter Android Help: Directing Commands (EN) Informationen zum korrekten Ausführen von ADB-Befehlen.
- Hinweis: Android-Anwendungen werden immer im Hintergrund weiterausgeführt, auch wenn sie für den Benutzer nicht sichtbar sind. Da die Anwendung weiterausgeführt wird, kann der Eindruck entstehen, dass der Debugger hängt, obwohl die Verbindung mit der Anwendung einfach getrennt wurde.
Aktivieren des TCP/IP-Debugging auf dem Android-Gerät
Voraussetzungen
- Das Android-Gerät muss mit einem drahtlosen Netzwerk verbunden sein, das Teil desselben Netzwerks ist, mit dem Ihr Entwicklungscomputer verbunden ist.
Wenn Ihr Android-Gerät nicht gerootet ist, ist auch Folgendes erforderlich:
- Einen Computer, auf dem das Android SDK installiert ist.
- Ein USB-Kabel.
- Das Android-Gerät muss als ADB-Gerät auf Ihrem Computer erkannt werden.
Wenn Ihr Android-Gerät gerootet ist, ist Folgendes erforderlich:
- Entweder:
- Eine Menüeinstellung, mit der der
TCP/IP-Debug-Modus
aktiviert wird. (Auf einigen ROMs verfügbar. Normalerweise im Menü "Entwicklereinstellungen". Könnte auch alsADB via Netzwerk
angezeigt werden). Oder - Eine auf Ihrem Gerät installierte Terminalemulatoranwendung (wie Terminal Emulator for Android (EN)). Oder
- Eine Anwendung, die den
TCP/IP-Debug-Modus
aktiviert (wie ADB over network (EN)).
- Eine Menüeinstellung, mit der der
- Hinweis: Ihr Entwicklungscomputer kann mit dem Netzwerk entweder drahtlos oder über ein Ethernet-Kabel verbunden sein, er muss sich aber in demselben Netzwerk wie das Android-Gerät befinden.
Schritte
Wenn Ihr Android-Gerät nicht gerootet ist:
- Schließen Sie das Android-Gerät über ein USB-Kabel an den Computer an.
- Öffnen Sie ein Terminal-Fenster, wie z. B.
cmd.exe
. - Öffnen Sie den Ordner
platform-tools
Ihres Android-SDK:cd "C:\Users\Public\Documents\Embarcadero\Studio\20.0\CatalogRepository\<Android SDK folder>\platform-tools"
- Führen Sie den folgenden Befehl aus:
adb tcpip 5555
- Hinweis: Ersetzen Sie
5555
mit dem Port, an dem das Gerät eingehende Verbindungen empfängt.
- Hinweis: Ersetzen Sie
- Wenn Sie möchten, können Sie nach Ausführung dieses Befehls das Android-Gerät von Ihrem Computer trennen.
Wenn Ihr Android-Gerät gerootet ist, führen Sie einen der folgenden Schritte aus, um den TCP/IP-Debug-Modus zu aktivieren:
- Aktivieren Sie auf Ihrem Gerät im Menü "Entwicklereinstellungen" den
TCP/IP-Debug-Modus
(könnte auch alsADB via Netzwerk
angezeigt werden). - Führen Sie im Terminalemulator den folgenden Code aus:
su
setprop service.adb.tcp.port 5555
stop adbd
start adbd
- Verwenden Sie eine Anwendung, die das TCP/IP-Debugging aktiviert.
Herstellen der Verbindung zu dem Android-Gerät
Um eine Verbindung zu dem Android-Gerät von Ihrem Entwicklungscomputer aus herzustellen, führen Sie im Verzeichnis "platform-tools" Ihrer Android SDK-Installation den folgenden Befehl aus: adb connect <IP-Adresse>:<Portnummer>
(zum Beispiel: adb connect 192.168.1.110:5555
). <IP-Adresse> ist die IP-Adresse Ihres Gerätes. Es gibt verschiedene Möglichkeiten die IP-Adresse Ihres Gerätes herauszufinden, z. B.:
- Suchen Sie im Menü Ihres Gerätes (normalerweise:
Einstellungen > WLAN > Erweitert
, kann aber je nach Betriebssystemversion oder Hersteller davon abweichen). - Führen Sie den folgenden Befehl im Verzeichnis "platform-tools" Ihrer Android SDK-Installation aus:
adb shell netcfg
. Dazu muss Ihr Gerät über ein USB-Kabel angeschlossen sein. - Suchen Sie die IP-Adresse Ihres Gerätes in der Einstellungsseite Ihres Netzwerkrouters.
Bei erfolgreicher Verbindung wird im Befehlsfenster "verbunden mit <IP-Adresse>:<Portnummer>" angezeigt. Mit dem Befehl adb devices
können Sie eine Liste der verbundenen ADB-Geräte anzeigen. Das verbundene Android-Gerät sollte jetzt in der Projektverwaltung angezeigt werden.
Trennen der Verbindung zu einem Remote-Android-Gerät
Wenn Sie die Verbindung zu dem Android-Gerät trennen möchten, können Sie einfach den Debug-Modus auf dem Gerät zurücksetzen. Alternativ können Sie auch auf Ihrem Entwicklungscomputer den folgenden Code ausführen: adb disconnect <IP-Adresse>:<Portnummer>
.
Zurücksetzen des Debug-Modus auf dem Android-Gerät
Der Debug-Modus auf dem Android-Gerät wird bei jedem Neustart des Gerätes zurückgesetzt. Führen Sie einen der folgenden Schritte aus, wenn Sie den Debug-Modus ohne Neustart des Gerätes zurücksetzen möchten:
- Führen Sie den Befehl
adb usb
auf dem Remote-Computer aus, an den das Android-Gerät über ein USB-Kabel angeschlossen ist. - Führen Sie im Terminalemulator auf dem Gerät den folgenden Code aus:
style="list-style: none; display: inline"
su setprop service.adb.tcp.port -1 stop adbd start adbd