Getting Started

plugins {
  id 'com.github.johnrengelman.shadow' version '5.0.0'
  id 'java'
}

Alternatively, the plugin can be added to the buildscript classpath and applied:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.github.jengelman.gradle.plugins:shadow:5.0.0'
    }
}

apply plugin: 'com.github.johnrengelman.shadow'
apply plugin: 'java'

Shadow is a reactive plugin. This means that applying Shadow by itself will perform no configuration on your project. Instead, Shadow reacts This means, that for most users, the java or groovy plugins must be explicitly applied to have the desired effect.

Default Java/Groovy Tasks

In the presence of the java or groovy plugins, Shadow will automatically configure the following behavior:

  • Adds a shadowJar task to the project.
  • Adds a shadow configuration to the project.
  • Configures the shadowJar task to include all sources from the project's main sourceSet.
  • Configures the shadowJar task to bundle all dependencies from the runtime configuration.
  • Configures the classifier attribute of the shadowJar task to be 'all' .
  • Configures the shadowJar task to generate a Manifest with:
    • Inheriting all configuration from the standard jar task.
    • Adds a Class-Path attribute to the Manifest that appends all dependencies from the shadow configuration
  • Configures the shadowJar task to exclude any JAR index or cryptographic signature files matching the following patterns:
    • META-INF/INDEX.LIST
    • META-INF/*.SF
    • META-INF/*.DSA
    • META-INF/*.RSA
  • Creates and registers the shadow component in the project (used for integrating with maven-publish).
  • Configures the uploadShadow task (as part of the maven plugin) with the following behavior:
    • Removes the compile and runtime configurations from the pom.xml file mapping.
    • Adds the shadow configuration to the pom.xml file as RUNTIME scope.

Shadowing Gradle Plugins

Shadow ships with a companion task that can be used to automatically discover dependency packages and configure them for relocation. This is useful in projects if you want to relocate all dependencies.

For more details see the section Using Shadow to Package Gradle Plugins