# Setting up Test Gap Analysis on a Java Application (Pixelitor)
As a developer or tester of a Java desktop application, you may use Teamscale Test Gap Analysis (TGA) to improve your testing effectiveness. This tutorial leads you through the setup of TGA on Pixelitor (opens new window), an open source graphics editor.
# Step 1: Setting up a Teamscale Project
In Teamscale, go to Projects and click New project.
Name the new project
Pixelitor and choose the analysis profile Java Default.
Click Source Code Repository and select Git.
Create a new account named
GitHub with the URI
https://github.com and without credentials.
Set the Path suffix to
cqse/Pixelitor, the Start revision to
2019-10-11 and the branch to
release/4.2.3. We set the start revision and the branch in a way that we can see the test gaps between version 4.2.2 (released on October 11, 2019) and version 4.2.3.
Click Create project.
# Step 2: Downloading Pixelitor
As a prerequisite for running Pixelitor, install Java 8 or higher, for example from OpenJDK (opens new window).
Next, download Pixelitor from the link below and extract it to an empty directory on your system.
Finally, start Pixelitor by executing
java -jar Pixelitor-4.2.3.jar in the installation directory to verify that the application starts up.
Custom Pixelitor Build
We're using a custom build of Pixelitor that includes a
The Teamscale Jacoco agent uses this file to determine which version of Pixelitor we are testing.
The documentation of the Teamscale JaCoCo Agent (opens new window) explains how to configure this.
# Step 3: Installing the Teamscale JaCoCo Agent
Download the latest release of the Teamscale JaCoCo Agent (opens new window) and extract it into the same directory as Pixelitor. The profiler is configured with a config file, which can be downloaded from Teamscale. Go to the External-Analysis Uploads view, which you can reach by clicking on the icon next to the Pixelitor project in the Projects perspective.
Click on Set Up Coverage Profiler and write
Manual Tests in the Partition field. We do this to cluster coverage from manual tests under a descriptive name, separated from the coverage of other testing stages, such as unit tests.
Click on Download and save the file to the same directory as before.
java -javaagent:teamscale-jacoco-agent/lib/teamscale-jacoco-agent.jar=config-file=jacocoagent.properties -jar Pixelitor-4.2.3.jar
java [...] -jar Pixelitor-4.2.3.jarwill start the application,
-javaagent:teamscale-jacoco-agent/lib/teamscale-jacoco-agent.jar=...registers the profiler,
config-file=jacocoagent.propertiesspecifies the config file for the profiler.
Once Pixelitor has started, do some things to generate coverage, e.g. create a new image and let loose the artist within you. Once you clicked around a little, close Pixelitor. On shutdown, the JaCoCo Agent will upload the coverage directly to Teamscale. This is configured by the following lines in the config file, which were preconfigured by the wizard in Teamscale:
teamscale-server-url=https://your.teamscale.url teamscale-project=pixelitor teamscale-user=your-user-name teamscale-access-token=your-access-token teamscale-partition=Manual Tests
Upload Interval for Long Running Applications
Coverage is not only uploaded on shutdown, but also regularly every 8 hours. This is especially useful for long running applications, such as web apps, where the JVM is not shut down after testing.
The interval can be adapted by adding the option
interval=... with the amount of minutes to the config file. Setting the interval to 0 disables the periodic upload.
To verify that the upload worked, in Teamscale, go to Activity. Once the data arrived and was processes successfully, the entry on top of the timeline represents the coverage upload.
The coverage is appearing on December 11, 2019, due to the
git.properties file embedded in the jar.
The Teamscale JaCoCo agent parses the commit ID from this file and uploads the collected coverage to the corresponding time.
We do this to ensure that the coverage is associated with the source code corresponding to the version under test.
Assumption: Reachability of Teamscale
This guide assumes that the Teamscale server is directly reachable from the test environment via HTTP(S).
Alternatively, the profiler can also upload the file to an Azure file storage, Artifactory or to a HTTP(S) URL.
If Teamscale is not reachable, the coverage file will be saved to
For more information refer to the documentation of our Teamscale JaCoCo Agent (opens new window).