<commit_before>The Gradle team is excited to announce Gradle @version@.

This release features [1](), [2](), ... [n](), and more.

We would like to thank the following community contributors to this release of Gradle:
<!-- 
Include only their name, impactful features should be called out separately below.
 [Some person](https://github.com/some-person)
-->
[<NAME>.](https://github.com/miokowpak),
[<NAME>](https://github.com/remal),
[wreulicke](https://github.com/wreulicke),
[<NAME>](https://github.com/jrodbx),
[mig4](https://github.com/mig4),
[<NAME>](https://github.com/Godin),
[<NAME>](https://github.com/simon04),
[<NAME>](https://github.com/sschuberth),
and [<NAME>](https://github.com/ivoanjo).

<!-- 
## 1

details of 1

## 2

details of 2

## n
-->

## Substitute closed Eclipse projects in Buildship

Closed gradle projects in an eclipse workspace can now be substituted for their respective jar files. In addition to this 
those jars can now be built during Buildship eclipse model synchronization.

The upcoming version of Buildship is required to take advantage of this behavior.

## Upgrade Instructions

Switch your build to use Gradle @version@ by updating your wrapper:

`./gradlew wrapper --gradle-version=@version@`

See the [Gradle 5.x upgrade guide](userguide/upgrading_version_5.html#changes_@baseVersion@) to learn about deprecations, breaking changes and other considerations when upgrading to Gradle @version@.

<!-- Do not add breaking changes or deprecations here! Add them to the upgrade guide instead. --> 

## Improvements for plugin authors

### Task dependencies are honored for `@Input` properties of type `Property`

TBD - honors dependencies on `@Input` properties.

### Property methods

TBD - added `getLocationOnly()`. 

## Building native software with Gradle

All new C++ documentations including new user manual chapters for [building](userguide/building_cpp_projects.html) and [testing](userguide/cpp_testing.html) C++ projects, [DSL reference for C++ components](dsl/index.html#N10808), [C++ plugins reference chapters](userguide/plugin_reference.html#native_languages) and [Visual Studio and Xcode IDE plugins reference chapters](userguide/plugin_reference.html#ide_integration).
The [C++ guides](https://gradle.org/guides/?q=Native) were also improved to reflect all the new features available to C++ developers.
See more information about the [Gradle native project](https://github.com/gradle/gradle-native/blob/master/docs/RELEASE-NOTES.md#changes-included-in-gradle-55).

## Promoted features
Promoted features are features that were incubating in previous versions of Gradle but are now supported and subject to backwards compatibility.
See the User Manual section on the “[Feature Lifecycle](userguide/feature_lifecycle.html)” for more information.

The following are the features that have been promoted in this Gradle release.

## Improved handling of ZIP archives on classpaths

Compile classpath and runtime classpath analysis will now detect the most common zip extension instead of only supporting `.jar`.
It will inspect nested zip archives as well instead of treating them as blobs. This improves the likelihood of cache hits for tasks
that take such nested zips as an input, e.g. when testing applications packaged as a fat jar.

The ZIP analysis now also avoids unpacking entries that are irrelevant, e.g. resource files on a compile classpath. 
This improves performance for projects with a large amount of resource files.

<!--
### Example promoted<commit_msg>Add file case change recognition mention to the release notes<commit_after>The Gradle team is excited to announce Gradle @version@.

This release features [1](), [2](), ... [n](), and more.

We would like to thank the following community contributors to this release of Gradle:
<!-- 
Include only their name, impactful features should be called out separately below.
 [Some person](https://github.com/some-person)
-->
[<NAME>.](https://github.com/miokowpak),
[<NAME>](https://github.com/remal),
[wreulicke](https://github.com/wreulicke),
[<NAME>](https://github.com/jrodbx),
[mig4](https://github.com/mig4),
[<NAME>](https://github.com/Godin),
[<NAME>](https://github.com/simon04),
[<NAME>](https://github.com/sschuberth),
and [<NAME>](https://github.com/ivoanjo).

<!-- 
## 1

details of 1

## 2

details of 2

## n
-->

## Substitute closed Eclipse projects in Buildship

Closed gradle projects in an eclipse workspace can now be substituted for their respective jar files. In addition to this 
those jars can now be built during Buildship eclipse model synchronization.

The upcoming version of Buildship is required to take advantage of this behavior.

## Upgrade Instructions

Switch your build to use Gradle @version@ by updating your wrapper:

`./gradlew wrapper --gradle-version=@version@`

See the [Gradle 5.x upgrade guide](userguide/upgrading_version_5.html#changes_@baseVersion@) to learn about deprecations, breaking changes and other considerations when upgrading to Gradle @version@.

<!-- Do not add breaking changes or deprecations here! Add them to the upgrade guide instead. --> 

## Improvements for plugin authors

### Task dependencies are honored for `@Input` properties of type `Property`

TBD - honors dependencies on `@Input` properties.

### Property methods

TBD - added `getLocationOnly()`. 

## Building native software with Gradle

All new C++ documentations including new user manual chapters for [building](userguide/building_cpp_projects.html) and [testing](userguide/cpp_testing.html) C++ projects, [DSL reference for C++ components](dsl/index.html#N10808), [C++ plugins reference chapters](userguide/plugin_reference.html#native_languages) and [Visual Studio and Xcode IDE plugins reference chapters](userguide/plugin_reference.html#ide_integration).
The [C++ guides](https://gradle.org/guides/?q=Native) were also improved to reflect all the new features available to C++ developers.
See more information about the [Gradle native project](https://github.com/gradle/gradle-native/blob/master/docs/RELEASE-NOTES.md#changes-included-in-gradle-55).

## Promoted features
Promoted features are features that were incubating in previous versions of Gradle but are now supported and subject to backwards compatibility.
See the User Manual section on the “[Feature Lifecycle](userguide/feature_lifecycle.html)” for more information.

The following are the features that have been promoted in this Gradle release.

## Improved handling of ZIP archives on classpaths

Compile classpath and runtime classpath analysis will now detect the most common zip extension instead of only supporting `.jar`.
It will inspect nested zip archives as well instead of treating them as blobs. This improves the likelihood of cache hits for tasks
that take such nested zips as an input, e.g. when testing applications packaged as a fat jar.

The ZIP analysis now also avoids unpacking entries that are irrelevant, e.g. resource files on a compile classpath. 
This improves performance for projects with a large amount of resource files.

## File case changes are handled for `copy` and `sync` tasks

On case insensitive file systems (e.g. `Windows` and `Mac`), a file/folder rename (where only the case is changed) will now be detected properly in `copy` and related tasks (e.g. `sync`).
The task's subsequent run will not be up-to-date and won't truncate the output anymore.

<!--
### Example promoted
{'fraction_non_alphanumeric': 0.09896463627806912, 'fraction_numerical': 0.005109587199139438, 'mean_word_length': 4.988727858293076, 'pattern_counts': {'":': 0, '<': 25, '<?xml version=': 0, '>': 23, 'https://': 24, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2547081', 'n_tokens_mistral': 2076, 'n_tokens_neox': 1983, 'n_words': 858}