mirror of
https://github.com/gradle/gradle-build-action.git
synced 2024-12-25 08:12:10 -05:00
Add a section explaining advantages
This commit is contained in:
parent
f2dc0d8256
commit
c12283ec57
1 changed files with 13 additions and 0 deletions
13
README.md
13
README.md
|
@ -39,6 +39,19 @@ Each invocation will start its run with the filesystem state remaining from the
|
||||||
arguments: check
|
arguments: check
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Why is this better than running Gradle directly?
|
||||||
|
|
||||||
|
It is possible to directly invoke Gradle in your workflow, and the `setup-java` action provides a simple way to cache Gradle dependencies.
|
||||||
|
|
||||||
|
However, the `gradle-build-action` offers a number of advantages over this approach:
|
||||||
|
|
||||||
|
- Easily [run the build with different versions of Gradle](#download-install-and-use-a-specific-gradle-version) using the `gradle-version` parameter. Gradle distributions are automatically downloaded and cached.
|
||||||
|
- More sophisticated and more efficient caching of Gradle User Home between invocations, compared to `setup-java` and most custom configurations using `actions/cache`. [More details below](#caching).
|
||||||
|
- Detailed reporting of cache usage and cache configuration options allow you to [optimize the use of the GitHub actions cache](#optimizing-cache-effectiveness).
|
||||||
|
- [Automatic capture of build scan links](#build-scans) from the build, making these easier to locate for workflow run.
|
||||||
|
|
||||||
|
The `gradle-build-action` is designed to provide these benefits with minimal configuration.
|
||||||
|
|
||||||
## Gradle Execution
|
## Gradle Execution
|
||||||
|
|
||||||
### Command-line arguments
|
### Command-line arguments
|
||||||
|
|
Loading…
Reference in a new issue