Using Code Coverage
Using Code Coverage with Burst compiler
If you use the Burst package and have jobs compiled with Burst, you will need to disable Burst compilation in order to get full coverage. To disable Burst compilation you can do one of the following:
- Uncheck Enable Compilation under Jobs > Burst > Enable Compilation
- Pass
-burst-disable-compilation
to the command line
Using Code Coverage with Code Optimization
Code Optimization was introduced in 2020.1. Code Optimization mode defines whether Unity Editor compiles scripts in Debug or Release mode. Debug mode enables C# debugging and it is required in order to obtain accurate code coverage. To ensure Code optimization is set to Debug mode you can do one of the following:
- Switch to Debug mode in the Editor (bottom right corner, select the Bug icon > Switch to debug mode)
- Using the CompilationPipeline api, set
CompilationPipeline.codeOptimization = CodeOptimization.Debug
- Pass
-debugCodeOptimization
to the command line
Excluding code from Code Coverage
Any code that should not be contributing to the Code Coverage calculation can be excluded by adding the ExcludeFromCoverage
attribute. This attribute can be added to Assemblies, Classes, Constructors, Methods and Structs. Note that you can also use the .NET ExcludeFromCodeCoverage
attribute.