Merge pull request #270 from bci-oss/268-build-with-graalvm

Document building with GraalVM

Author: atextor

documentation/developer-guide/modules/tooling-guide/pages/java-aspect-tooling.adoc

@@ -42,6 +42,22 @@ To be able to use the artifacts released in this way in your projects, first the
 Then the desired dependencies can be referenced in the usual way. For an example, please refer to 
 https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry#installing-a-package[Github - Installing a package].
 
+[[jdk-requirements]]
+== JDK requirements
+
+The sds-sdk components are built with Java 17 and require a JDK >= 17 such as
+https://adoptium.net/[Adoptium Temurin].
+
+The sds-sdk can also be used with a Java 17-compatible https://www.graalvm.org/[GraalVM JDK]. With
+GraalVM you need to make the Graal JavaScript component available, as parts of the SDK such as the
+Aspect Model validation component require embedded JavaScript execution:
+
+* For using the sds-sdk in the GraalVM itself, install the JS component using the
+  https://www.graalvm.org/22.3/reference-manual/js/[GraalVM Updater]: `gu install js`
+* For using the sds-sdk with GraalVM `native-image`, be sure to use the `--language:js` option when
+  building the native image; for more information see
+  https://www.graalvm.org/22.3/reference-manual/polyglot-programming/[polyglot programming].
+
 [[parsing-aspect-model-urns]]
 == Parsing Aspect Model URNs