Package org.gradle.api.reporting

# Class ReportingExtension

java.lang.Object
org.gradle.api.reporting.ReportingExtension

public abstract class ReportingExtension extends Object
A project extension named "reporting" that provides basic reporting settings and utilities.

Example usage:

     plugins {
         id("org.gradle.reporting-base")
     }

     reporting {
         // change the base directory where all reports are generated
         baseDirectory = layout.buildDirectory.dir("our-reports")
     }

     // A directory for test reports
     reporting.baseDirectory.dir("test-reports")

     // A report file
     reporting.baseDirectory.file("index.html")

When implementing a task that produces reports, the location of where to generate reports should be obtained from `getBaseDirectory()`.

- ## Field Summary

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

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `ReportingExtension(Project project)`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `File`
  `file(String path)`
  Deprecated.
  Use `getBaseDirectory().file(path)` or `getBaseDirectory().dir(path)` instead.
  `String`
  `getApiDocTitle()`
  Deprecated.
  Use your own way of generating a title for API documentation.
  `abstract DirectoryProperty`
  `getBaseDirectory()`
  Returns base directory property to use for all reports.
  `abstract ExtensiblePolymorphicDomainObjectContainer<ReportSpec>`
  `getReports()`
  Container for aggregation reports, which may be configured automatically in reaction to the presence of the jvm-test-suite plugin.
  `void`
  `reports(Action<? super ExtensiblePolymorphicDomainObjectContainer<ReportSpec>> action)`
  Add more reports or configure the available reports.

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### 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 `ProjectLayout.getBuildDirectory()` ("reports").
    See Also:
      - Constant Field Values

- ## Constructor Details

  - ### ReportingExtension

    @Inject public ReportingExtension(Project project)

- ## Method Details

  - ### getBaseDirectory

    public abstract DirectoryProperty getBaseDirectory()
    Returns base directory property to use for all reports.
    Since:
      4.4

  - ### file

    @Deprecated public File file(String path)
    Deprecated.
    Use `getBaseDirectory().file(path)` or `getBaseDirectory().dir(path)` instead.
    Creates a file object for the given path, relative to `getBaseDirectory()`.

    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 `getBaseDirectory()`.
    See Also:
      - `DirectoryProperty.file(String)`
      - `DirectoryProperty.dir(String)`

  - ### getApiDocTitle

    @Deprecated public String getApiDocTitle()
    Deprecated.
    Use your own way of generating a title for API documentation.
    Provides a default title for API documentation based on the project's name and version.

  - ### getReports

    @Incubating public abstract ExtensiblePolymorphicDomainObjectContainer<ReportSpec> getReports()
    Container for aggregation reports, which may be configured automatically in reaction to the presence of the jvm-test-suite plugin.
    Returns:
      A container of known aggregation reports
    Since:
      7.4

  - ### reports

    @Incubating public void reports(Action<? super ExtensiblePolymorphicDomainObjectContainer<ReportSpec>> action)
    Add more reports or configure the available reports.
    Parameters:
      `action` - configuration action for the reports container
    Since:
      9.1.0