Skip to content

feat: Add support for .sdkmanrc file in java-version-file parameter #736

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
HarithaVattikuti merged 13 commits into from
Nov 25, 2025
Merged

feat: Add support for .sdkmanrc file in java-version-file parameter #736

Changes from 1 commit
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
b185b99
chore(e2e-versions): Add e2e test scenario on `setup-java-version-fro…
guicamest Jan 24, 2025
47407b3
chore(e2e-versions): Update `setup-java-version-from-file-major-minor…
guicamest Jan 24, 2025
556a113
feat: Add support for `.sdkmanrc` as *Java Version File*
guicamest Jan 25, 2025
3228b7f
chore: Add test for the latest known sdkman java versions
guicamest Jan 25, 2025
b38bd61
docs(advanced-usage): Document support for `.sdkmanrc` as java-versio…
guicamest Jan 25, 2025
dd4a6bd
chore(docs): Anyone can contribute and maintain :shrug:
guicamest Jan 25, 2025
54b5143
Update advanced-usage.md
guicamest Nov 13, 2025
507f216
Update advanced-usage.md
guicamest Nov 14, 2025
ebfc458
Update util.ts
guicamest Nov 14, 2025
d6f9a13
chore: format and rebuild
guicamest Nov 19, 2025
95f21d2
Merge branch 'actions:main' into feat/669/support_sdkmanrc
guicamest Nov 19, 2025
a985bcf
chore: untouch toolchains.ts
guicamest Nov 20, 2025
73b943d
fix check dist error
mahabaleshwars Nov 21, 2025
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
docs(advanced-usage): Document support for .sdkmanrc as java-versio… 
…n-file
  • Loading branch information
@guicamest
guicamest committed Nov 4, 2025
commit b38bd6186dd699bdcb8ea1357232299605b57792
15 changes: 10 additions & 5 deletions docs/advanced-usage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -601,14 +601,19 @@ steps:
## Java version file
If the `java-version-file` input is specified, the action will extract the version from the file and install it.

Supported files are .java-version and .tool-versions.
In .java-version file, only the version should be specified (e.g., 17.0.7).
In .tool-versions file, java version should be preceded by the java keyword (e.g., java 17.0.7).
The `.java-version` file recognizes all variants of the version description according to [jenv](https://github.com/jenv/jenv). Similarly, the `.tool-versions` file supports version specifications in accordance with [asdf](https://github.com/asdf-vm/asdf) standards, adhering to Semantic Versioning ([semver](https://semver.org/)).
Supported files are `.java-version`, `.tool-versions` and `.sdkmanrc`.
In `.java-version` file, only the version should be specified (e.g., 17.0.7).
In `.tool-versions` file, java version should be preceded by the java keyword (e.g., java 17.0.7).
In `.sdkmanrc` file, java version should be preceded by the `java=` prefix (e.g., java=17.0.7-tem) and include the distribution.
The `.java-version` file recognizes all variants of the version description according to [jenv](https://github.com/jenv/jenv).
Similarly, the `.tool-versions` file supports version specifications in accordance with [asdf](https://github.com/asdf-vm/asdf)
standards, adhering to Semantic Versioning ([semver](https://semver.org/)).
The `.sdkmanrc` file supports version specifications in accordance with [file format](https://sdkman.io/usage#env-command),
see [Sdkman! documentation](https://sdkman.io/jdks) for more information.

If both java-version and java-version-file inputs are provided, the java-version input will be used.

Valid entry options:
Valid entry options (does not apply to `.sdkmanrc`):
```
major versions: 8, 11, 16, 17, 21
more specific versions: 8.0.282+8, 8.0.232, 11.0, 11.0.4, 17.0
Expand Down