Change Log

v5.0.0 (2019-02-28)

v4.0.4 (2019-01-19)

  • When using shadow, application, and maven plugins together, remove shadowDistZip and shadowDistTar from configurations.archives so they are not published or installed by default with the uploadArchives or install tasks. #347
  • James Nelson - Fix null path when using Jar minimization and Gradle's api configuration. #424, #425

v4.0.3 (2018-11-21)

v4.0.2 (2018-10-27)

v4.0.1 (2018-09-30)

  • Breaking Change! Transform.modifyOutputStream(ZipOutputStream os) to Transform.modifyOutputStream(ZipOutputStream jos, boolean preserveFileTimestamps). Typically breaking changes are reserved for major version releases, but this change was necessary for preserverFileTimestamps (introduced in v4.0.0) to work correctly in the presence of transformers, #404
  • Fix regression in support Java 10+ during relocation, #403

v4.0.0 (2018-09-25)

  • Breaking Change! Restrict Plugin to Gradle 4.0+. Shadow major versions will align with Gradle major versions going forward.
  • Breaking Change! For clarity purposes com.github.johnrengelman.plugin-shadow has been removed. If you intend to use this feature, you will need to declare your own ConfigureShadowRelocation task. See section 2.9.2 of the User Guide
  • Sergey Tselovalnikov - Upgrade to ASM 6.2.1 to support Java 11
  • Chris Cowan - Add support for shadowJar.preserveFileTimestamps property. See Jar.preserveFileTimestamps
  • Paul N. Baker - Add Log4j2PluginsCacheFileTransformer to process Log4j DAT files during merge.
  • Felipe Lima - Fix the long standing "No property mainClassName" issue.
  • debanne - Implement JAR minimization actions. This will attempt to exclude unused classes in your shadowed JAR.
  • Configure exclusion of module-info.class from shadowJar when using the Shadow the Java plugin, #352

v2.0.4 (2018-04-27)

  • Update to ASM 6.1.1 to address performance issues - ASM Issue 317816
  • Close InputStreams after using them, #364
  • Remove usage of Gradle internal AbstractFileCollection.
  • Add task annotations to remove warnings when validating plugin.

v2.0.3 (2018-03-24)

v2.0.2 (2017-12-12)

v2.0.1 (2017-06-23)

  • Fix null+configuration error, #297

v2.0.0 (2017-05-09)

  • Breaking Change! Restrict Plugin to Gradle 3.0+
  • Breaking Change! Build with Java 7
  • Breaking Change! Updated Transformer interface to accept TransformerContext object instead of individual values
  • Breaking Change! Updated Relocator interface to accept RelocatePathContext and RelocateClassContext objects
  • Breaking Change! Distribution tasks distShadowZip and distShadowTar have been removed and replaced with the standard shadowDistZip and shadowDistTar from the Gradle Distribution plugin.
  • Breaking Change! The installShadowApp task has been removed and replaced with the standard installShadowDist task from the Gradle Distribution plugin.
  • Breaking Change! The new installShadowDist task outputs to build/install/<project name>-shadow per the standard (formerly was build/installShadow)
  • Breaking Change! component.shadow removed in favor of project.shadow.component(publication) so as to remove dependency on internal Gradle APIs.
  • NEW Introducing ConfigureShadowRelocation task and com.github.johnrengelman.plugin-shadow plugin to automatically configure package relocation for Gradle plugins.
  • NEW Integration with Gradle Build Scans. When running a ShadowJar task with Build Scans, custom values including dependencies merged anc package relocations are published in the scan.
  • Build Shadow w/ Shadow. This will help prevent any future classpath conflicts with Gradle.
  • Replace startShadowScripts tasks with Gradle's built-in CreateStartScripts type.
  • Build with Gradle 3.1
  • Marc Philipp - Add keyTransformer property to PropertiesFileTransformer
  • Update to ASM 5.2
  • Piotr Kubowicz - Support api, implementation, runtimeOnly dependency configurations introdcued in Gradle 3.3

v1.2.4 (2016-11-03)

  • Don't resolve dependency configurations during config phase, #128
  • Build plugin with Gradle 2.14
  • Fix docs regarding inheriting Jar manifest, #251
  • Ethan Hall - Support projects that configure uploading to Ivy repositories, #256
  • Force task to depend on dependency configuration, #152
  • Do not explode ZIP files into shadow jar, #196
  • John Szakmeister - Preserve timestamps on merged jar entries, #260

v1.2.3 (2016-01-25)

v1.2.2 (2015-07-17)

v1.2.1 (2015-01-23)

  • Apply package relocations to dependency resources, #114

v1.2.0 (2014-11-24)

  • Re-organize some code to remove need for forcing the Gradle API ClassLoader to allow the package.
  • Upgrade JDOM library from 1.1 to 2.0.5 (change dependency from jdom:jdom:1.1 to org.jdom:jdom2:2.0.5), #98
  • Convert ShadowJar.groovy to to workaround binary incompatibility introduced by Gradle 2.2, #106
  • Updated ASM library to 5.0.3 to support JDK8, #97
  • Allows for regex pattern matching in the dependency string when including/excluding, #83
  • Apply package relocations to resource files, #93

v1.1.2 (2014-09-09)

  • fix bug in runShadow where dependencies from the shadow configuration are not available, #94

v1.1.1 (2014-08-27)

  • Fix bug in 'createStartScripts' task that was causing it to not execute 'shadowJar' task, #90
  • Do not include null in ShadowJar Manifest 'Class-Path' value when jar task does not specify a value for it, #92
  • ShadowJar Manifest 'Class-Path' should reference jars from 'shadow' config as relative to location of shadowJar output, #91

v1.1.0 (2014-08-26)

  • Breaking Change! Fix leaking of shadowJar.manifest into jar.manifest, #82 To simplify behavior, the shadowJar.appendManifest method has been removed. Replace uses with shadowJar.manifest
  • ShadowTask now has a configurations property that is resolved to the files in the resolved configuration before being added to the copy spec. This allows for an easier implementation for filtering. The default 'shadowJar' task has the convention of adding the 'runtime' scope to this list. Manually created instances of ShadowTask have no configurations added by default and can be configured by setting task.configurations.
  • Properly configure integration with the 'maven' plugin when added. When adding 'maven' the 'uploadShadow' task will now properly configure the POM dependencies by removing the 'compile' and 'runtime' configurations from the POM and adding the 'shadow' configuration as a RUNTIME scope in the POM. This behavior matches the behavior when using the 'maven-publish' plugin.
  • Matt Hurne - Allow ServiceFileTransformer to specify include/exclude patterns for files within the configured path to merge.
  • Matt Hurne - Added GroovyExtensionModuleTransformer for merging Groovy Extension module descriptor files. The existing ServiceFileTransformer now excludes Groovy Extension Module descriptors by default.
  • distShadowZip and distShadowZip now contain the shadow library and run scripts instead of the default from the 'application' plugin, #89

v1.0.3 (2014-07-29)

  • Make service files root path configurable for ServiceFileTransformer, #72
  • [Andres Almiray]( - Added PropertiesFileTransformer, #73
  • Brandon Kearby - Fixed StackOverflow when a cycle occurs in the resolved dependency grap, #69
  • Apply Transformers to project resources, #70, #71
  • Minecrell - Do not drop non-class files from dependencies when relocation is enabled, #61
  • Remove support for applying individual sub-plugins by Id (easier maintenance and cleaner presentation in Gradle Portal)

v1.0.2 (2014-07-07)

  • Do not add an empty Class-Path attribute to the manifest when the shadow configuration contains no dependencies.
  • runShadow now registers shadowJar as an input. Previously, runShadow did not execute shadowJar and an error occurred.
  • Support Gradle 2.0, #66
  • Do not override existing 'Class-Path' Manifest attribute settings from Jar configuration. Instead combine, #65

v1.0.1 (2014-06-28)

  • Fix issue where non-class files are dropped when using relocation, #58
  • Do not create a / directory inside the output jar.
  • Fix runShadow task to evaluate the shadowJar.archiveFile property at execution time, #60

v1.0.0 (2014-06-27)

  • Previously known as v0.9.0
  • All changes from 0.9.0-M1 to 0.9.0-M5
  • Properly configure the ShadowJar task inputs to observe the include/excludes from the dependencies block. This allows UP-TO-DATE checking to work properly when changing the dependencies rulea, #54
  • Apply relocation remappings to classes and imports in source project, #55
  • Do not create directories in jar for source of remapped class, created directories in jar for destination of remapped classes, #53


  • Add commons-io to compile classpath
  • Update asm library to 4.1


  • Break plugin into multiple sub-plugins. ShadowBasePlugin is always applied. ShadowJavaPlugin and ShadowApplicationPlugin are applied in reaction to applying the java and application plugins respectively.
  • Shadow does not applied java plugin automatically. java or groovy must be applied in conjunction with shadow.
  • Moved artifact filtering to dependencies {} block underneath shadowJar. This allows better include/exclude control for dependencies.
  • Dependencies added to the shadow configuration are automatically added to the Class-Path attribute in the manifest for shadowJar
  • Applying application plugin and settings mainClassName automatically configures the Main-Class attribute in the manifest for shadowJar
  • runShadow now utilizes the output of the shadowJar and executes using java -jar <shadow jar file>
  • Start Scripts for shadow distribution now utilize java -jar to execute instead of placing all files on classpath and executing main class.
  • Excluding/Including dependencies no longer includes transitive dependencies. All dependencies for inclusion/exclusion must be explicitly configured via a spec.


  • Use FilenameUtils to determine name of resolved jars for including/excluding


  • Added integration with application plugin to replace old OutputSignedJars task
  • Fixed bug that resulted in duplicate file entries in the resulting Jar
  • Changed plugin id to 'com.github.johnrengelman.shadow' to support Gradle 2.x plugin infrastructure.


  • Rewrite based on Gradle Jar Task
  • ShadowJar now extends Jar
  • Removed signedCompile and signedRuntime configurations in favor of shadow configuration
  • Removed OutputSignedJars task