Upgrading GraalVM

After upgrading the project to a newer version of GraalVM, all developers must take the following actions to be able to continue development after the upgrade:

1. Download the new JVM version and set it as the default for the project. If you use IntelliJ, you will also need to update the JVM used for the project in the project settings.
2. Re-run sbt bootstrap to get the updated Truffle JAR (if there are issues updating, removing engine/runtime/build-cache directory may help).
3. Do a full clean (it may not always be required, but not doing it often leads to problems so it is much safer to do it) by running enso/clean.

Upgrading the Build

If you are upgrading the build to a new GraalVM version, you additionally need to perform the following tasks:

• Change the expected GraalVM version in the build.sbt configuration. This is both a version number and (if it is changed), the associated version of Java.
• Update version of ANTLR dependency to match Truffle's to avoid spurious warnings in Native Image
• Change the base image in the Dockerfile to contain the correct GraalVM version.
• Just to be sure, search for the version regex in all the files in the repo.
• Ensure that all deprecations have been handled.