Skip to main content
Get started Working with the TestProject Test Automation Platform
Last Updated Sep 20, 2020 — Continuous Testing Expert

Get started Working with the TestProject Test Automation Platform

Continuous Testing

Test automation is a key component of a software development project. Using test automation, developers test their web and mobile software projects to identify bugs and assess the performance of applications. While large enterprises have the budgets and expertise to test their software on a wide array of platforms, browsers, and devices, small and medium companies don't have that luxury. This is where TestProject IO comes to the rescue.

An overview of TestProject

TestProject is the world's first community-powered cloud platform that offers end-to-end test automation solutions for businesses of all sizes. The platform supports multiple platforms such as iOS, Android, Windows, Mac, Linux, Webservices, etc. It allows you to integrate Selenium and Appium for mobile automation testing purposes.

Though the tool is free and open-source, it is a feature-rich platform. It enables you to schedule your tests on any browser or device and record the tests using a cloud recorder. Using customized reports, you can analyze each test and perform analytics. It can also be integrated into your CI/CD tools such as Jenkins. In addition, you can extend your test project environment with 3rd party tools using REST API and other add-ons.

The tool is simple and easy to install and use. There is a minimal learning curve. It actually removes all the complexities involved in the installation and configuration of mobile automation tools such as Appium. By simply installing a .exe file, you can get access to a wealth of testing resources.

TestProject History and Key Features

TestProject was developed by a vibrant team composed of Vitaly Bukhovsky, Mark Kardashov, Eldar Kravetsky, and Marat Strelets. While the test automation platform was developed in 2015, it was launched for the public in April 2018.

Key Features

  • Use the recorder tool for a codeless test or use TestProject SDK to write your own test scripts.
  • Add team members to your project and seamlessly collaborate with them in real-time.
  • Manage all test projects from a single dashboard.
  • Use the reporting and analytics features to generate different types of test reports.
  • Automate and run test scripts on local as well as remote environments.
  • Integrate the project with your CI/CD tools such as Jenkins and Slack using REST API.
  • Extend the recording feature using various add-ons.

Installation

Step 1: Create an Account

To begin using the tool, create a free account on the website.

Visit the link here: https://testproject.io

Click on the signup link and provide the required details. You will receive a confirmation email. Click on the link to confirm your email and activate your account. After confirming your email, login to the app.

testproject welcome

TestProject offers two options. You can use a codeless recorder or create tests by coding. With the codeless test, you don't need to write a single line of code. You can record actions on your browser and the tool will generate the required Appium and Selenium code. Alternatively, you can write your own code.

Step 2: Install the Agent

After selecting the ‘Create Tests by Coding' option, you need to download and install the TestProject Agent. The next screen will provide the link to download the agent. Select your platform (Windows/Linux/Mac OS X) and download the agent tool.

testproject install

After the tool gets downloaded, double-click it to begin the installation procedure.

testproject setup

Accept the license agreement on the next screen.

test project agreement

On the next screen, choose the components you want to install.

testproject components

On the next screen, choose the installation folder and click next. You can choose to add it to the start menu on the next screen. Click next to begin the installation.

test project installer

After the installation is completed, you will get a message that the Setup was completed successfully. Click Finish.

Now, the agent is successfully installed on your machine.

install done

Step 3: Connect the Agent with the TestProject Platform

After installing the agent on your local machine, you need to connect it with the TestProject platform. To do so, open the agent and it will automatically connect with the servers.

testproject agent registration

Step 4: Acquire the Developer Key

To run test automation scripts on the cloud platform, you need to acquire a developer key. After the agent connects to the server, it will provide a developer key. Copy the key and save it on your machine.

Choose the Software Development Kit (SDK). Test Project offers Java, Python, and C# SDKs.

sdk

Now, the dashboard is ready. You can create tests and run them.

recommended 

Run your First Test

To create your first test, log in to the TestProject platform, and click on New test.

recommended add ons

On the next screen, select the type of test (eg: mobile/web/code). The web is selected for this demo.

Click on Create a new project.

test type testproject

Provide the name and details of the project and click Create.

web testing testproject

Click next. On the next screen, provide a name and description of the test.

web testing testproject

On the next screen, select the web application for testing. When you run the test for the first time, you need to add a new web application. For this demo, the Google site is selected.

testproject google

On the next screen, select the web application (eg; Google1) and click next.

google testproject

On the next screen, you will see 3 options. (Record, Edit, Blank Test). For this demo, let us look at the Record option. With this option, you can directly perform actions on the browser or the device and record the tasks. The tool records the actions and automatically generates the Appium/Selenium code.

what's next

Select Record and click on Start recording.

The TestProject agent will open the browser and open the Google website. In the search box, type ‘Experitest' and press enter. Google will display search results for the keyword ‘Experitest'. Close the browser.

As you perform each action, the tool will automatically create steps and generate code.

testproject code steps

Now, go to the dashboard. You can see the test under your Tests tab. Click on Run. It will run the test.

testproject run

On the next screen, choose the browser of your choice.

agent browsers

Click Next and Run.

The test case will open the Agent browser, open Google, search for Experitest keyword, and closes the browser.

You can check the report to see how the test ran.

trends and reports

On the right side, you can see the actions performed as well. You can also download the PDF to see the full execution report.

test report

So, you can run any number of tests using the record feature without writing a single line of code. You can also download the code that is generated by the tool.

generated code

Click on three dots ‘…' and select the ‘Generate Code' option.

On the next screen, choose the programming language, browser, and the package name and click on Generate.

desired options testproject

When you click on Generate, the code is downloaded in a .zip format.

Writing your own code

While novice users can use the Record option to run tests, advanced users can write their own code using the TestProject SDK. The platforms support three programming SDKs, Java, C#, and Python.

Java SDK is used for this demo.

Here are the steps to run your code using Java SDK.

Step 1: Ensure Java is installed

To run test scripts using Java SDK, you should install Java on your machine. Go to Command Prompt and type the following command to check if Java is installed and running on your machine.

  • Java –version
java

If you don't have Java installed on your machine, you can download and install it from this link:

https://www.oracle.com/in/java/technologies/javase-downloads.html

Step 2: Configure Environment Variables

After java is installed, you need to configure Environment variables in the Advanced System Settings by adding the Java path under ‘User variables' and Java bin folder path under the ‘System Variables'.

Step 3: Install Eclipse

To run your test scripts, you need to install an IDE such as Eclipse, IntelliJ, VS Code etc. You can download and install Eclipse from this link:

https://www.eclipse.org/downloads/

Step 4: Install Build Tool

To automate build processes, you need to install a build tool such as Maven, Gradle or Ant. Visit this link to download Gradle:

https://gradle.org/install/

Step 5: Add Gradle Path to Environment Variables

After downloading Gradle, save it on your machine and add that path to the Environment variables.

Step 6: Log in to TestProject platform

Now, login to the TestProject platform.

Step 7: Start the TestProject Local Agent

Double-click the TestProject local agent and wait till it gets started. You can check in the TestProject dashboard if the agent is running or not.

Step 8: Create your First Test

Now that the test automation environment is ready, you can create your first test.

To do so, open Eclipse. Click on File -> New -> Project

new project

On the next screen, select the Gradle project and click next.

wizard select

Enter a name for the Gradle project and click finish.

gradle project

Now, Eclipse creates a Gradle project. Go to Project Explorer and double-click on the build.Gradle file to open it in the editor window.

build.gradle

Now, add the following code to the build.Gradle file. (Java SDK implementation)

  • implementation 'io.testproject:java-sdk:0.64.0-RELEASE'

eclipe workspace

Now, create a new class under src\test\java.

class

Provide a name and click finish.

class

Now, add the following code to the Java class file (Experitest1.java).

[java] package ExperiGradle; import io.testproject.sdk.drivers.web.ChromeDriver; import org.openqa.selenium.By; import org.openqa.selenium.chrome.ChromeOptions; public class Experitest1 { public static void main(final String[] args) throws Exception { ChromeDriver driver = new ChromeDriver("Enter your Developer key here", new ChromeOptions()); // Navigate to TestProject Example website driver.navigate().to("https://example.testproject.io/web/"); // Login using provided credentials driver.findElement(By.cssSelector("#name")).sendKeys("John Smith"); driver.findElement(By.cssSelector("#password")).sendKeys("12345"); driver.findElement(By.cssSelector("#login")).click(); boolean passed = driver.findElement(By.cssSelector("#logout")).isDisplayed(); if (passed) { System.out.println("Test Passed"); } else { System.out.println("Test Failed"); } driver.quit(); } } [/java]

When you run the test, it will initiate the Chrome browser from the TestProject platform, opens the test website, performs a login task, and closes the browser.

test passed

So, the test has passed. Now, you can write your test scripts and execute them on different browsers and devices offered by the TestProject platform.

Summary

TestProject platform is the world's first community-powered cloud platform for test automation projects. Using this platform, developers can perform test automation on a wide range of platforms, devices, and environments. Built on top of Selenium and Appium, Most importantly, TestProject supports all major browsers and devices. With a large and active community, you can always reach out for help.

Guy Arieli - CTO

More from the Blog

View more
Apr 05, 2021

Build better apps with a low-code development approach

Continuous Testing
From being an option, DevOps is quickly turning into a necessity for m ...
Read More
Mar 29, 2021

Every web and mobile app tester needs these 7 surprising software testing skills

Continuous Testing
If you look at a job listing for QA or test automation professionals, ...
Read More
Mar 24, 2021

Paving the way for better mobile and web application testing orchestration

Continuous Testing
Keeping applications up to date and ensuring they work with all of the ...
Read More
Mar 22, 2021

Effective web & mobile app testing for the modern enterprise

Continuous Testing
The emergence of cloud-based ecosystems and recent global events are f ...
Read More
Contact Us