wbrawner/gradle-graal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A plugin for Gradle that adds tasks to download, extract and interact with GraalVM tooling.
51 commits 10 branches 16 tags 824 KiB
Java 56%
Groovy 43.9%
Find a file
Carter Kozak 6d96a0134b Upgrade default graal version to 1.0.0-rc13 (from 1.0.0-rc12)
2019-03-10 16:17:32 -04:00
.baseline Excavator: Upgrades Baseline to the latest version (#59) 2019-02-28 18:56:44 +00:00
.circleci Configure CircleCI to cache downloads for check task (#10) 2018-09-06 14:26:31 -07:00
gradle Excavator: Upgrades gradle wrapper to the latest version (#50) 2019-02-25 11:41:32 +00:00
src Upgrade default graal version to 1.0.0-rc13 (from 1.0.0-rc12) 2019-03-10 16:17:32 -04:00
.bulldozer.yml Enable bulldozer (#46) 2019-01-11 15:51:33 -05:00
.excavator.yml Enable bulldozer (#46) 2019-01-11 15:51:33 -05:00
.gitignore Create a basic wrapper around Graal and support the native-image task 2018-08-29 18:12:56 -07:00
.policy.yml Add policy yml (#58) 2019-02-26 22:27:23 +00:00
build.gradle Excavator: Upgrade buildscript dependencies (#69) 2019-03-07 18:16:32 +00:00
gradle.properties Excavator: Enable org.gradle.parallel by default (#14) 2018-09-21 09:19:51 -04:00
gradlew Excavator: Upgrades gradle wrapper to the latest version (#30) 2018-11-28 12:34:44 -05:00
gradlew.bat Excavator: Upgrades gradle wrapper to the latest version (#30) 2018-11-28 12:34:44 -05:00
LICENSE Create a basic wrapper around Graal and support the native-image task 2018-08-29 18:12:56 -07:00
README.md Upgrade default graal version to 1.0.0-rc13 (from 1.0.0-rc12) 2019-03-10 16:17:32 -04:00
settings.gradle Create a basic wrapper around Graal and support the native-image task 2018-08-29 18:12:56 -07:00
versions.props Excavator: Upgrade dependencies (#61) 2019-03-02 00:43:27 +00:00

README.md

gradle-graal

A simple wrapper around GraalVM tooling that will download and locally cache a GraalVM installation and make available select parts of the GraalVM compiler for use in Gradle builds.

To use this plugin, apply com.palantir.graal. See a full example in the ETE tests.

Gradle Tasks

./gradlew nativeImage: create a native image using GraalVM's native-image tool with the configuration as specified by the graal Gradle extension. Outputs are produced to ${projectDir}/build/graal/.

./gradlew sharedLibary: create a shared library using GraalVM's native-image tool with the configuration as specified by the graal Gradle extension. Outputs are produced to ${projectDir}/build/graal/.

Configuration

Configure this plugin and its wrappers around GraalVM tools through the graal extension with the following options:

General GraalVM controls

  • graalVersion: the version string to use when downloading GraalVM (defaults to 1.0.0-rc13)
  • downloadBaseUrl: the base download URL to use (defaults to https://github.com/oracle/graal/releases/download/)

native-image controls

  • outputName: the name to use for the image output
  • mainClass: the main class entry-point for the image to run
  • option: additional native-image options https://github.com/oracle/graal/blob/master/substratevm/OPTIONS.md

Local GraalVM Tooling Cache

We maintain a number of different repositories, and rather than re-download tooling and cache it per repository, this plugin maintains a central cache in the user's home directory (~/.gradle/caches/com.palantir.graal). Tooling artifacts are cached by version, so multiple projects referring to different GraalVM versions will not corrupt the cache.

No locking is performed to check the atomicity of changes to the cache, so users should not expect this plugin to be well behaved when populating the cache from parallel processes.

Contributions

Contributions are welcome. For larger feature requests or contributions, we prefer discussing the proposed change on a GitHub issue prior to a PR.

License

This plugin is made available under the Apache 2.0 License.