Maven Tutorial For Selenium Test Automation | LambdaTest

Image for post
Image for post

While working on a project for test automation, you’d require all the Selenium dependencies associated with it. Usually these dependencies are downloaded and upgraded manually throughout the project lifecycle, but as the project gets bigger, managing dependencies can be quite challenging. This is why you need to build automation tools such as Maven to handle them automatically.

Maven can be more specifically defined as a software project management tool that uses the concepts of the project object model (POM). It enables the user to create an initial folder structure, perform compilation and testing and then package and deploy the final product. It efficiently cuts down several steps followed in the build process and rather makes the build a one-step process.

In this Selenium Maven tutorial, I’ll explain what Maven is and why Maven is important as a build automation tool. Further, I’ll show you how to install Maven for your Selenium test automation projects and running your first project in this Selenium Maven tutorial.

Why Use Maven?

Some of the key reasons Maven is used are:

  • It simplifies the build process & provides a uniform system
  • It handles compilation, distribution, dependency management and other tasks efficiently.
  • It increases reusability.
  • It reduces the steps like adding jar files to the project library, building reports, executing Junit test cases, creating jar/war/ear files for deployment.
  • It has a repository that is centralized that manages jar files.

Now that we know why to use Maven, let’s explore a bigger question in this Selenium Maven tutorial, What is Maven?

Why you need Build Automation Tools for Selenium Automation Testing?

So What Is Maven? Let’s Deep Dive

Maven can be more specifically defined as a software project management tool that uses the concepts of the project object model (POM). It enables the user to create an initial folder structure, perform compilation and testing and then package and deploy the final product. It efficiently cuts down several steps followed in the build process and rather makes the build a one-step process.

Some key terms you should know for this Selenium Maven tutorial:

Maven Local repository: It is a local repository in the developer’s machine which holds all the project artifacts. On executing a Maven build, all the project dependent jars are downloaded into the local repository.

Maven Central Repository: It is a default repository in every new project which is official to Maven. Whenever any dependency is not present in local repository Maven automatically consults the central repository to download it.

Project Object Model: POM XML contains project information and configuration details used by Maven build. It is located in the root directory of each project. A sample POM looks like below:

Image for post
Image for post

Dependency: Any library on which a java project is dependent on, to run or build is called a dependency. Examples: Log4j jars, Apache Poi jars, Selenium Jars, etc. Dependencies are mentioned in pom.xml as below:

Image for post
Image for post

Surefire PlugIn: To execute the unit tests of an application during the test phase of the build lifecycle one can use the Surefire Plugin. A surefire report is available in two file formats, viz Plain text file(.txt) and XML file(.xml). This plugin is a must to use as it helps Maven identify tests even when using TestNG or Junit frameworks.

How to Install Maven In Windows?

How To Install Maven in Eclipse IDE?

Step 1: Click on Help from the top menu in Eclipse and select ‘Install New Software’.

Step 2: On the newly opened window, click on the Add button.

Image for post
Image for post

Step 3: In the name text box type “Maven”, and in the location text box type “http://download.eclipse.org/technology/m2e/releases/". This URL is the location from where Maven can be downloaded.

Image for post
Image for post

Step 4: A check-box will appear in the pop window, Check the check-box and click on the Next button.

Step 5: Wait for a few minutes for the window to complete its process.

Step 6: Keep the default settings and click on the Next button.

Step 7: Accept the Terms & Conditions and click on Finish.

Step 8: Wait for the installation to finish.

Step 9: Once the installation is finished, it will ask you to restart your eclipse. Click on Yes so as to see the changes being reflected.

Boom! This is it. You’ve now installed Maven successfully to your Eclipse IDE.

Just in case you want to go around the other way of installing through the command line, please follow the below steps.

How To Install Maven Through Command Line?

Step 1: Download & Install Java

To check the java version of your system, please go running and type ‘cmd’ to launch the command prompt. Type ‘Java -version’ and press Enter to see which java version is installed.

Step 2: Set Up Java Environment Variable

  1. Go to This PC and right-click on the empty space anywhere within and select Properties
  2. Click on Advanced System Settings so that a new pop up opens up.
  3. Now, from the pop-up window click on Environment Variables
  4. Click on the New button under System variables.
Image for post
Image for post

5. Type “JAVA_HOME” in the Variable name box and ‘C:\Program Files\Java\jdk1.8.0_20’ JDK path in the Variable value box and save the same.

Image for post
Image for post

6. You can now see the newly created Java variable under ‘System Variables’

Image for post
Image for post

Step 3: Download Maven and Set Up Maven Environment Variable

Image for post
Image for post

2. Extract it to some location in your machine as per your convenience. For me it is lying at ‘C:/apache-Maven-3.6.1’

3. You can set up the Maven Environment Variable similar to how we set up the Java Environment Variable in steps above.

4. Type ‘Maven_HOME’ in the Variable name box and ‘C:\apache-Maven-3.6.1’ in the Variable value box.

Image for post
Image for post

5. You’ll now be able to see the newly created Maven variable under ‘System Variables’.

Image for post
Image for post

Step 4: Updating the Path Variable

  1. Open system properties through My Computer.
  2. Navigate to ‘Advanced System Settings’.
  3. Click on ‘Environment Variables’.
  4. Click on the Edit button under user variables.
  5. Type ‘PATH’ in the Variable name box & ‘C:\apache-Maven-3.6.1\bin’ in the Variable value box.
Image for post
Image for post

Step 5: Testing the Maven Installation

Now you’re all set with Maven Installation now and can go ahead with creating projects using Maven.

Create your First Maven Project

Creating Maven Project with Eclipse IDE

Step 1: Create a new project from the Eclipse IDE.

Step 2: From the new project window expand Maven and select Maven Project and then click on Next.

Step 3: You may create a simple project or just let go of this option. For now, we’ll use a simple project which would create a simple Maven-enabled Java project.

Image for post
Image for post

Step 4: Now upon clicking Next you’ll need to type information of the Maven project is created. You may refer below descriptions to fill in the values:

Group Id- corresponds to your organization’s name.
Artifact Id- refers to the project name.

The version can be chosen flexibly. If your project does not have any parent dependencies, you don’t need to fill in the project dependencies. Just fill in the appropriate information and click on ‘Finish’.

Image for post
Image for post

Step 5: Your Maven project has now been created!

Image for post
Image for post

Note: Java code is placed in /src/main/java, resources are kept in /src/main/resources, testing code is placed in /src/test/java and the testing resources are placed in /src/test/resources.

Step 6: You may now open the pom.xml to view the structure set up by Maven. You’ll see all the information that we entered in ‘step 4’ here. You can use the tabs at the bottom to change the view. The pom.xml tab has the pom XML code for the Maven project.

Image for post
Image for post
Image for post
Image for post

The Maven Project is now ready to be used.

Next, let us see how we can create a Maven project using Command-Line.

Step 1: Open a Command Prompt and navigate to the folder where you want to set up your project. Once navigated, type below command:

mvn archetype:generate -DgroupId=demoProject -DartifactId=DemoMavenProject -DarchetypeArtifactId=Maven-archetype-quickstart -DinteractiveMode=false

Here, DgroupId is the organization name, DartifactId is the project name and DarchetypeArtifactId is the type of Maven project.

On clicking Enter, your Maven project will be created.

Image for post
Image for post

Step 2: You can go to the project location to see the newly created Maven project. You can open the pom.xml file, which is in the project folder, by default the POM is generated like this:

Image for post
Image for post

Step 3: You can view the default folder structure of your Maven project.

Image for post
Image for post

Now that we know how to create a Maven project, let’s try to integrate Selenium with Maven. But before we do that, we need to understand the various Dependencies that would help with this integration.

Selenium Maven Dependency For Your Automation Project

<dependency>
<groupId>org.Seleniumhq.Selenium</groupId>
<artifactId>Selenium-java</artifactId>
<version>4.0.0-alpha-1</version>
</dependency>

On adding the above Selenium Maven dependency, Maven will download the Selenium java library into our local Maven repository.

There is another Selenium Maven dependency that can be added to pom.xml based on the requirement. Few examples that you might have to use in our Selenium project are :

TestNG Selenium Maven Dependency:

<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<version>6.14.3</version>
<scope>test</scope>
</dependency>

Apache POI Selenium Maven dependency:

You can add these Selenium Maven dependencies in your pom.xml as shown below:

In case you want to validate how these Selenium Maven dependency import the required libraries, you’ll have to go back to the demo project and see what libraries are present by default. For doing the same you need to right-click on your project name and Configure the Build Path for you project and check under the Libraries tab of the newly opened window:

Image for post
Image for post

Here you can see the default libraries present in your project for this Selenium Maven tutorial.

For a much clearer vision, I’ll create a sample class to use Selenium components and some testNG annotations. Please note that I’ll create the sample test class under the src/test/java folder of our project structure. You can clearly see below that the error correction can be done after adding the libraries.

Image for post
Image for post

So, now rather than manually adding libraries by configuring the project build path in this Selenium Maven tutorial, I’ll write the dependencies for the project in pom.xml, and Maven will directly download those from its repository. This saves the trouble of doing it manually and reducing the chance of missing out on adding some of the jars. So, here is how you add the dependencies:

The pom.xml before the Selenium Maven dependency is added:

Image for post
Image for post

Pom.xml after the Selenium Maven dependency is added:

Image for post
Image for post

After you have saved and refreshed your project, check the build path and see the Selenium and testNG libraries being added Selenium Maven dependency.

Image for post
Image for post

Also, you can now go to your test class and see the different options to correct the error thrown in this Selenium Maven tutorial:

Image for post
Image for post

You can simply Import the WebDriver and you’d be good to go. Similarly for @Test annotation just import the testng.annotations.

Image for post
Image for post

You can add more dependencies like apache POI, extent reporting, commons email, or anything that might be specific to your project in a similar fashion to your pom.xml.

Now that I am done with configuring the project, I’ll run the project to see if the tests work fine.

Maven Lifecycle In Selenium

Open a command line in your system and type mvn and then Enter.

Image for post
Image for post

You can see a Build failure message with error being displayed saying that no goal has been defined in this Selenium Maven tutorial. As you parse through this message you can see the different goals that can be defined for our Maven project. I’ll quickly go through these default goals before going into detail about the goals required for the Selenium project.

  1. validate: would check if our project is correct and all the required information available
  2. compile: would compile the project source code
  3. test: would unit test the compiled source code of our project
  4. package: would package the compiled code into the distributable formats, like JAR
  5. integration-test: would deploy the package into an environment where we would run the integration tests
  6. verify: would verify if the package is valid
  7. install: would locally install the package
  8. deploy: would be used in integration or release environment by copying the final project into a remote repository where it can be accessed by other projects or developers
  9. clean: cleans up previous build artifacts
  10. site: creates site documentation for the project

Of the above-said default goals, three are crucial for Selenium test automation. There are clean, install, and tests.

You can either use these goals alone or use it as a combination like clean-install for this Selenium Maven tutorial.

Clean- It would clean the target folder, i.e. the folder where the previous build’s libraries, build files(war, tar or jar files), reports, output files, etc are saved. On executing mvn -clean this target folder will be deleted.

Install- It would install all the dependencies, in case of missing jars, and create the deployment file(war/jar files in case of JAVA) and then it’ll run the test.

Test- It will simply run the test without creating any deployment file.

When using Eclipse IDE, you can directly use any of these three goals by right-clicking on your pom.xml, then Run As and selecting any of the options.

Maven Clean

Image for post
Image for post

So here the task of clean, which is to delete the target folder has been successfully completed and hence our Build is successful.

Maven Install

Upon adding this piece, your pom.xml would look like below:

Image for post
Image for post

Now, go to Maven Install just like you did for Maven Clean in this Selenium Maven tutorial and observe the console output for the build installation:

Image for post
Image for post
Image for post
Image for post
Image for post
Image for post

You can see in the console output that the Maven installer executed the tests as well. To see the installed directories in your local system you refresh your project and see the directories generated. In the below snapshot you can see all the files generated(a jar file as well since this is a simple JAVA program) as a result of Maven install. You can share this jar file directly for others to execute.

Image for post
Image for post

Maven Test

Image for post
Image for post

The above steps show how execution can be done through Eclipse IDE, but in real-time project execution is done mostly through the command line So now we would use these goals from the command line. Before proceeding onto these tasks make sure that your current working directory in cmd points to your local workspace location. If we do not do so our Maven command would not be able to find the desired pom.xml and hence our Selenium test automation build would fail.

Let us first do the Maven Clean using the command prompt in this Selenium Maven tutorial. We simply need to write ‘mvn clean’:

Image for post
Image for post

You can see the target folder getting deleted. The next step in this Selenium Maven tutorial is to do Maven install which is done by typing ‘mvn install’ in the command prompt.

Image for post
Image for post
Image for post
Image for post
Image for post
Image for post

You can see the console output is almost similar to what was there through Eclipse execution. Let us now perform a Maven test by typing ‘mvn test’ which would result in the test being executed without building jar files.

Image for post
Image for post

Now that you know the basic goals for executing our automation test you’re good to go to run your automation scripts through Maven!

Maven Surefire Plugin

Your pom.xml should look like below:

Image for post
Image for post

Here I’ve put in testng.xml in src/main/resources and thereby giving its path in properties.

Now I’ll run Maven test from eclipse in this Selenium Maven tutorial and see the results:

Image for post
Image for post

You can now check the reports that have been generated by default and in a similar way by typing ‘mvn test’ can execute this suite from the command prompt.

Image for post
Image for post

All In All

This pretty much sums up everything you need to know to get started with Maven in this Selenium Maven tutorial. Do reach out to us in case of any questions or doubts. Also, I’d appreciate it if you could help us share this article and retweet it. That’s all for now. Happy Testing!!! 😊

Originally published at LambdaTest

Author Rahul Rana

Image for post
Image for post

Written by

Product Growth at @lambdatesting (www.lambdatest.com)

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store