# PublishingExtension

API Documentation: | `PublishingExtension`

Note: This class is incubating and may change in a future version of Gradle.

The configuration of how to “publish” the different components of a project.

This new publishing mechanism will eventually replace the current mechanism of upload tasks and configurations. At this time, it is an incubating feature and under development.

The PublishingExtension is a `DeferredConfigurable` model element, meaning that extension will be configured as late as possible in the build. So any 'publishing' configuration blocks are not evaluated until either:

1. The project is about to execute, or
2. he publishing extension is referenced as an instance, as opposed to via a configuration closure.

A 'publishing' configuration block does not need to dereference the publishing extension, and so will be evaluated late. eg:

    publishing {
        publications { ... }
        repositories.maven { ... }
    }

Any use that accesses the publishing extension as an instance does require the publishing extension to be realised, forcing all configuration blocks to be evaluated. eg:

    publishing.publications { ... }
    publishing.repositories.maven { ... }

### Properties

Property | Description
`publications` | Incubating The publications of the project.
`repositories` | Incubating The container of possible repositories to publish to.

### Methods

Method | Description
`publications(configure)` | Incubating Configures the publications of this project.
`repositories(configure)` | Incubating Configures the container of possible repositories to publish to.

### Script blocks

No script blocks

### Property details

#### `PublicationContainer` `publications` (read-only)

Note: This property is incubating and may change in a future version of Gradle.

The publications of the project.

See `PublishingExtension.publications(org.gradle.api.Action)` for more information.

#### `RepositoryHandler` `repositories` (read-only)

Note: This property is incubating and may change in a future version of Gradle.

The container of possible repositories to publish to.

See `PublishingExtension.repositories(org.gradle.api.Action)` for more information.

### Method details

#### `void` `publications`(``Action`<? super `PublicationContainer`>` configure)

Note: This method is incubating and may change in a future version of Gradle.

Configures the publications of this project.

The publications container defines the outgoing publications of the project. That is, the consumable representations of things produced by building the project. An example of a publication would be an Ivy Module (i.e. `ivy.xml` and artifacts), or Maven Project (i.e. `pom.xml` and artifacts).

Actual publication implementations and the ability to create them are provided by different plugins. The “publishing” plugin itself does not provide any publication types. For example, given that the 'maven-publish' plugin provides a `MavenPublication` type, you can create a publication like:

    apply plugin: 'maven-publish'

    publishing {
      publications {
        myPublicationName(MavenPublication) {
          // Configure the publication here
        }
      }
    }

Please see `IvyPublication` and `MavenPublication` for more information on publishing in these specific formats.

#### `void` `repositories`(``Action`<? super `RepositoryHandler`>` configure)

Note: This method is incubating and may change in a future version of Gradle.

Configures the container of possible repositories to publish to.

    apply plugin: 'publishing'

    publishing {
      repositories {
        // Create an ivy publication destination named “releases”
        ivy {
          name "releases"
          url "http://my.org/ivy-repos/releases"
        }
      }
    }

The `repositories` block is backed by a `RepositoryHandler`, which is the same DSL as that that is used for declaring repositories to consume dependencies from. However, certain types of repositories that can be created by the repository handler are not valid for publishing, such as `RepositoryHandler.mavenCentral()`.

At this time, only repositories created by the `ivy()` factory method have any effect. Please see `IvyPublication` for information on how this can be used for publishing to Ivy repositories.