Skip to content

Getting started

  • Install and configure JDK 11+
  • Install and configure Apache Maven 3.6.0+
  • Download the latest version of Eclipse and install TestNG plugin, maven-dependency-plugin connector and optionally lombok

Generating project

The easiest way to initialize a new project is to use Carina archetype, you will get correct project structure along with test samples. Run below command from any empty folder:

mvn archetype:generate -DarchetypeGroupId=com.qaprosoft \
                       -DarchetypeArtifactId=carina-archetype \
                       -DarchetypeVersion=RELEASE \
                       -DgroupId=<your_groupId> \
                       -DartifactId=<your_artifactId> \
                       -Dname="<you_project_name>" \
                       -Durl=<your_project_url> \
                       -Dversion=<your_project_version>

If any attribute contains spaces, it should be set in quotes (e.g.: -Dname="Hello World"). In the above Maven command you need to specify 5 attributes, while the first 3 should be left unchanged:

Attribute Meaning Example
-DgroupId Company domain in reverse order com.mycompany
-DartifactId Java project name project-qa
-Dname Name with more details "Test Automation Project"
-Durl Company URL http://mycompany.com
-Dversion Project version 1.0

Import to Eclipse

If the generation is successfully complete, you will see a new project folder with a name equal to the artifactId attribute specified during the generation, so navigate to this folder (where pom.xml is located) and execute the following Maven task:

mvn clean eclipse:eclipse

By executing this command, Maven should resolve all dependencies, downloading the required libraries to your local repository and generating the Eclipse classpath. Before importing a new project to Eclipse, you should link your IDE to your Maven repository by executing the following task:

mvn -Declipse.workspace=<path_to_workspace> eclipse:configure-workspace

Here you need to specify the absolute path to the Eclipse workspace. After that, restart Eclipse IDE. Now you can import generated projects such as "Existing Java Project" into Eclipse IDE.

Eclipse view