Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/facebookarchive/WebDriverAgent

A WebDriver server for iOS that runs inside the Simulator.
https://github.com/facebookarchive/WebDriverAgent

Last synced: 2 days ago
JSON representation

A WebDriver server for iOS that runs inside the Simulator.

Host: GitHub
URL: https://github.com/facebookarchive/WebDriverAgent
Owner: facebookarchive
License: other
Archived: true
Created: 2015-09-03T11:00:00.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2019-12-26T02:25:02.000Z (almost 5 years ago)
Last Synced: 2024-05-19T09:14:45.120Z (6 months ago)
Language: Objective-C
Size: 15.3 MB
Stars: 4,127
Watchers: 237
Forks: 1,331
Open Issues: 180
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-iOS-security - WebDriverAgent
awesome - facebookarchive/WebDriverAgent - A WebDriver server for iOS that runs inside the Simulator. (Objective-C)

README

        # WebDriverAgent [![GitHub license](https://img.shields.io/badge/license-BSD-lightgrey.svg)](LICENSE) [![Build Status](https://travis-ci.org/facebook/WebDriverAgent.svg?branch=master)](https://travis-ci.org/facebook/WebDriverAgent) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

WebDriverAgent is a [WebDriver server](https://w3c.github.io/webdriver/webdriver-spec.html) 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 linking `XCTest.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 by [Appium](http://appium.io).

## Archiving

We are archiving WebDriverAgent. Thanks to the community who have used it! The code will remain here for your future use, but will no longer be actively supported by Facebook.

In May 2019, we open sourced IDB, “iOS Development Bridge”, a command line interface for automating iOS Simulators and Devices. We are currently migrating our own internal projects from WDA to IDB, and suggest checking it out as an alternative. 

More information on IDB:

 * [Project on GitHub](https://github.com/facebook/idb/)

 * [Talk from 2019 F8](https://developers.facebook.com/videos/2019/reliable-code-at-scale/)

## Overview

WebDriverAgent is a [WebDriver server](https://w3c.github.io/webdriver/webdriver-spec.html) 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 linking `XCTest.framework` and calling Apple's API to execute commands directly on a device. WebDriverAgent was developed and used at Facebook for end-to-end testing and is successfully adopted by [Appium](http://appium.io).

## Features

 * Works with device & simulator

 * Implements most of [WebDriver Spec](https://w3c.github.io/webdriver/webdriver-spec.html)

 * Implements part of [Mobile JSON Wire Protocol Spec](https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md)

 * [USB support](https://github.com/facebook/WebDriverAgent/wiki/USB-support) for devices

 * Inspector [endpoint](http://localhost:8100/inspector) 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

[![Demo Video](https://j.gifs.com/gJymG9.gif)](https://youtu.be/EatiYGFxBxY)

## Getting Started

To get the project set up just run bootstrap script:

```

./Scripts/bootstrap.sh

```

It will:

* fetch all dependencies with [Carthage](https://github.com/Carthage/Carthage)

* build Inspector bundle using [npm](https://www.npmjs.com)

After it is finished you can simply open `WebDriverAgent.xcodeproj` and start `WebDriverAgentRunner` test

and start sending [requests](https://github.com/facebook/WebDriverAgent/wiki/Queries).

More about how to start WebDriverAgent [here](https://github.com/facebook/WebDriverAgent/wiki/Starting-WebDriverAgent).

## Known Issues

If you are having some issues please checkout [wiki](https://github.com/facebook/WebDriverAgent/wiki/Common-Issues) first.

## For Contributors

If you want to help us out, you are more than welcome to. However please make sure you have followed the guidelines in [CONTRIBUTING](CONTRIBUTING.md).

## License

[`WebDriverAgent` is BSD-licensed](LICENSE). We also provide an additional [patent grant](PATENTS).

Have fun!