Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page


On this page:

Table of Contents

Include Page

Quantum components

  •  Git

  •  Maven

  •  TestNG

  •  Cucumber

Include Page

Perfecto environment setup for users

The following items must be set up beforehand on all workstations.

UI Expand
titleLab credentials and logins
  1. Contact your system administrator and request a username for Perfecto. You will receive a username, password, and the URL of your Perfecto cloud.
  2. Open a browser and navigate to the URL.
  3. After you log in, under Manual Testing, click OPEN DEVICE.
  4. If this step fails, contact your system administrator or customer success manager.

UI Expand

Install Java JRE and JDK on your workstation. If you are unsure if it is installed, open the command line and type java –version.
If you see something similar to the following, you are good to go. If not, download from and follow the online instructions until you can see Java working from the command line.

UI Expand
titleJava IDE

Writing tests with Perfecto requires writing Selenium/Appium code in an IDE. We will cover this in the training. For now, all you need is select and set up the IDE of your choice.

Perfecto supports the major IDEs in the market, Eclipse and IntellijIDEA. Both offer the same functionality.

To set up your IDE, select the IDE you prefer and follow the IDE-specific instructions:

titleIntellij IntelliJ IDEA
  1. Download and install the free community edition:
  2. Open IntelliJ and validate that it opens without errors.

  1. Download Eclipse from
  2. Open Eclipse and validate that it opens without errors.

UI Expand
titleQuantum | Maven and plugins

We now need to prepare the Quantum framework setup. For comprehensive information on Quantum, see our Quantum Starter Kit on GitHub.

To prepare the Quantum setup:

  1. Download and install Maven from
  2. Continue based on your IDE:

    titleIf you use IntelliJ
    1. Open File > Settings.
    2. Select Plugins and install the following plugins:

    titleIf you use Eclipse

    Install the following plugins:

    These plugins are all part of the Eclipse marketplace. To open the Installation window, simply drag them into Eclipse.

UI Expand
titleQuantum | Setup
  1. Go to the Quantum Starter Kit at and click Code > Clone (Git users only) or Code > Download ZIP.
  2. Open the project as a Maven project. Users familiar with Maven can do this and skip to the next section. If you are new to Maven, perform the following steps for your IDE.

    1. Go to the directory where you saved the project and right-click the pom.xml file.
    2. Select Open with > IntelliJ.
      The project should now be open in IntelliJ.
    3. In IntelliJ, verify that the project is defined as a Maven project: Right-click empty space in the Project explorer and select Run Maven > Reimport.
      IntelliJ reimports the project. If all goes well, there will be no notification.
    4. If Maven is not listed as an option in the shortcut menu:
      1. Validate the Maven installation and the plugins.
      2. Restart IntelliJ before trying again.

    1. Open Eclipse and go to File > Import > Maven > Existing Maven Projects.
    2. Click Next and browse to the root directory of the Quantum Starter Kit.
    3. Make sure the project file is selected and click Finish.
      You should now see all the project files in the navigator.

UI Expand
titleRun your first test

We now have an IDE installed, and our project is open. Next, we need to add credentials and run our first test, as follows:

  1. In the resources folder, open the file.
  2. Insert the name of your Perfecto cloud.

    Code Block

  3. Insert your security token into the code. The security token is the authentication used by Perfecto. To generate a token, see Generate security tokens.

    Code Block

  4. Under src > main >resources > config, right-click the testng_appium.xml file and select Run As > TestNG Suite.

    The setup test should execute successfully, and the console log should include a link to the execution report labeled REPORTIUM URL.
  5. Open the report.

That's it! Your Quantum framework is set up and ready to go.

UI Expand
titleAppium Desktop
Working with native applications requires you to utilize Appium Inspector. For instructions on working with Appium Inspector, including information on the supported versions, see Appium Inspector.

UI Expand

Selenium and Appium scripts work with objects that are identified with an XPath expression. We will cover this extensively in the training. Right now, all we need to do is ensure you have the Google Chrome browser installed, which provides built-in support for XPath.

You are now all set up with a working environment! We look forward to meeting you in the training.

Include Page