PRIMEIROS PASSOS

De um relatório às linhas que ninguém testa

Seis passos, os mesmos nos dois editores. O Coverage Studio não corre testes próprios: lê o relatório que as suas ferramentas já escrevem e coloca-o sobre o código — no VS Code, e no Visual Studio 2022 e 2026, no Community, Professional e Enterprise por igual. Cada passo é também uma página dentro do editor, com um botão para ele: o passo a passo no VS Code, Tools → Coverage Studio → Getting Started no Visual Studio.

Ainda não instalou? Transfira a build para o seu editor — Community ou Pro para VS Code, ou a edição para Visual Studio — e volte aqui; o guia do utilizador tem os passos de instalação para os dois. Prefere experimentar antes de ligar o seu próprio projeto? O projeto de demonstração tem um relatório pronto.

1Abra um projeto que tenha um relatório de cobertura

Qualquer um dos 25 formatos serve — LCOV, Cobertura, llvm-cov, OpenCover, coverage.py, Istanbul e os restantes. Se não tiver nenhum à mão, o projeto de demonstração tem um para C, C++ (clang e MSVC), C#, Visual Basic, TypeScript, JavaScript e Python.

No VS Code

File → Open Folder, ou o ficheiro do espaço de trabalho. O ícone Coverage aparece na barra de atividade assim que a extensão está ativa.

No Visual Studio

Uma solução, ou uma pasta (File → Open → Folder, que é como se abre um projeto CMake). A extensão carrega com ela; View → Other Windows → Coverage é a sua janela.

2Carregue o relatório

Um relatório num local habitual — coverage/lcov.info, coverage.xml, coverage-final.json e os outros nomes conhecidos, ou para onde as definições apontam — é encontrado e carregado sozinho. Se o seu está noutro sítio, escolha-o uma vez e fica memorizado.

No VS Code

Paleta de comandos → Fucini Coverage: Load Coverage, ou Pick Coverage File para escolher um. Run Tests with Coverage reconhece vitest, jest, pytest, go, cargo, dotnet, maven, gradle, phpunit e ctest, executa-os com cobertura ligada e carrega o que escrevem.

No Visual Studio

Tools → Coverage Studio → Load Coverage File…, uma vez. O painel Fucini Coverage da janela Output diz que ficheiros foram procurados e encontrados. Execute os testes como sempre; Watch Coverage File recarrega quando o relatório muda.

3Veja-o no editor

Abra um ficheiro de código. Vermelho é uma linha que nunca correu, âmbar uma decisão tomada num só sentido. De origem só estes achados são marcados; o mapa de calor colore cada linha pelo número de vezes que correu, e as contagens em linha escrevem o número a seguir.

No VS Code

Toggle Coverage Painting liga e desliga as marcas; fuciniCoverage.editorGutter.mode escolhe uncovered ou heatmap, hitCounts.inline as contagens. A execução está também na vista Coverage e no painel Test Coverage do próprio VS Code.

No Visual Studio

Tools → Coverage Studio → Show Coverage in Editor, depois Gutter: Heatmap ou Show Inline Hit Counts como preferir. Aplicam-se as mesmas definições — a edição para Visual Studio lê o seu .vscode/settings.json.

4Percorra as lacunas

Salte de um ponto não testado para o seguinte em vez de percorrer à procura de vermelho. A linha acima de cada função diz quanto dela correu — e a sua complexidade, pontuação CRAP e MC/DC onde o relatório os traz. Um hover numa linha marcada diz por palavras qual o ramo que não foi tomado.

No VS Code

Next Uncovered é Alt+N, o anterior Alt+P; Next Partly-Tested Decision vai à próxima decisão de que só alguns ramos foram tomados.

No Visual Studio

Acordes de duas teclas após Ctrl+Shift+U: N e P para a linha não coberta seguinte e anterior, B para a próxima decisão parcialmente testada — não Alt+N, porque no Visual Studio Alt e uma letra abrem um menu. Altere-os em Tools → Options → Keyboard.

5Leia os números

Cada ficheiro com as suas métricas — linhas, ramos, funções, MC/DC — e uma pontuação sobre todos: uma média harmónica ponderada, que não se compra só com cobertura de linhas. A barra de estado mostra essa pontuação para a execução e para o ficheiro em que está; pouse o ponteiro para ver o cartão completo.

No VS Code

A vista Coverage na barra de atividade: ordene, recolha, oculte colunas, clique num ficheiro para o abrir. Show Worst-Covered Files e …Functions listam por onde começar.

No Visual Studio

View → Other Windows → Coverage é a mesma árvore, com a pontuação no título; clique com o botão direito numa linha para a abrir ou copiar o caminho. Show Coverage Card abre o cartão da barra de estado sem ponteiro.

6Defina os seus limiares

Diga o que chega: um mínimo por métrica, ou um perfil de segurança que exige 100 % de tudo. O cartão diz então COMPLIANT ou NON-COMPLIANT face a eles, e os mesmos limiares valem nos dois editores porque são as mesmas definições.

No VS Code

Configure Coverage Compliance abre as definições; Check Coverage Thresholds dá o veredicto como comando, para um hook de pre-commit ou um pipeline.

No Visual Studio

A engrenagem na barra de ferramentas da janela Coverage abre a janela de definições, que escreve as definições de utilizador desta edição ou o .vscode/settings.json da pasta, conforme diz o seu seletor Write changes to.

A partir daqui: o guia do utilizador para tudo o resto — formatos, fusão, remapeamento de caminhos, a pontuação, o relatório HTML — e as FAQ para planos e licenças. A edição para Visual Studio está incluída em todos os planos pagos; uma máquina onde o VS Code está ativado não precisa de mais nada, e Tools → Coverage Studio → Licence… aceita um código de subscrição onde não está.