{"id":69551,"date":"2019-12-30T16:41:32","date_gmt":"2019-12-30T11:11:32","guid":{"rendered":"https:\/\/www.vskills.in\/certification\/tutorial\/?p=69551"},"modified":"2024-04-12T14:21:52","modified_gmt":"2024-04-12T08:51:52","slug":"ios-webkit-debug-proxy","status":"publish","type":"page","link":"https:\/\/www.vskills.in\/certification\/tutorial\/ios-webkit-debug-proxy\/","title":{"rendered":"iOS WebKit Debug Proxy"},"content":{"rendered":"\n

Go back to tutorial<\/a><\/p>\n\n\n

iOS WebKit Debug Proxy<\/strong><\/h1>\n

ios_webkit_debug_proxy (aka iwdp) proxies are used to request from usbmuxd daemon over a websocket connection. Further, it allows developer to send commands to MobileSafari and UIWebViews on real and simulated iOS devices. iOS device appium uses ios_webkit_debug_proxy for accessing web views.<\/p>\n

Design Features<\/strong><\/h3>\n

\"\"<\/p>\n

Installation Process<\/strong><\/h3>\n

In which case, iOS WebKit Debug Proxy works on Linux, MacOS and Windows.<\/p>\n

On a MacOS<\/strong><\/em><\/p>\n

it’s easiest to install with homebrew:<\/p>\n

brew install ios-webkit-debug-proxy<\/p>\n

On Windows<\/strong><\/em><\/p>\n

it’s easiest to install with scoop:<\/p>\n

scoop bucket add extras<\/p>\n

scoop install ios-webkit-debug-proxy<\/p>\n

On Linux<\/em><\/strong><\/p>\n

sudo apt-get install autoconf automake libusb-dev libusb-1.0-0-dev libplist-dev libplist++-dev usbmuxd libtool libimobiledevice-dev<\/p>\n

git clone https:\/\/github.com\/google\/ios-webkit-debug-proxy.git<\/p>\n

cd ios-webkit-debug-proxy<\/p>\n

.\/autogen.sh<\/p>\n

make<\/p>\n

sudo make install<\/p>\n

Building ios-webkit-debug-proxy from source<\/strong><\/h3>\n

At first, open the command terminal on your mac. Further, you can find instructions on how to open the terminal via your favorite search engine. Once that is open, verify you have Homebew installed:<\/p>\n

$ brew -v<\/p>\n

After having Homebrew, it is important to perform the following commands (the $ indicates the command line prompt, do not enter it):<\/p>\n

$ cd  ~<\/p>\n

$ sudo apt-get install autoconf automake libusb-dev libusb-1.0-0-dev libplist-dev libplist++-dev usbmuxd libtool libimobiledevice-dev<\/p>\n

$ git clone https:\/\/github.com\/google\/ios-webkit-debug-proxy.git<\/p>\n

$ cd ios-webkit-debug-proxy<\/p>\n

$ .\/autogen.sh<\/p>\n

$ make<\/p>\n

$ sudo make install<\/p>\n

Using <\/strong>ios-webkit<\/strong><\/h3>\n

On Linux, you must run the usbmuxd daemon. The above install adds a \/lib\/udev rule to start the daemon whenever a device is attached.<\/p>\n

To verify that usbmuxd can list your attached device(s), ensure that libimobiledevice-utils is installed, or install it with:<\/p>\n

sudo apt-get install libimobiledevice-utils<\/p>\n

and then run idevice_id -l<\/p>\n

How to Start the simulator or device?<\/strong><\/h3>\n

The iOS Simulator is supported, but it must be started before the proxy. The simulator can be started in XCode, standalone, or via the command line:<\/p>\n

# Xcode changes these paths frequently, so doublecheck them<\/p>\n

SDK_DIR=”\/Applications\/Xcode.app\/Contents\/Developer\/Platforms\/iPhoneSimulator.platform\/Developer\/SDKs”<\/p>\n

SIM_APP=”\/Applications\/Xcode.app\/Contents\/Developer\/Applications\/Simulator.app\/Contents\/MacOS\/Simulator”<\/p>\n

$SIM_APP -SimulateApplication $SDK_DIR\/iPhoneSimulator8.4.sdk\/Applications\/MobileSafari.app\/MobileSafari<\/p>\n

Enable the inspector – Your attached iOS devices must have \u22651 open browser tabs and the inspector enabled via: Settings > Safari > Advanced > Web Inspector = ON<\/p>\n

Running ios-webkit-debug-proxy<\/strong><\/h3>\n

Once it has been installed, then you can start the proxy with the below command –<\/p>\n

# Change the udid to be the udid of the attached device and make sure to set the port to 27753<\/p>\n

# as that is the port the remote-debugger uses. You can learn how to retrieve the UDID from<\/p>\n

# Apple’s developer resources.<\/p>\n

> ios_webkit_debug_proxy -c 0e4b2f612b65e98c1d07d22ee08678130d345429:27753 -d<\/p>\n

Also, you can also set the desired capability called startIWDP to true. This will run the above command as a subprocess from within Appium and will set the udid, so you don’t have to run ios_webkit_debug_proxy yourself anymore. It monitors the proxy for crashes and relaunches when needed.<\/p>\n

Further, you may also use ios-webkit-debug-proxy-launcher, a small script included with the Appium codebase, to launch the proxy. It monitors the proxy log for errors, and relaunch the proxy where needed. This is also optional and may help with recent devices:<\/p>\n

# change the udid<\/p>\n

# note, this is run from an Appium repository<\/p>\n

> .\/bin\/ios-webkit-debug-proxy-launcher.js -c 0e4b2f612b65e98c1d07d22ee08678130d345429:27753 -d<\/p>\n

The proxy requires the “web inspector” to be turned on to allow a connection to be established. Turn it on by going to settings > safari > advanced.<\/p>\n