Gradle Distribution Plugin

External

• https://docs.gradle.org/4.7/userguide/distribution_plugin.html

Internal

• Gradle Concepts
• Gradle Application Plugin

Overview

The Distribution plugin builds archives that serve as distributions of the project. They typically contain the executable application and other supporting files, such as the documentation. The Distribution plugin is part of the Application plugin flow. The plugin adds an extension named "distributions" of type DistributionContainer. It also creates a single distribution in the distributions container, named "main". Multiple distributions can be configured.

The distribution files are created in $buildDir/distributions/$project.name-$project.version.<ext>.

Building Custom Files with the Distribution

All files in the ./src/<distribution-name>/dist directory will be automatically included in the distribution.

Additional files can be added by configuring the Distribution object:

apply plugin: 'distribution'

...

distributions {
    main {
        baseName = 'someName'
        contents {
            from { 'src/readme' }
        }
    }
}

Multiple Distributions

See "Adding extra distributions" in documentation.