org.gradle.api.reporting

Class ReportingExtension

java.lang.Object

org.gradle.api.reporting.ReportingExtension

public class ReportingExtension
extends Object

A project extension named "reporting" that provides basic reporting settings and utilities.

Example usage:

 reporting {
     baseDir "$buildDir/our-reports"
 }
 

When implementing a task that produces reports, the location of where to generate reports should be obtained via the file(String) method of this extension.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_REPORTS_DIR_NAME The default name of the base directory for all reports, relative to Project.getBuildDir() ("reports").
static String	NAME The name of this extension (""reporting"")

Constructor Summary

Constructors

Constructor and Description
ReportingExtension(Project project)

Method Summary

Methods

Modifier and Type	Method and Description
File	file(String path) Creates a file object for the given path, relative to getBaseDir().
String	getApiDocTitle()
File	getBaseDir() The base directory for all reports
void	setBaseDir(Object baseDir) Sets the base directory to use for all reports

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NAME

public static final String NAME

The name of this extension (""reporting"")

See Also:

Constant Field Values

DEFAULT_REPORTS_DIR_NAME

public static final String DEFAULT_REPORTS_DIR_NAME

The default name of the base directory for all reports, relative to Project.getBuildDir() ("reports").

See Also:

Constant Field Values

Constructor Detail

ReportingExtension

public ReportingExtension(Project project)

Method Detail

getBaseDir

public File getBaseDir()

The base directory for all reports

This value can be changed, so any files derived from this should be calculated on demand.

Returns:

The base directory for all reports

setBaseDir

public void setBaseDir(Object baseDir)

Sets the base directory to use for all reports

The value will be converted to a File on demand via Project.file(Object).

Parameters:

baseDir - The base directory to use for all reports

file

public File file(String path)

Creates a file object for the given path, relative to getBaseDir().

The reporting base dir can be changed, so users of this method should use it on demand where appropriate.

Parameters:

path - the relative path

Returns:

a file object at the given path relative to getBaseDir()

getApiDocTitle

public String getApiDocTitle()