From 63e03405623cb67225a6bdf941a8747240e8993c Mon Sep 17 00:00:00 2001 From: Fabio Niephaus Date: Thu, 26 Jun 2025 08:46:11 +0200 Subject: [PATCH] Revise `README.md`. (#169) Co-authored-by: Olga Gupalo --- README.md | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 3e33518..1939895 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # GitHub Action for GraalVM [![CI](https://github.com/graalvm/setup-graalvm/actions/workflows/ci.yml/badge.svg)](https://github.com/graalvm/setup-graalvm/actions/workflows/ci.yml) -This GitHub action sets up [Oracle GraalVM][graalvm-medium], GraalVM [Community Edition (CE)][repo], [Enterprise Edition (EE)][graalvm-ee], [Mandrel][mandrel], or [Liberica Native Image Kit][liberica] as well as [Native Image][native-image] and GraalVM components such as [Truffle languages][truffle-languages]. + +Set up your GitHub Actions workflow with a specific [GraalVM][graalvm] distribution, and use it both as your JDK and for [ahead-of-time Native Image compilation][graalvm]. + ## Key Features @@ -7,12 +9,10 @@ This action: - supports Oracle GraalVM [releases][graalvm-dl], [EA builds][ea-builds], GraalVM Community Edition (CE) [releases], [dev builds][dev-builds], GraalVM Enterprise Edition (EE) [releases][graalvm-ee] (set [`gds-token`](#options)) 22.1.0 and later, [Mandrel][mandrel], and [Liberica Native Image Kit][liberica] (see [Options](#options)) - exports a `$GRAALVM_HOME` environment variable -- adds `$GRAALVM_HOME/bin` to the `$PATH` environment variable
(Native Image, Truffle languages, and tools can be invoked directly) +- adds `$GRAALVM_HOME/bin` to the `$PATH` environment variable
(`native-image`, `javac`, and other JDK tools can be invoked directly) - sets `$JAVA_HOME` to `$GRAALVM_HOME` by default
(can be disabled via `set-java-home: 'false'`, see [Options](#options)) - supports `x64` and `aarch64/arm64` (see how to use [Linux arm64 runners](https://github.blog/changelog/2025-01-16-linux-arm64-hosted-runners-now-available-for-free-in-public-repositories-public-preview/)) - supports dependency caching for Apache Maven, Gradle, and sbt (see [`cache` option](#options)) -- sets up Windows environments with build tools using [vcvarsall.bat][vcvarsall] -- has built-in support for GraalVM components and the [GraalVM Updater][gu] ## Templates @@ -270,21 +270,16 @@ Only pull requests from committers that can be verified as having signed the OCA [gha-self-hosted-runners]: https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners [gu]: https://www.graalvm.org/reference-manual/graalvm-updater/ [graalvm]: https://www.graalvm.org/ -[graalvm-dl]: https://www.oracle.com/java/technologies/downloads/ -[graalvm-medium]: https://medium.com/graalvm/a-new-graalvm-release-and-new-free-license-4aab483692f5 +[graalvm-dl]: https://www.graalvm.org/downloads/ [graalvm-ee]: https://www.oracle.com/downloads/graalvm-downloads.html [liberica]: https://bell-sw.com/liberica-native-image-kit/ [mandrel]: https://github.com/graalvm/mandrel [mandrel-releases]: https://github.com/graalvm/mandrel/releases [mandrel-stable]: https://github.com/graalvm/mandrel/releases/latest [musl]: https://musl.libc.org/ -[native-image]: https://www.graalvm.org/native-image/ [native-image-musl-build]: https://github.com/graalvm/setup-graalvm/blob/778131f1d6837ccd4b2e91382c31830896a2d56e/.github/workflows/test.yml#L74-L92 [native-image-static]: https://github.com/oracle/graal/blob/fa6f4a974dedacf4688dcc430dd100849d9882f2/docs/reference-manual/native-image/StaticImages.md [oca]: https://oca.opensource.oracle.com [releases]: https://github.com/graalvm/graalvm-ce-builds/releases -[repo]: https://github.com/oracle/graal [setup-java-caching]: https://github.com/actions/setup-java/tree/5b36705a13905facb447b6812d613a06a07e371d#caching-packages-dependencies [stable]: https://github.com/graalvm/graalvm-ce-builds/releases/latest -[truffle-languages]: https://www.graalvm.org/reference-manual/languages/ -[vcvarsall]: https://docs.microsoft.com/en-us/cpp/build/building-on-the-command-line