starred/stf-DeviceFarmer
1
0
Fork 0
mirror of https://github.com/DeviceFarmer/stf.git synced 2026-04-22 05:45:18 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add Documentation in Markdown plus express middleware for in-site rendering.

Browse Source
This commit is contained in:
Gunther Brunner
2014-08-28 21:04:32 +09:00
parent c318cddd14
commit eb968fa737
13 changed files with 349 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

94
res/docs/en/remote-debug.md Normal file
View File

@@ -0,0 +1,94 @@
# Remote Debugging
## Before starting
To be able to use the device locally you need to have installed the [Android SDK Tools](https://developer.android.com/sdk/index.html).
## Debugging
To be able to debug the remote device on a local machine, you need to do the following:
1. On STF, after controlling a device, go to the **Dashboard** tab -> **Remote Debug** panel.
2. There will be a text field with content like `adb connect ...`. Click and copy that text.
3. Paste it and run it your command line.
This will connect the device locally.
You can check it worked, by going to your command line and typing:
```bash
adb devices
```
### Android Studio
You should be able to debug the device, however the IDE still has some bugs when using the debugger.
### Eclipse
You should be able to debug the device as-is.
### Chrome
#### On the device
On Chrome 32 and newer, you don't need to do anything on the device.
On Chrome 32 and earlier, you need to enable USB remote debugging inside *Chrome Settings*:
1. Open **Chrome**.
2. Go to **Settings** -> **Developer Tools**.
3. Enable **USB debugging**.
#### On your desktop browser
1. Open a new tab
2. Go to `chrome://inspect/#devices` on the address bar.
3. Enable **Discover USB devices** by clicking the checkbox.
It should show a list of pages opened inside the Device's Chrome browser and WebViews.
Now you can debug any page by clicking on **inspect**.
See more on the [Remote Debugging on Android with Chrome](https://developer.chrome.com/devtools/docs/remote-debugging) docs.
### Firefox
#### On the device
1. Open **Firefox**.
2. Go to **Settings** -> **Developer tools**.
3. Enable **Remote debugging**.
#### On your command line
Go to your command line, and type:
```
adb forward tcp:6000 tcp:6000
```
If you are using Firefox OS, type:
```
adb forward tcp:6000 localfilesystem:/data/local/debugger-socket
```
#### On your desktop browser
1. On the **Web Developer** menu, select **Connect**.
2. This will go to `chrome://browser/content/devtools/connect.xhtml`.
3. Press the **Connect** button.
4. On the device it will ask you to accept an **Incoming Connection**, press **OK**.
This should show a list of pages opened inside the Device's Firefox browser and WebViews.
See more on the [Remotely Debugging Firefox for Android](https://developer.mozilla.org/docs/Tools/Remote_Debugging/Firefox_for_Android) docs.