App Javadoc Builder Gradle Plugin

The App Javadoc Builder Gradle plugin lets you generate API documentation as a single, combined HTML document for an application that spans different subprojects, each one representing a different component of the same application.

The plugin has been successfully tested with Gradle 4.10.2.

Usage

To use the plugin, include it in the build script of the root project:

buildscript {
    dependencies {
        classpath group: "com.liferay", name: "com.liferay.gradle.plugins.app.javadoc.builder", version: "1.2.2"
    }

    repositories {
        maven {
            url "https://repository-cdn.liferay.com/nexus/content/groups/public"
        }
    }
}

apply plugin: "com.liferay.app.javadoc.builder"

The App Javadoc Builder plugin automatically applies the base and reporting-base plugins.

Project Extension

The App Javadoc Builder plugin exposes the following properties through the extension named appJavadocBuilder:

Property Name	Type	Default Value	Description
copyTags	boolean	true	Whether to copy the custom block tags configuration from the subprojects. It sets the Javadoc -tag argument for the appJavadoc task.
doclintDisabled	boolean	true on JDK8+, false otherwise.	Whether to ignore Javadoc errors. It sets the Javadoc -Xdoclint and -quiet arguments for the appJavadoc task.
groupNameClosure	Closure<String>	The subproject’s description, or the subproject’s name if the description is empty.	The closure invoked in order to get the group heading for a subproject. The given closure is passed a Project as its parameter. If groupPackages is false, this property is not used.
groupPackages	boolean	true	Whether to separate packages on the overview page based on the subprojects they belong to. It sets the -group argument for the appJavadoc task.
subprojects	Set<Project>	project.subprojects	The subprojects to include in the API documentation of the app.

The same extension exposes the following methods:

Method	Description
AppJavadocBuilderExtension onlyIf(Closure<Boolean> onlyIfClosure)	Includes a subproject in the API documentation if the given closure returns true. The closure is evaluated at the end of the subproject configuration phase and is passed a single parameter: the subproject. If the closure returns false, the subproject is not included in the API documentation.
AppJavadocBuilderExtension onlyIf(Spec<Project> onlyIfSpec)	Includes a subproject in the API documentation if the given spec is satisfied. The spec is evaluated at the end of the subproject configuration phase. If the spec is not satisfied, the subproject is not included in the API documentation.
AppJavadocBuilderExtension subprojects(Iterable<Project> subprojects)	Include additional projects in the API documentation of the app.
AppJavadocBuilderExtension subprojects(Project... subprojects)	Include additional projects in the API documentation of the app.

Tasks

The plugin adds two tasks to your project:

Name	Depends On	Type	Description
appJavadoc	The javadoc tasks of the subprojects.	Javadoc	Generates Javadoc API documentation for the app.
jarAppJavadoc	appJavadoc	Jar	Assembles a JAR archive containing the Javadoc files for this app.

The appJavadoc task is automatically configured with sensible defaults:

Property Name	Default Value
classpath	The javadoc.classpath of all the subprojects.
destinationDir	${project.buildDir}/docs/javadoc
options.encoding	"UTF-8"
source	The javadoc.source of all the subprojects.
title	project.reporting.apiDocTitle