The Gradle Artifactory Plugin supports all versions of Gradle including Gradle 2.0 and is available from the Gradle Plugins Gallery.
The plugin supports both Gradle Configurations and Publications for deploying artifacts to Artifactory.
Using the Correct Plugin ID
The Gradle Artifactory Plugin ID depends on two parameters:
- Whether you are using the old or the new Gradle publishing mechanism
- The version of the plugin
To simplify these documentation pages, the plugin ID will be referred to using a <PLUGIN ID> placeholder.
This placeholder should be replaced with the plugin IDs listed in the table below:
Plugin version 2.x
Plugin version 3.0.1 and higher
When using Gradle publications
When using Gradle configurations
Download and Installation
Currently the "plugins" notation cannot be used for applying the plugin for sub projects, when used from the root build script
The latest plugin jar file can be downloaded from the
JFrog Artifactory public demo. Copy the jar into your gradle home plugins directory (
Then add the following line to your project build script:
Using the Artifactory Plugin DSL
The Gradle Artifactory plugin can be configured using its own Convention DSL inside the
build.gradle script of your root project.
The syntax of the Convention DSL is described below:
Mandatory items within the relevant context are prefixed with '+'. All other items are optional.
The Artifactory Project Publish Task
The Artifactory Publishing Plugin creates an
artifactoryPublish Gradle task for each project the plugin is applied to. The task is configured by the
publish closure of the plugin.
You can configure the project-level task directly with the task's
artifactoryPublish closure, which uses identical Syntax to that of the plugin's
Controlling the Published Modules
To control which modules of a multi-module build, are published to Artifactory you can:
- Omit the '
artifactory' plugin from a project that does not publish anything. Note that this does not apply to the root project that contains the convention object, and so, requires the plugin to be applied.
Activate the corresponding
artifactoryPublishGradle task manually for each project to which you wish to apply the plugin.
For example in our Gradle project example you can run:
- Use the
artifactoryPublish.skipflag to deactivate analysis and publication.
Controlling the Build Name Number in BuildInfo
By default, BuildInfo is published with a build name constructed from the name of your root project and a build number that is the start date of the build.
You can control the build name and number values by specifying the following properties respectively:
The above properties are specified as standard Gradle properties.
You can also control the build name and number from within the Convention object DSL as shown at the end of the Convention DSL syntax above.
Project examples which use the Gradle Artifactory Plugin are available here.
Watch the Screencast
To see the Gradle Artifactory Plugin in action please watch this screencast.: