Skip to content

Boilerplate project to run MOBILE Test Automation with TestNG, Appium, Allure reporting and Momentum Suite cloud device farm support


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



26 Commits

Repository files navigation

Java Appium TestNG Momentumsuite


TestNG Integration with local or Momentum Suite real mobile farm devices


  • Native or Hybrid Android and iOS apps (APK, AAB, IPA)
  • Chrome mobileweb testing on Android devices
  • Safari mobileweb testing on iOS devices
  • Parallel testing on multi mobile devices
  • Local testing or using Momentum Suite's 150+ Android or iOS devices
  • Auto generated HTML Allure test report after test


  • Branch to Appium 2.0 You can visit Click here



  • Java 11+ If you don't have it installed, download it from here.
  • Maven is required to run commands. Download it from here.
  • Install the Allure command-line tool, and process the results directory after test run.

Install the dependencies:

Run the following command in project's base directory :

mvn clean

Getting Started

Getting Started with Appium-Java tests on Momentum Suite couldn't be easier! With a Momentum Suite account, You need 4 things to start without any Appium or Android SDK dependencies.

  • momentum:user Usually it could be your email address
  • momentum:token Your unique access token learned from
  • momentum:gw Comma seperated Momentum Suite mobile device ID list (4 digit number) to run the test. First number will be your default phone for all except parallel-testing.
  • appium:app Your uploaded IPA, APK or AAB app file from Momentum Suite Application Library. Example format is ms:// Optionally you can use a public accessible web URL.

Do not forget to set these 4 Appium capability values and check hostname, port, path and protocol values on your testSettings.json file.

Start with Android device: Open for editing your testSettings.json file under root directory.

Set momentum.user, momentum.token, momentum.deviceList, on testSettings.json file.

Test script is available in getting-started directory

Run the following command in project's base directory :

 mvn clean test -P android-first

Start with iOS device: Same with Android, but need to change testSettings.json file.

Run the following command in project's base directory :

 mvn clean test -P ios-first

Start with local testing: Use Local testing that access resources hosted in your development or testing environments. You need to install Appium and it's all dependencies like Android SDK, Xcode, Command Line tools. At the same sime you will need to run a real device or simulator/emulator. Do not forget to check hostname, port, path and protocol values on your test-settings.js file with your own Appium server.

Run the following command in project's base directory :

 mvn clean test -P android-local

All available commands to start mobile testing:

mvn clean test -P android-first
mvn clean test -P android-local
mvn clean test -P android-parallel
mvn clean test -P android-chrome
mvn clean test -P ios-first
mvn clean test -P ios-local
mvn clean test -P ios-parallel
mvn clean test -P ios-safari

Allure Reporting

Run the following command in project's base directory after test run has been completed. This command will open a browser window with HTML test results.

allure serve allure-results

Getting Help

If you are running into any issues or have any queries, please check Momentum Suite Contact page or get in touch with us.

Our Technical Documentation space is here.


No releases published


No packages published