JaCoCo (Java Code Coverage) é uma ferramenta poderosa para medir a cobertura de testes em projetos Java. Este artigo fornece um guia passo a passo para executar JaCoCo pelo terminal utilizando Maven e Gradle, as duas ferramentas de build mais populares para projetos Java.

Usando Maven

Para utilizar JaCoCo com Maven, você precisa garantir que o plugin JaCoCo está corretamente configurado no seu arquivo pom.xml. Uma vez configurado, você pode executar comandos Maven para rodar testes e gerar relatórios de cobertura.

1. Configuração do Plugin JaCoCo no pom.xml</code class="language-xml">:

Primeiramente, certifique-se de que o plugin JaCoCo está incluído no seu pom.xml:

<build>
    <plugins>
        <plugin>
            <groupid>org.jacoco</groupid>
            <artifactid>jacoco-maven-plugin</artifactid>
            <version>0.8.7</version>
            <executions>
                <execution>
                    <id>default-prepare-agent</id>
                    <goals>
                        <goal>prepare-agent</goal>
                    </goals>
                </execution>
                <execution>
                    <id>default-report</id>
                    <goals>
                        <goal>report</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. Executar os Testes com JaCoCo:

Para rodar os testes e gerar os dados de cobertura, use o seguinte comando no terminal:

mvn clean test

3. Gerar o Relatório de Cobertura:

Após a execução dos testes, gere o relatório de cobertura com o comando:

mvn jacoco:report

4. Relatório Agregado (para Projetos Multi-Módulo):

Em projetos multi-módulo, você pode gerar um relatório agregado executando:

mvn clean verify
mvn jacoco:report-aggregate

5. Verificar Cobertura (Opcional):

Além disso, para verificar se a cobertura atende a critérios específicos, utilize:

mvn jacoco:check

Usando Gradle

Para utilizar JaCoCo com Gradle, adicione o plugin JaCoCo ao seu arquivo build.gradle. Com a configuração correta, você pode executar comandos Gradle para rodar testes e gerar relatórios de cobertura.

1. Adicionar o Plugin JaCoCo no build.gradle:

Primeiramente, inclua o plugin JaCoCo no seu build.gradle:

plugins {
    id 'java'
    id 'jacoco'
}

jacoco {
    toolVersion = "0.8.7"
}

jacocoTestReport {
    reports {
        xml.required = true
        html.required = true
    }
}

test {
    finalizedBy jacocoTestReport
}

2. Executar os Testes com JaCoCo:

Para rodar os testes e gerar os dados de cobertura, use o seguinte comando no terminal:

./gradlew clean test

3. Gerar o Relatório de Cobertura:

Após a execução dos testes, gere o relatório de cobertura com o comando:

./gradlew jacocoTestReport

4. Relatório Agregado (para Projetos Multi-Módulo):

Por fim, em projetos multi-módulo, configure o relatório agregado no módulo raiz e execute:

./gradlew clean test jacocoTestReport

Conclusão

Em suma, executar JaCoCo pelo terminal envolve a configuração adequada do plugin JaCoCo no Maven ou Gradle, seguido pela execução de comandos específicos para rodar testes e gerar relatórios de cobertura. Este guia detalhado oferece um caminho claro para integrar JaCoCo no seu fluxo de trabalho de desenvolvimento, garantindo uma análise precisa da cobertura de testes em seus projetos Java. Dessa forma, você pode identificar facilmente áreas que precisam de mais testes e garantir que seu código é bem coberto.