examples.md
April 17, 2026 ยท View on GitHub
GraalVM + Bazel Examples
This codebase embeds some examples which are used for integration testing. You can find these at:
example/integration_tests
The following table explains each example. These can be used as starters for various Bazel versions with the latest copy of GraalVM CE.
Available examples
All examples are continuously tested in CI.
| Path | Bazel version(s) | Rule type | OS support | Notes |
|---|---|---|---|---|
bzlmod | Bazel 5+ with Bzlmod | Modern | Linux, macOS, Windows | Example Native Image build via Bzlmod |
workspace | Bazel 5+ with WORKSPACE | Modern | Linux, macOS, Windows | Example Native Image build via Workspace |
bazel5 | Bazel 5 | Legacy | Linux, macOS | Bazel 5 example project |
bazel6 | Bazel 6 | Modern | Linux, macOS, Windows | Bazel 6 example project |
graalvm-ce-17 | Bazel 7 | Modern | Linux, macOS, Windows | Bazel 7 with GraalVM CE 17 |
graalvm-ce-20 | Bazel 7 | Modern | Linux, macOS, Windows | Bazel 7 with GraalVM CE 20 |
graalvm-oracle-17 | Bazel 7 | Modern | Linux, macOS, Windows | Bazel 7 with Oracle GraalVM 17 |
graalvm-oracle-20 | Bazel 7 | Modern | Linux, macOS, Windows | Bazel 7 with Oracle GraalVM 20 |
components-ce | Bazel 7 | N/A | Linux, macOS, Windows | Installing and using GraalVM CE components like js |
components-oracle | Bazel 7 | N/A | Linux, macOS, Windows | Installing and using Oracle GraalVM components like js |
maven-artifacts | Bazel 7 | N/A | Linux, macOS, Windows | Using GraalVM Maven artifacts with rules_jvm_external |
legacy-gvm | Bazel 7 with WORKSPACE | Legacy | Linux, macOS | Example modern rules with older GraalVM version (22.1.0, Java 11) |
legacy-rules | Bazel 5+ with WORKSPACE | Legacy | Linux, macOS | Example legacy rules with older GraalVM version (22.1.0, Java 11) |
Specific version notes
See below for use notes with specific versions of bazel.
Bazel 5
Bazel 5 seems to have issues with the stricter build environment configurations offered by these rules. If you see issues with DEVELOPER_DIR on macOS, or issues resolving Visual Studio on Windows, you should try the legacy rules.