setup-java/README.md

65 lines
1.7 KiB
Markdown
Raw Normal View History

2019-07-17 01:28:00 +08:00
# setup-java
2019-08-13 03:12:48 +08:00
<p align="left">
<a href="https://github.com/actions/setup-java"><img alt="GitHub Actions status" src="https://github.com/actions/setup-java/workflows/Main%20workflow/badge.svg"></a>
</p>
2019-07-17 22:56:53 +08:00
This action sets up a java environment for use in actions by:
- optionally downloading and caching a version of java by version and adding to PATH. Downloads from [Azul's Zulu distribution](http://static.azul.com/zulu/bin/).
- registering problem matchers for error output
# Usage
See [action.yml](action.yml)
Basic:
```yaml
2019-07-26 09:24:28 +08:00
steps:
2019-07-24 03:16:03 +08:00
- uses: actions/checkout@latest
2019-08-01 21:40:31 +08:00
- uses: actions/setup-java@v1
2019-07-17 22:56:53 +08:00
with:
2019-08-14 04:24:39 +08:00
java-version: '9.0.4' // The JDK version to make available on the path. Takes a whole or semver Jdk version, or 1.x syntax (e.g. 1.8 => Jdk 8.x)
2019-07-17 22:56:53 +08:00
architecture: x64 // (x64 or x86) - defaults to x64
- run: java -cp java HelloWorldApp
```
From local file:
```yaml
2019-07-26 09:24:28 +08:00
steps:
2019-07-24 03:46:09 +08:00
- uses: actions/checkout@master
2019-08-01 21:40:31 +08:00
- uses: actions/setup-java@v1
2019-07-17 22:56:53 +08:00
with:
2019-08-14 04:24:39 +08:00
java-version: '4.0.0'
2019-07-17 22:56:53 +08:00
architecture: x64
2019-08-16 22:21:42 +08:00
jdkFile: <path to jdkFile> # Optional - jdkFile to install java from. Useful for versions not supported by Azul
2019-07-17 22:56:53 +08:00
- run: java -cp java HelloWorldApp
```
Matrix Testing:
```yaml
jobs:
build:
2019-08-01 23:06:31 +08:00
runs-on: ubuntu-16.04
2019-07-17 22:56:53 +08:00
strategy:
matrix:
2019-08-01 23:06:31 +08:00
java: [ '1.6', '9.0.x', '12.0.2' ]
2019-07-17 22:56:53 +08:00
name: Java ${{ matrix.java }} sample
2019-07-26 09:24:28 +08:00
steps:
2019-07-24 03:46:09 +08:00
- uses: actions/checkout@master
2019-07-17 22:56:53 +08:00
- name: Setup java
2019-08-01 21:40:31 +08:00
uses: actions/setup-java@v1
2019-07-17 22:56:53 +08:00
with:
2019-08-14 04:24:39 +08:00
java-version: ${{ matrix.java }}
2019-07-17 22:56:53 +08:00
architecture: x64
- run: java -cp java HelloWorldApp
```
# License
The scripts and documentation in this project are released under the [MIT License](LICENSE)
# Contributions
Contributions are welcome! See [Contributor's Guide](docs/contributors.md)