Skip to content

Add check-latest flag #141

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
maxim-lobanov merged 14 commits into from
Mar 24, 2021
Merged

Add check-latest flag #141

Changes from 1 commit
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
8f3a7c8
add changes for check-latest
dmitry-shibanov Mar 18, 2021
b592009
run prerelease script
dmitry-shibanov Mar 18, 2021
9887b5c
resolving comments
dmitry-shibanov Mar 18, 2021
94a128f
fixing tests
dmitry-shibanov Mar 18, 2021
d87fc52
fix spelling
dmitry-shibanov Mar 18, 2021
2c10c08
improve core.info messages
Mar 19, 2021
02e59d3
run format
dmitry-shibanov Mar 19, 2021
1088d2a
run prerelease
dmitry-shibanov Mar 19, 2021
7a20e30
change version to fix test
dmitry-shibanov Mar 19, 2021
61c3e48
Merge branch 'v2-preview' into v-dmshib/add-check-latest
dmitry-shibanov Mar 22, 2021
6e6487b
resolve comment for check-latest
dmitry-shibanov Mar 22, 2021
87ce602
Update README.md
Mar 23, 2021
0ebe88b
added hosted tool cache section
Mar 23, 2021
b634050
Apply suggestions from code review
Mar 23, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update README.md
  • Loading branch information
Maxim Lobanov
Maxim Lobanov committed Mar 23, 2021
commit 87ce60218663ca56bfa1dc3b194ed7d46a2d585b
20 changes: 18 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,24 @@ Currently, the following distributions are supported:

**NOTE:** The different distributors can provide discrepant list of available versions / supported configurations. Please refer to the official documentation to see the list of supported versions.

#### Testing against different Java versions
### Check latest
In the basic examples above, the `check-latest` flag defaults to `false`. When set to `false`, the action tries to first resolve a version of Java from the local cache. If unable to find a specific version in the cache, the action will download a version of Java. Use the default or set `check-latest` to `false` if you prefer stability and if you want to ensure a specific version of Java is always used.
Comment thread
maxim-lobanov marked this conversation as resolved.
Outdated
The local version of Java in cache gets updated on weekly basis. For information regarding locally cached versions of Java on GitHub hosted runners, check out [GitHub Actions Virtual Environments](https://github.com/actions/virtual-environments).

If `check-latest` is set to `true`, the action first checks if the cached version is the latest one. If the locally cached version is not the most up-to-date, the latest version of Java will be downloaded. Set `check-latest` to `true` if you want the most up-to-date version of Java to always be used. Setting `check-latest` to `true` has performance implications as downloading versions of Java is slower than using cached versions.

```yaml
steps:
- uses: actions/checkout@v2
- uses: actions/setup-java@v2-preview
with:
distribution: 'adopt'
java-version: '11'
check-latest: true
- run: java -cp java HelloWorldApp
```

### Testing against different Java versions
```yaml
jobs:
build:
Expand Down Expand Up @@ -90,7 +107,6 @@ jobs:
- [Publishing using Apache Maven](docs/advanced-usage.md#Publishing-using-Apache-Maven)
- [Publishing using Gradle](docs/advanced-usage.md#Publishing-using-Gradle)


## License

The scripts and documentation in this project are released under the [MIT License](LICENSE)
Expand Down