How can the code coverage data from Flutter tests be displayed?

Question

I'm working on a Flutter app using Android Studio as my IDE. I'm attempting to write tests and check the code coverage but I can't work out how to view the data in the IDE or any other application.

By running flutter test --coverage, a coverage report seems to be generated into a file /coverage/lcov.info. That file looks something like this:

SF:lib\data\Customer.g.dart
DA:9,2
DA:10,2
DA:11,2
DA:12,2
DA:13,2
DA:20,0
DA:21,0
DA:22,0
DA:23,0
DA:24,0
...

Looking at the file it seems to have a list of my project files with line by line coverage data. Is there a way to view this information in Android Studio?

Subcommittee

If you got problem with brew on M1 use this stackoverflow.com/questions/71064775/zsh-command-not-found-brew – Fiann

Answer 1

With the release of Flutter 2.5, you can now view test coverage within IntelliJ and Android Studio.
See this post

In addition, the latest IJ/AS plugin for Flutter allows you to see the coverage information for both unit test and integration test runs. You can access this from the toolbar button next to the “Debug” button:

Android Studio and IntelliJ:

Eh

Answer 2

You can also install lcov and convert the lcov.info file to HTML pages and then see the result in the browser with sorting option.

1. Installation

1.1. Installing in Ubuntu

sudo apt-get update -qq -y
sudo apt-get install lcov -y

1.2. Installing in Mac

brew install lcov

2. Run tests, generate coverage files and convert to HTML

flutter test --coverage
genhtml coverage/lcov.info -o coverage/html

3. Open coverage report in browser

open coverage/html/index.html

Note This way you can add it to circleci artifacts and coveralls as well.

Thrilling

This worked great for me although, its probably a good idea to pass an output directory into the genhtml command: genhtml coverage/icov.info -o coverage/output/ – Brinker

This should be the accepted answer since it's editor-agnostic. – Disfrock

One can also specify an output directory. genhtml coverage/lcov.info -o coverage/html, for example. – Odaodab

For me the filename is coverage/lcov.info and not icov.info as in the generating part – Pell

after installing lcov and generate genhtml just hit open coverage/index.html – Yu

What is the solution for windows user ? – Recalescence

Dart allows to create a custom script like NPM does? So I can call something like flutter run test:coverage and it execute both commands at once? – Annapolis

how can we install it on windows ? – Fredericton

@RodrigoManguinho you can have executables in dart packages. See dart.dev/tools/pub/cmd/pub-run, dart.dev/tools/pub/pubspec#executables – Highfalutin

is that two separate commands? – Helsell

@Recalescence to upgrade to Linux... – Verdie

Solution for windows is to install Chocolatey then: choco install lcov community.chocolatey.org/packages/lcov – Alderete

Answer 3

This is what you want to run to see tests coverage in your browser on macOS

flutter test --coverage
genhtml coverage/lcov.info -o coverage/html
open coverage/html/index.html

Gynaecomastia

if you see the error: zsh: command not found: genhtml run: brew install lcov then you can re-run the second and third commands. – Hendricks

Answer 4

You can view the code coverage generated by flutter with the Atom editor.
You just need to install the Dart and lcov-info packages.

Then you load your project folder and press Ctrl+Alt+c, coverage will be displayed with a summary of the whole projects coverage and also with specific line highlighting.

There doesn't appear to be any plugin for Android studio which does this as of yet.

Subcommittee

can you give a picture to me. I have loaded the project but ctrl+alt+c didn't work. – Byword

The Flutter Enhancement Suite plugin for Android Studio/IntelliJ does this, now. See my answer for more details on what the plugin does and how to use it. I found the plugin reading this flutter issue on how to display coverage reports. – Slavish

Answer 5

Update 9/18/2021:

See new answer for how it's done within the editor

Update 5/9/2020:

Turns out you can just run flutter test --coverage, then in the same terminal session run bash <(curl -s https://codecov.io/bash) -t token token should be the repository token you get from CodeCov. That command should automatically find and upload the coverage data and will be visible on your CodeCov dashboard. So you don't need Bitrise.

Original:

I've been using Bitrise for continuous integration on my flutter project and there is an easy way to send your reports to CodeCov then visualize it there. This requires you to gain some knowledge on how to set up and use Bitrise but a lot of its automatic so don't worry, also if you're a small team you should be fine with the free tier. Here are the key points for getting CodeCov to work.

1. Make sure you add the --coverage variable to the Flutter Test workflow.

2. Add the token from CodeCov as a secret key, you will need to sign up for CodeCov and link your repository to receive a token.

3. Add the CodeCov workflow and select the CODECOV_TOKEN key.

After that, you should be able to fire off a build and if successful you should see your dashboard update at CodeCov.

Eh

Answer 6

I just developed a simple dart package (test_cov_console), so you can run it directly from Android Studio terminal. The tool would read the lcov.info that was generated by flutter test --coverage. Find this link for source code.

You can install the lib globally, so it would not change your current project:

    flutter pub global activate test_cov_console

And run it:

    flutter pub global run test_cov_console

Here is the sample of output:

    flutter pub run test_cov_console
---------------------------------------------|---------|---------|---------|-------------------|
File                                         |% Branch | % Funcs | % Lines | Uncovered Line #s |
---------------------------------------------|---------|---------|---------|-------------------|
lib/src/                                     |         |         |         |                   |
 print_cov.dart                              |  100.00 |  100.00 |   88.37 |...,149,205,206,207|
 print_cov_constants.dart                    |    0.00 |    0.00 |    0.00 |    no unit testing|
lib/                                         |         |         |         |                   |
 test_cov_console.dart                       |    0.00 |    0.00 |    0.00 |    no unit testing|
---------------------------------------------|---------|---------|---------|-------------------|
 All files with unit testing                 |  100.00 |  100.00 |   88.37 |                   |
---------------------------------------------|---------|---------|---------|-------------------|

The output can be saved to CSV file:

flutter pub run test_cov_console -c --output=coverage/test_coverage.csv

Sample CSV output file:

File,% Branch,% Funcs,% Lines,Uncovered Line #s
lib/,,,,
test_cov_console.dart,0.00,0.00,0.00,no unit testing
lib/src/,,,,
parser.dart,100.00,100.00,97.22,"97"
parser_constants.dart,100.00,100.00,100.00,""
print_cov.dart,100.00,100.00,82.91,"29,49,51,52,171,174,177,180,183,184,185,186,187,188,279,324,325,387,388,389,390,391,392,393,394,395,398"
print_cov_constants.dart,0.00,0.00,0.00,no unit testing
All files with unit testing,100.00,100.00,86.07,""

Lysippus

Very neat. Can you not provide this as an actual Dart package that we can include in our projects? – Oe

Just converted it to dart package. – Lysippus

Just what I was looking for, but it uses an outdated flutter version – Florance

Hi @AsafPinhassi, just updated the package. Please try again. – Lysippus

Answer 7

The Flutter Enhancement Suite does exactly that. It is an Android Studio/IntelliJ plugin which generates coverage reports. It shows the coverage per file and also highlights covered lines (red/green bars next to the line numbers):

1. install the plugin from the plugin options (Preferences > Plugins > Marketplace tab > Search for Flutter Enhancement Suite).

2. Create a new Run Configuration for testing with coverage

(Run > Edit Configurations > click the plus button to add a new configuration > Choose Flutter Test in the dropdown)

3. Name your configuration (e.g. "All tests"), set the scope and the file or directory containing your tests.

4. Run your tests with coverage from the top menu.

Slavish

I have installed flutter enhancement suite as per the steps, but still I don't see file wise coverage report. – Outreach

Answer 8

Coverage reporting is now available on Android Studio

Tapp

Unavailable to me, weird. – Whorl

Hey I've got the same issue as Panthro, any chance you could let us know which version of Android Studio you got this to work on? – Subcommittee

I'm currently on Android Studio 3.2... The 'Run with Coverage' option in Android Studio is enabled only for Flutter integration tests for some reason (at least for me). Per the image above, it was working for widget tests. Not sure what happened (don't use it very often) – Tapp

I'm getting `Error: Not found: 'dart:ui'' when I try that option, any idea how to fix that? – Ogee

It doesn't work for flutter. Might be specific to Dart-only tests – Omni

Answer 9

You can use SonarQube with an additional plugin for Flutter as per this link SonarQube plugin for Flutter / Dart.

I have tried it with the free version of SonarQube on docker, and if you have configured it correctly, you just need to run the following commands on Android Studio terminal:

# Download dependencies 
flutter pub get 
# Run tests with User feedback (in case some test are failing)
flutter test
# Run tests without user feedback regeneration tests.output and coverage/lcov.info
flutter test --machine --coverage > tests.output 

# Run the analysis and publish to the SonarQube server
sonar-scanner

Here is the sample of the report, and you can drill deep into line codes.

Lysippus

As explained there, it's now possible to run tests with --machine & --coverage at the same time. ex: flutter test --machine --coverage test > tests.output – Acarus

Answer 10

FOR WINDOWS

Required:

• Chocolatey
• Perl
• LCOV

1. INSTALL CHOCOLATEY

Open PowerShell (with Admin)

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

2. INSTALL PERL

choco install strawberryperl

Add path to the environmental variable

3. INSTALL LCOV

choco install lcov

LCOV OPERATION

1. go to the android studio terminal & run this flutter test --coverage
2. now next, open your project root dir in the power shell in my case (eg :C:\Users\CIPL\Documents\Project\Flutter\myProject)
3. & run this cmd perl C:\ProgramData\chocolatey\lib\lcov\tools\bin\genhtml coverage/lcov.info -o coverage/html
4. that's it open the html folder and click the HTML file to view the visual in the browser.

NOTE: when I tried to do 3'rd point, I faced this error "ERROR: cannot create directory 'coverage/html'"

so manually created the html folder and tried 3rd point again.

Found this Windows solution in this https://blog.tech-andgar.me/flutter-test-coverage

Mikey

Answer 11

So, the actual answer is no, you cannot view a coverage report within Android Studio (or in IntelliJ IDEA) at this time.

Unlike JavaScript/TypeScript and Java and probably Python, the IntelliJ IDE (and by extension, Android Studio) do not have integrated IDE support for showing test coverage of Flutter code in the editor. This is a shame because the ability to see your untested code branches and lines highlighted in the source code of your editor is a beautiful thing. Not sure why a plugin for this does not exist yet, since it is well-supported for other languages, and a standard lcov.info file is generated.

There is a bundled code coverage tool window in IntelliJ that is supposed to allow you to browse the lcov.info file in a tree/table drill-down format, but it doesn't seem to work with the coverage report generated by flutter (flutter test --coverage). I thought it might be the relative paths in the lcov.info and my multi-module app structure, but I tried to manually edit the file paths in lcov.info, but I had no luck getting the stats to show.

Omni