Chapter 63. The PMD Plugin

Table of Contents

63.1. Usage
63.2. Tasks
63.3. Dependency management
63.4. Configuration

The PMD plugin performs quality checks on your project’s Java source files using PMD and generates reports from these checks.

63.1. Usage

To use the PMD plugin, include the following in your build script:

Example 63.1. Using the PMD plugin


apply plugin: 'pmd'

The plugin adds a number of tasks to the project that perform the quality checks. You can execute the checks by running gradle check.

Note that Findbugs will run with the same Java version used to run Gradle.

63.2. Tasks

The PMD plugin adds the following tasks to the project:

Table 63.1. PMD plugin - tasks

Task name Depends on Type Description




Runs PMD against the production Java source files.




Runs PMD against the test Java source files.




Runs PMD against the given source set’s Java source files.

The PMD plugin adds the following dependencies to tasks defined by the Java plugin.

Table 63.2. PMD plugin - additional task dependencies

Task name Depends on


All PMD tasks, including pmdMain and pmdTest.

63.3. Dependency management

The PMD plugin adds the following dependency configurations:

Table 63.3. PMD plugin - dependency configurations

Name Meaning


The PMD libraries to use

63.4. Configuration

See the PmdExtension class in the API documentation.