v4.0.0

Final release of v4.0.0 of the setup-gradle, dependency-submission and wrapper-validation actions provided under gradle/actions.
This release is available under the v4 tag.

Major changes from the v3 release

The arguments parameter has been removed

Using the action to execute Gradle via the arguments parameter was deprecated in v3 and this parameter has been removed.
See here for more details.

Cache cleanup enabled by default

After a number of fixes and improvements, this release enables cache-cleanup by default for all Jobs using the setup-gradle and dependency-submission actions.

Improvements and bugfixes related cache cleanup:

• By default, cache cleanup is not run if any Gradle build fails (#71)
• Cache cleanup is not run after configuration-cache reuse (#19)

This feature should help to minimize the size of entries written to the GitHub Actions cache, speeding up builds and reducing cache usage.

Wrapper validation enabled by default

In v3, the setup-gradle action was enhanced to support Gradle wrapper validation, removing the need to use a separate workflow
file with the gradle/actions/wrapper-validation action.

With this release, wrapper validation has been significantly improved, and is now enabled by default (#12):

• The allow-snapshot-wrappers makes it possible to validate snapshot wrapper jars using setup-gradle.
• Checksums for nightly and snapshot Gradle versions are now validated (#281).
• Valid wrapper checksums are cached in Gradle User Home, reducing the need to retrieve checksum values remotely (#172).
• Reduce network calls in wrapper-validation for new Gradle versions: By only fetching wrapper checksums for Gradle versions that were not known when this action was released, this release reduces the likelihood that a network failure could cause failure in wrapper validation (#171)
• Improved error message when wrapper-validation finds no wrapper jars (#284)

Wrapper validation is important for supply-chain integrity. Enabling this feature by default will increase the coverage of wrapper
validation on projects using GitHub Actions.

New input parameters for Dependency Graph generation

Some dependency-graph inputs that could previously only be configured via environment variables now have dedicated action inputs:

• dependency-graph-report-dir: sets the location where dependency-graph reports will be generated
• dependency-graph-exclude-projects and dependency-graph-include-projects: select which Gradle projects will contribute to the generated dependency graph.
• dependency-graph-exclude-configurations and dependency-graph-include-configurations: select which Gradle configurations will contribute to the generated dependency graph.

Other improvements

• In Job summary, the action now provides an explanation when cache is set to read-only or disabled (#255)
• When setup-gradle requests a specific Gradle version, the action will no longer download and install that version if it is already available on the PATH of the runner (#270)
• To attempt to speed up builds, the setup-gradle and dependency-submission actions now attempt to use the D: drive for Gradle User Home if it is available (#290)

Deprecations and breaking changes

• The gradle-home-cache-cleanup input parameter has been deprecated and replaced by cache-cleanup
• The undocumented dependency-graph: clear parameter has been removed without replacement
• The following parameters deprecated in v3 have been removed:
  • arguments
  • build-scan-terms-of-service-url and build-scan-terms-of-service-agree

Changelog

• Only fetch checksums for unknown wrapper versions by @bigdaz in #292
• Isolate 'dependency-submission' action from 'setup-gradle' by @bigdaz in #293
• Caching improvements by @bigdaz in #294
• Config cache cleanup by @bigdaz in #295
• Delete excluded paths on restore Gradle Home by @bigdaz in #298
• Use faster D: drive on windows for Gradle User Home and Gradle downloads by @bigdaz in #299
• Always set the GRADLE_USER_HOME env var by @bigdaz in #300
• Fix windows by @bigdaz in #302
• Use pre-installed Gradle when available by @bigdaz in #301
• Prepare for v4 release by @bigdaz in #303
• Include RUNNER_ARCH in cache key by @bigdaz in #305
• Introduce dependency graph params by @bigdaz in #304
• Finish enabling cache-cleanup by default by @bigdaz in #306
• Bump references to Develocity Gradle plugin from 3.17.5 to 3.17.6 by @bot-githubaction in #315
• Group cache-cleanup log messages by @bigdaz in #319
• Enable wrapper-validation by default in setup-gradle by @bigdaz in #318
• Improve error messages for min-wrapper-count by @bigdaz in #321

Full Changelog: v3.5.0...v4.0.0

v4.0.0-rc.1

First release candidate for v4 of the setup-gradle, dependency-submission and wrapper-validation actions provided under gradle/actions. As no issues were reported, this release candidate has been promoted as v4.0.0.
This is the first release available under the v4 tag.

Full Changelog: v3.5.0...v4.0.0-rc.1

v4.0.0-beta.2

Second beta release for v4 of the setup-gradle, dependency-submission and wrapper-validation actions provided under gradle/actions.
This release (and all subsequent releases leading up to v4) will be available under the prerelease/v4 tag. eg.

uses: gradle/actions/setup-gradle@prerelease/v4

Full Changelog: v3.5.0...v4.0.0-beta.2

v4.0.0-beta.1

First beta release for v4 of the setup-gradle, dependency-submission and wrapper-validation actions provided under gradle/actions.
This release (and all subsequent releases leading up to v4) will be available under the prerelease/v4 tag. eg.

Full Changelog: v3.5.0...v4.0.0-beta.1

v3.5.0

This release contains a major upgrade to gradle-home-cache-cleanup as well as improvements to dependency-submission.

What's Changed

• Include Gradle 8.9 in known wrapper checksums (avoiding the need to download) (#266)
• Improvements to cache-cleanup
  • Provision latest Gradle version to use for cache-cleanup (#33, #271)
  • Avoid use of timestamp manipulation for cache-cleanup (#24, #272)
  • Cleanup artifact transforms cache in Gradle home (#47)
  • More logging from cache-cleanup operation (#169)
• Use latest dependency graph plugin (#269)
  • Avoid resolving configurations that are deprecated for resolving (gradle/github-dependency-graph-gradle-plugin#129)
  • Avoid circular task dependency when build includes itself (gradle/github-dependency-graph-gradle-plugin#141)
• Automatically upload dependency graph file on submission failure (#291)

Full Changelog: v3.4.2...v3.5.0

v3.4.2

This patch release fixes a race condition that resulted in the DEVELOCITY_ACCESS_KEY variable not being set in the environment.

What's Changed

• Fix race condition with fetching short lived token by @alextu in #260

Full Changelog: v3.4.1...v3.4.2

v3.4.1

This patch release fixes a bug introduced in v3.4.0, that prevents build scan publication to Develocity.
The bug results in the removal of the DEVELOCITY_ACCESS_KEY variable being removed, so that Gradle cannot authenticate with the Develocity server.

What's Changed

• Don't clear access key when access token cannot be obtained by @cdsap in #258
• Simplify requesting short-lived Develocity access tokens by @bigdaz in #259

Full Changelog: v3.4.0...v3.4.1

v3.4.0

This release improves the integration with Gradle Develocity®, as well as updating a number of key dependencies.

• The new develocity-access-key input parameter allows the action to generate a short-lived access token for subsequent
  communication with Develocity. This reduces the risk of the full (long-lived) access key being compromised,
  either accidentally or by a malicious action.
• New input parameters are available to configure Develocity injection. Previously Develocity injection could only be
  enabled by setting environment variables.
• Checksums for Gradle 8.8 are now included, so that no network request is required for wrapper-validation with Gradle 8.8 wrappers.

What's Changed

• Add support for short-lived tokens by @alextu in #224
• Update known wrapper checksums by @github-actions in #240
• Update to Gradle 8.8 by @bigdaz in #251
• Adding Develocity input actions by @cdsap in #244
• Fail on invalid boolean for Develocity inputs by @bigdaz in #252

New Contributors

• @serieznyi made their first contribution in #216
• @lokalpage-safe made their first contribution in #205
• @alextu made their first contribution in #224
• @bot-githubaction made their first contribution in #227
• @antonmos made their first contribution in #234
• @cdsap made their first contribution in #244

Full Changelog: v3.3.2...v3.4.0

v3.3.2

This patch release fixes a bug in both dependency-submission and setup-gradle (#196 introduced in v3.3.1), which resulted in
"No dependency-graph files found to submit" when using the download-and-submit function.
A number of other minor issues have also been addressed:

What's Changed

• [dependency-submission] Fix bug finding dependency-graph files with 'download-and-submit' (#199)
• [dependency-submission] Use Gradle logger instead of println in dependency graph init script (#191 from @aleksandrserbin)
• [dependency-submission] Retain and log full stacktrace for dependency submission errors (#192)
• [setup-gradle] Improve build scan badge readability with long task names (#200 from @gabrielfeo)

Full Changelog: v3.3.1...v3.3.2

v3.3.1

This patch release fixes a bug in setting the report dir for dependency-submission, and updates the plugin versions
applied in Develocity injection.

What's Changed

• Bump Develocity and CCUD plugin versions (#185)
• Support custom DEPENDENCY_GRAPH_REPORT_DIR variable for dependency-submission (#188)

Full Changelog: v3.3.0...v3.3.1