Integrating with Application Plugin

Shadow reacts to the presence of Gradle’s application plugin and will automatically configure additional tasks for running the shadowed JAR and creating distributions containing the shadowed JAR.

Just like the normal jar task, when the application plugin is applied, the shadowJar manifest will be configured to contain the Main-Class attribute with the value specified in the project’s mainClassName attribute.

KotlinGroovy

plugins {
  application
  id("com.gradleup.shadow")
}

application {
  mainClass = "myapp.Main"
}

plugins {
  id 'application'
  id 'com.gradleup.shadow'
}

application {
  mainClass = 'myapp.Main'
}

Running the Shadow JAR

When applied along with the application plugin, the runShadow task will be created for starting the application from the shadowed JAR. The runShadow task is a JavaExec task that is configured to execute java -jar myproject-all.jar. It can be configured the same as any other JavaExec task.

KotlinGroovy

plugins {
  application
  id("com.gradleup.shadow")
}

application {
  mainClass = "myapp.Main"
  // Optionally, you can add default JVM arguments to the start scripts like this:
  applicationDefaultJvmArgs = listOf("--add-opens=java.base/java.lang=ALL-UNNAMED")
}

tasks.runShadow {
  args("foo")
}

plugins {
  id 'application'
  id 'com.gradleup.shadow'
}

application {
  mainClass = 'myapp.Main'
  // Optionally, you can add default JVM arguments to the start scripts like this:
  applicationDefaultJvmArgs = ['--add-opens=java.base/java.lang=ALL-UNNAMED']
}

tasks.named('runShadow', JavaExec) {
  args 'foo'
}

Distributing the Shadow JAR

The Shadow plugin will also configure distribution tasks when in the presence of the application plugin. The plugin will create shadowDistZip and shadowDistTar which creates Zip and Tar distributions respectively. Each distribution will contain the shadowed JAR file along with the necessary start scripts to launch the application.

Additionally, the plugin will create the installShadowDist and startShadowScripts tasks which stages the necessary files for a distribution to build/install/<project name>-shadow/.

You can also add more files into the distribution like:

KotlinGroovy

plugins {
  application
  id("com.gradleup.shadow")
}

application {
  mainClass = "myapp.Main"
  // Optionally, you can include `some/dir` files in the distribution like this:
  applicationDistribution.from("some/dir") {
    include("*.txt")
  }
}

// `shadow` is the name of the distribution created by Shadow plugin
distributions.named("shadow") {
  // Optionally, you can add more files into extra directory in the distribution like this:
  contents.from("extra/echo.sh") {
    into("extra")
  }
}

plugins {
  id 'application'
  id 'com.gradleup.shadow'
}

application {
  mainClass = 'myapp.Main'
  // Optionally, you can include `some/dir` files in the distribution like this:
  applicationDistribution.from('some/dir') {
    include '*.txt'
  }
}

// `shadow` is the name of the distribution created by Shadow plugin
distributions.named('shadow') {
  // Optionally, you can add more files into extra directory in the distribution like this:
  contents.from('extra/echo.sh') {
    into 'extra'
  }
}

View the official doc described for more information about configuring distributions.