Getting started with Diffblue Cover
Initial use, sign-up, and login
Once Diffblue Cover is running within your network you should be able to access the main user interface on the installed IP/Hostname in a browser. This is the hostname that you set up to access the product:
Our recommended browser is Chrome.
On the login screen click
Sign up to create a new user:
On a clean installation no users will be present.
Enter the details for your initial user. Usernames cannot contain spaces or special characters
_. Passwords must be at least 10 characters long and can contain any characters.
Once you have created your user, you will automatically be logged in to the
Dashboard for that user.
Adding a project for analysis
The dashboard shows your projects and their status. From here you can add new projects and run analyses.
The first step is to create your project by clicking
From here, you can either choose to have a walkthrough using our java-demo project as an example, (this is
provided with your shipped version of the product, it is a JAR file called
java-demo.jar) or move straight
on to analyzing your own project JAR.
Add a new Project prompt will ask for a project name.
Running an analysis
Once the project is created it will show the ready icon (the Diffblue owl) and the
analysis button will be enabled.
Start analysis will open a modal which will allow you to provide the file(s) required to start
A build JAR must be provided in the first field. This should be a JAR file containing the code you wish to analyze.
A fat build JAR may be provided in the second field. This will enable test verification, as long as
is not specified in your settings file.
A base build JAR may be provided in the third field. This will make the analysis differential, i.e. it will only analyze lines that have been added or changed in the build JAR versus the base build JAR.
A settings file in
yaml format may be provided in the fourth field, which should contain the configuration
for your analysis. If you do not provide a settings file, your analysis will be run with a default configuration.
For more details see Configuring Diffblue Cover.
This screen shows the analyses that have been started, including any currently running. Each analysis can be expanded to provide more information about the specific run and allow the analysis to be stopped:
Once the analysis starts the
View results button becomes available. If the analysis is still running
a progress bar will be displayed at the top of the results pages
until it completes.
View results you will be presented with the tests view:
This shows all of the tests Diffblue Cover has produced, along with the class they test
against and the number of lines of additional coverage these tests provide. To see
the contents of the test itself click
Here you can
Copy test into your system clipboard or select
Download java file. If you want to use
this unit test in your test suite, please ensure you have appropriately set up the Diffblue utilities.
See Executing Diffblue tests for more information. If you are working
in an offline environment without access to the Maven package
repository you can use the link in the product to directly download the utilities tar file
and incorporate the files into your environment. For more details see
section Executing Diffblue tests without Maven access.