rob
/
remotedebug-ios-webkit-adapter-docker
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Debug Safari and WebViews on iOS from tools like VS Code and Chrome DevTools - all from a Docker container.
2 Commits 2 Branches 0 Tags 201 KiB
Dockerfile 100%
Go to file
Rob Watson 085aca0e08 add Dockerfile and README.md 2020-06-05 16:55:50 +02:00
images add Dockerfile and README.md 2020-06-05 16:55:50 +02:00
Dockerfile add Dockerfile and README.md 2020-06-05 16:55:50 +02:00
README.md add Dockerfile and README.md 2020-06-05 16:55:50 +02:00

README.md

remotedebug-ios-webkit-adapter-docker

A Docker container containing everything needed to run Chrome devtools against an iOS device.

Relies on the remotedebug-ios-webkit-adapter project, which in turn relies on libimobiledevice, libusbmuxd, libplist and ios-webkit-debug-proxy.

Tested with iOS 13.5.1 on an 2018 iPad Pro 11 inch and 2018 iPhone 8 Plus.

Usage

  1. Plug iOS device in to Linux box via USB
  2. Ensure device is trusted
  3. Launch the Docker container:
docker run --privileged \
  -p 9000:9000 \
  -v /dev/bus/usb:/dev/bus/usb \
  -v /var/run:/var/run \
  netfluxio/remotedebug-ios-webkit-adapter-docker
  1. Open Chrome and visit chrome://inspect
  2. Next to Discover network targets click Configure
  3. Ensure localhost:9000 is included in the list

Chrome Devtools

Troubleshooting

If you see this error:

remotedebug-ios-webkit-adapter failed to run with the following error: adapter.spawnProcess.close, code=255

then the device is probably either not plugged in or not trusted (see also Debugging, below.)

Debugging

Run docker with argument -e DEBUG=remotedebug