Quickstart Project to setup "Android Native" app Software Testing Automation Environment (Based on Smart Testing Automation Framework, Version 5.x.x)

This is a maven based quickstart project to start working on sofwtare testing automation. If you have 30 minutes (Based on your network speed) you can setup software testing environment and start writing the software testing automation related test cases. This quickstart project is based on smart-testauto-framework library present on the following path:

https://github.com/mkrishna4u/smart-testauto-framework

This project is using following software tools:

> NodeJS: This is a javascript based SDK that has two tools node and npm. Download URL: https://nodejs.org/en/download/		
> Appium Server: This is a driver / server that communicates with application to perform operations like click, typeText etc. Use following command to install appium server
	> npm install -g appium
	
> Appium Inspector: Used to inspect the element to create page object classes. Download URL - https://github.com/appium/appium-inspector
> Android Studio for Virtual Devices / Emulators: Download URL - https://developer.android.com/studio
> Java JDK: Download URL - http://jdk.java.net/ : Used to compile and run Java code.
> Apache Maven: Download URL - https://maven.apache.org/download.cgi : Used as a build tool to setup project dependencies, compile code and run testcases.

Install all the tools on your PC and change the set-env.cmd file to set the correct path for environment variables.

Steps to setup project environment:

A. Checkout project on your computer from Github

*   smart-testauto-quickstart-android-native-java

B. Download Sikuli OCR Data files from the link https://github.com/tesseract-ocr/tessdata_best and place in ./test-config/sikuli-config/tessdata

tessdata
|-	eng.traineddata (or any trained data file)
|- configs
	|- api-config
	|- txt
	|- etc..

C. Start Android Virtual Device with Android Version: 9.0 (that has calculator) using Android Studio menu item Tools -> AVD Manager. If device didn't configured then configure one with android version 9.0.

D. Start Appium Server using the command below:

> startAppiumServer.cmd

E. Then run the following command to execute the test scenarios (Written in Cucumber).

> mvn clean verify -Dcucumber.filter.tags="@RegressionTest"
OR
> runRegressionTests.cmd

NOTE: Test execution HTML reports are placed on the following directory:

test-results\cucumber-html-reports

F. To re-generate only HTML reports manually, use the following commands:

mvn verify -DskipTests=true

G. If you would like to inspect the elements from application to create page object (PO) classes, use the following command:

> startAppiumInspector.cmd

How to connect with relational database?

1. Add particular JDBC library in pom.xml file 
2. Create a database profile in test-config/apps-config/<app-name>/database-profiles directory

Code writing instructions:

1. Place cucumber feature files in cucumber-testcases/ directory

2. Place sikuli resources like images in sikuli-resources/ directory

3. Place test data like excel, csv, txt, files etc in test-data/ directory

4. Write page objects in src/main/java/page_objects

5. Write validators code in src/main/java/validators

6. Write test step definitions (*StepDefs.java) and test execution code (*Test.java) code in src/test/java/stepdefs/features directory

7. To run the regression test, use the following command:

   • mvn clean verify -Dcucumber.filter.tags="@RegressionTest" OR
   • runRegressionTests.bat

NOTE: Test execution HTML reports are placed on the following directory:

test-results\cucumber-html-reports

License

Apache License, 2.0