This project is based on Ardesco's Selenium-Maven-Template with some handy added extras for getting started quickly with Selenium and Appium.
The easiest way to get starting is by using bootstrapium-vagrant to create a VM with Bootstrapium and its dependencies pre-installed.
If you do not wish to use Vagrant then clone this project and ensure PhantomJS and chrome-driver are on your path.
Open the bootstrapium
directory in a terminal window/command prompt and run mvn clean verify
to run the example tests using PhantomJS.
Want to run the tests on a different browser? No problem, just provide the 'browser' argument:
mvn clean verify -Dbrowser=chrome
All you need to do is ensure the browser is installed in the default location (bootstrapium-vagrant pre-installs Firefox and Chrome).
Running mobile web tests using Appium on Sauce Labs is only slightly more involved:
export SAUCE_USERNAME=<username>
export SAUCE_ACCESS_KEY=<access_key>
mvn clean verify -Dplatform=ios -Dbrowser=safari -Dsauce=true
A full list of arguments can be found on the project wiki.
After running your tests, you can generate an Allure test report by simply running:
mvn site
Bootstrapium sets you up for other stuff too - check out the project wiki for further info.