caner a2cd003bd7 增加WDA 8 months ago
..
.github a2cd003bd7 增加WDA 8 months ago
Configurations a2cd003bd7 增加WDA 8 months ago
Fastlane a2cd003bd7 增加WDA 8 months ago
PrivateHeaders a2cd003bd7 增加WDA 8 months ago
Scripts a2cd003bd7 增加WDA 8 months ago
WebDriverAgent.xcodeproj a2cd003bd7 增加WDA 8 months ago
WebDriverAgentLib a2cd003bd7 增加WDA 8 months ago
WebDriverAgentRunner a2cd003bd7 增加WDA 8 months ago
WebDriverAgentTests a2cd003bd7 增加WDA 8 months ago
azure-templates a2cd003bd7 增加WDA 8 months ago
ci-jobs a2cd003bd7 增加WDA 8 months ago
test a2cd003bd7 增加WDA 8 months ago
tmp a2cd003bd7 增加WDA 8 months ago
.azure-pipelines.yml a2cd003bd7 增加WDA 8 months ago
.eslintignore a2cd003bd7 增加WDA 8 months ago
.eslintrc.json a2cd003bd7 增加WDA 8 months ago
.gitignore a2cd003bd7 增加WDA 8 months ago
.mocharc.js a2cd003bd7 增加WDA 8 months ago
.npmrc a2cd003bd7 增加WDA 8 months ago
.releaserc a2cd003bd7 增加WDA 8 months ago
CHANGELOG.md a2cd003bd7 增加WDA 8 months ago
CONTRIBUTING.md a2cd003bd7 增加WDA 8 months ago
Gemfile a2cd003bd7 增加WDA 8 months ago
LICENSE a2cd003bd7 增加WDA 8 months ago
PATENTS a2cd003bd7 增加WDA 8 months ago
README.md a2cd003bd7 增加WDA 8 months ago
index.js a2cd003bd7 增加WDA 8 months ago
package.json a2cd003bd7 增加WDA 8 months ago
tsconfig.json a2cd003bd7 增加WDA 8 months ago

README.md

WebDriverAgent

NPM version Downloads

Release

GitHub license

WebDriverAgent is a WebDriver 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 linking XCTest.framework and calling Apple's API to execute commands directly on a device. WebDriverAgent is developed for end-to-end testing and is successfully adopted by Appium via XCUITest driver.

Features

  • Both iOS and tvOS platforms are supported with devices & simulators
  • Implements most of WebDriver Spec
  • Implements part of Mobile JSON Wire Protocol Spec
  • USB support for devices is implemented via appium-ios-device library and has zero dependencies on third-party tools.
  • Easy development cycle as it can be launched & debugged directly via Xcode
  • Use Mac2Driver to automate macOS apps

Getting Started On This Repository

You need to have Node.js installed for this project.

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

More about how to start WebDriverAgent here.

Known Issues

If you are having some issues please checkout wiki 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.

Creating Bundles

npm run bundle

Then, you find WebDriverAgentRunner-Runner-sim-<version>.zip for iOS and WebDriverAgentRunner-Runner-tv_sim-<version>.zip for tvOS files in the current directory.

License

WebDriverAgent is BSD-licensed. We also provide an additional patent grant.

Third Party Sources

WebDriverAgent depends on the following third-party frameworks:

These projects haven't been maintained in a while. That's why the source code of these projects has been integrated directly in the WebDriverAgent source tree.

You can find the source files and their licenses in the WebDriverAgentLib/Vendor directory.

Have fun!