Repository files navigation

WebDriverAgent is aWebDriver server implementation for iOS that can be used to remote control iOS devices. It allows you to launch & kill applications, tap & scroll views or confirm view presence on a screen. This makes it a perfect tool for application end-to-end testing or general purpose device automation. It works by linkingXCTest.framework and calling Apple's API to execute commands directly on a device. WebDriverAgent is developed and used at Facebook for end-to-end testing and is successfully adopted byAppium.

• Works with device & simulator
• Implements most ofWebDriver Spec
• Implements part ofMobile JSON Wire Protocol Spec
• USB support for devices
• Inspectorendpoint with friendly user interface to inspect current device state
• Easy development cycle as it can be launched & debugged directly via Xcode
• Unsupported yet, but works with tvOS & OSX

To get the project set up just run bootstrap script:

./Scripts/bootstrap.sh

It will:

• fetch all dependencies withCarthage
• build Inspector bundle usingnpm

After it is finished you can simply openWebDriverAgent.xcodeproj and startWebDriverAgentRunner testand start sendingrequests.

More about how to start WebDriverAgenthere.

If you are having some issues please checkoutwiki first.

If you want to help us out, you are more than welcome to. However please make sure you have followed the guidelines inCONTRIBUTING.

WebDriverAgent is BSD-licensed. We also provide an additionalpatent grant.

Have fun!