Appium

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 gettingstarted 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.

Please refer to Appium Platform Support for more details.

Why Appium?

1. You don't have to recompile your app or modify it in any way, dueto the use of standard automation APIs on all platforms.
2. You can write tests with your favorite dev tools using anyWebDriver-compatiblelanguage such as Java, Objective-C, JavaScript (Node), PHP, Python, Ruby,C#, Clojure, or Perl with the Selenium WebDriver API and language-specificclient libraries.
3. You can use any testing framework.
4. Appium has built-in mobile web and hybrid app support. Within the samescript, you can switch seamlessly between native app automation and webviewautomation, all using the WebDriver model that's already the standard forweb automation.

Investing in theWebDriver protocol meansyou are betting on a single, free, and open protocol for testing that has becomea web standard. Don't lock yourself into a proprietary stack.

For example, if you use Apple's XCUITest library without Appium you can onlywrite 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 inJava/Kotlin. Appium opens up the possibility of true cross-platform native appautomation, for mobile and beyond. Finally!

If you're new to Appium or want a more comprehensive description of what this is allabout, please read our Introduction to AppiumConcepts.

Requirements

Your environment needs to be set up for the particular platforms that you wantto run tests on. Each of the drivers above documents the requirements for theirparticular brand of automation. At a minimum, you will need to be able to runNode.js 12+.

Get Started

Check out our Getting Started guideto get going with Appium.

There is also a sample code that contains many examples of tests in a varietyof different languages!

Documentation

For prettily-rendered docs, please visit appium.io. You canalways find the full list of Appium doc pages at Appium's GitHubRepo as well.

update-appium-io.yml creates a PRby CI job.in the appium.io repository with the documentation update.

Once the PR has been merged, the latest documentation will be in appium.io

Contributing

Please take a look at our contribution documentationfor instructions on how to build, test, and run Appium from the source.

Roadmap

Interested in where Appium is heading in the future? Check out the Roadmap

Project History, Credits & Inspiration

• History
• Credits

User Forums

Announcements and debates often take place on the DiscussionGroup, be sure to sign up!

Troubleshooting

We put together a troubleshootingguide. Please have a lookhere first if you run into any problems. It contains instructions for checkinga lot of common errors and how to get in touch with the community if you'restumped.

License