The test coverage shown here works on both SonarQube and SonarCloud. This project is analysed on SonarCloud!
|
ℹ️
|
This simple example aims at demonstrating code coverage in action. It explains how to add coverage on a project for which the analysis is already configured. Analysis configuration examples are available here. Adding code coverage is done the same way regardless of whether you use the Build Wrapper or a Compilation Database to configure the analysis. |
To get coverage and feed it to the sonar-scanner, use the following procedure.
-
Add the
--coverageand-fprofile-abs-pathcompilation flags to instrument the binaries -
Run the tests to generate the test coverage information
-
Run
gcov --preserve-pathsfrom a dedicated directory for each object file -
Point the
sonar.cfamily.gcov.reportsPathproperty at that dedicated directory with coverage reports -
Run
sonar-scanneras the final step
You can take a look at the sonar-project.properties and .travis.yml to see it in practice.
For SonarCloud to pick-up the coverage information produced from compiling with the --coverage flag and running the tests,
you need to run gcov for each object file
and point sonar.cfamily.gcov.reportsPath property to the folder containing the produced .gcov files.
|
|
Beware that if you are running multiple executables and want to collect coverage from all of them, you have to be careful of keeping one .gcda file per source file and avoid overwriting .gcov files (especially if you are building out-of-source, for example, with CMake). See also -fprofile-abs-path gcc option and --preserve-paths gcov option.
|
An example of a flawed C++ code. The code repository can be analyzed automatically, but it can also be compiled with different build systems using different CI pipelines on Linux, macOS, and Windows.
The code repository is forked into other repositories in this collection to add a specific build system, platform, and CI. The downstream repositories are analyzed either with SonarQube or SonarCloud.
You can find examples for:
Using the following build systems:
Running on the following CI services:
-
Additionally, generic examples demonstrate integration with other CIs and manual-configuration examples should help you if you are running locally.
Configured for analysis on:
You can find also a few examples demonstrating:
See examples-structure.adoc for a description of the structure of this GitHub organization and the relations between its different repositories.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent