mirror of
https://github.com/appium/appium.git
synced 2026-05-01 07:51:30 -05:00
Jonathan Lipps
949b7de5ad
* add more comprehensive getting started guide * fix language based on review feedback
120 lines
5.5 KiB
Markdown
120 lines
5.5 KiB
Markdown
## Appium
|
|
|
|
[](https://npmjs.org/package/appium)
|
|
[](https://david-dm.org/appium/appium)
|
|
[](https://david-dm.org/appium/appium#info=devDependencies)
|
|
|
|
[](https://npmjs.org/package/appium)
|
|
[](http://issuestats.com/github/appium/appium)
|
|
[](http://issuestats.com/github/appium/appium)
|
|
|
|
[](https://team-appium.ci.cloudbees.com/job/Appium/)
|
|
[](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fappium%2Fappium?ref=badge_shield)
|
|
|
|
Appium is an open source, cross-platform test automation tool for native,
|
|
hybrid and mobile web and desktop apps. We support simulators (iOS), emulators
|
|
(Android), and real devices (iOS, Android, Windows, Mac).
|
|
|
|
Want to skip straight to the action? Check out our [getting
|
|
started](/docs/en/about-appium/getting-started.md) doc.
|
|
|
|
### Supported Platforms
|
|
|
|
Appium supports app automation across a variety of platforms, like iOS,
|
|
Android, and Windows. Each platform is supported by one or more "drivers",
|
|
which know how to automate that particular platform. Choose a driver below for
|
|
specific information about how that driver works and how to set it up:
|
|
|
|
* iOS
|
|
* The [XCUITest Driver](/docs/en/drivers/ios-xcuitest.md)
|
|
* (DEPRECATED) The [UIAutomation Driver](/docs/en/drivers/ios-uiautomation.md)
|
|
* Android
|
|
* (BETA) The [Espresso Driver](/docs/en/drivers/android-espresso.md)
|
|
* The [UiAutomator2 Driver](/docs/en/drivers/android-uiautomator2.md)
|
|
* (DEPRECATED) The [UiAutomator Driver](/docs/en/drivers/android-uiautomator.md)
|
|
* (DEPRECATED) The [Selendroid Driver](/docs/en/drivers/android-selendroid.md)
|
|
* The [Windows Driver](/docs/en/drivers/windows.md) (for Windows Desktop apps)
|
|
* The [Mac Driver](/docs/en/drivers/mac.md) (for Mac Desktop apps)
|
|
|
|
### Why Appium?
|
|
|
|
1. You don't have to recompile your app or modify it in any way, due
|
|
to use of standard automation APIs on all platforms.
|
|
2. You can write tests with your favorite dev tools using any
|
|
[WebDriver](https://w3c.github.io/webdriver/webdriver-spec.html)-compatible
|
|
language such as Java, Objective-C, JavaScript (Node), PHP, Python, Ruby,
|
|
C#, Clojure, or Perl with the Selenium WebDriver API and [language-specific
|
|
client libraries](/docs/en/about-appium/appium-clients.md).
|
|
3. You can use any testing framework.
|
|
4. Appium has built-in mobile web and hybrid app support. Within the same
|
|
script you can switch seamlessly between native app automation and webview
|
|
automation, all using the WebDriver model that's already the standard for
|
|
web automation.
|
|
|
|
Investing in the
|
|
[WebDriver](https://w3c.github.io/webdriver/webdriver-spec.html) protocol means
|
|
you are betting on a single, free and open protocol for testing that has become
|
|
a web standard. Don't lock yourself into a proprietary stack.
|
|
|
|
For example, if you use Apple's XCUITest library without Appium you can only
|
|
write tests using Obj-C/Swift, and you can only run tests through Xcode.
|
|
Similarly, with Google's UiAutomator or Espresso you can only write tests in
|
|
Java. Appium opens up the possibility of true cross-platform native app
|
|
automation, for mobile and beyond. Finally!
|
|
|
|
If you're new to Appium, or want a fuller description of what this is all
|
|
about, please read our [Introduction to Appium
|
|
Concepts](/docs/en/about-appium/intro.md).
|
|
|
|
### Requirements
|
|
|
|
Your environment needs to be set up for the particular platforms that you want
|
|
to run tests on. Each of the drivers above documents the requirements for their
|
|
particular brand of automation. At a minimum, you will need to be able to run
|
|
Node.js 6+.
|
|
|
|
### Get Started
|
|
|
|
Check out our [Getting Started](/docs/en/about-appium/getting-started.md) guide
|
|
to get going with Appium.
|
|
|
|
There is also a repository that contains [many examples of tests in a variety
|
|
of different languages](https://github.com/appium/sample-code)!
|
|
|
|
### Documentation
|
|
|
|
For prettily-rendered docs, please visit [appium.io](http://appium.io). You can
|
|
always find the full list of Appium doc pages at [Appium's GitHub
|
|
Repo](https://github.com/appium/appium/tree/master/docs/en/) as well.
|
|
|
|
### Contributing
|
|
|
|
Please take a look at our [contribution documentation](CONTRIBUTING.md)
|
|
for instructions on how to build, test and run Appium from source.
|
|
|
|
### Roadmap
|
|
|
|
Interested in where Appium is heading in the future? Check out the [Roadmap](ROADMAP.md)
|
|
|
|
### Project History, Credits & Inspiration
|
|
|
|
* [History](http://appium.io/history)
|
|
* [Credits](/docs/en/contributing-to-appium/credits.md)
|
|
|
|
### User Forums
|
|
|
|
Announcements and debates often take place on the [Discussion
|
|
Group](https://discuss.appium.io), be sure to sign up!
|
|
|
|
### Troubleshooting
|
|
|
|
We put together a [troubleshooting
|
|
guide](/docs/en/writing-running-appium/troubleshooting.md). Please have a look
|
|
here first if you run into any problems. It contains instructions for checking
|
|
a lot of common errors and how to get in touch with the community if you're
|
|
stumped.
|
|
|
|
### License
|
|
|
|
[](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fappium%2Fappium?ref=badge_large)
|