Skip to content

CHANGELOG.md

Latest commit

 

History

History
241 lines (229 loc) · 38.3 KB

CHANGELOG.md

File metadata and controls

241 lines (229 loc) · 38.3 KB
Raw

Native Image Changelog

This changelog summarizes major changes to GraalVM Native Image.

GraalVM 25.1 (Internal Version 25.1.0)

  • (GR-74889) Added Windows support for Native Image JFR recordings and heap dumps.
  • (GR-67169) Added POSIX support for Native Image JFR emergency dumps. When an out-of-memory error occurs while a JFR recording is active, Native Image can preserve in-memory recording data in an emergency JFR file.
  • (GR-75640) Added experimental support for Native Image layered images on Darwin.
  • (GR-53498) Added experimental support for Native Image layered images on AArch64.
  • (GR-73717) Added support for collecting conditional reachability metadata from a native image at run time using -XX:TraceMetadataConditionPackages.
  • (GR-73875) Added --print-options flag to native-image for printing available build options in table, markdown, or JSON format. Automated generation of option documentation from @Option annotations, eliminating manual maintenance of option tables.
  • (GR-70601) (GR-70592) (GR-70593) (GR-70598) (GR-71096): Add experimental support for just-in-time compilation of Java bytecodes loaded at run-time.
  • (GR-73556) Remove the deprecated @AutomaticFeature annotation and its handling. Features should be registered via the --features argument.
  • (GR-44384) Add size warnings for bundles when individual or cumulative file sizes exceed limits. Configure with options size-warning-file-limit and size-warning-total-limit to bundle-create, sizes in MiB.
  • (GR-49923) Make bundle path maps portable across platforms. Bundle format version is now 1.0. Bundles prior to 1.0 can still be used (backward compatible).
  • (GR-43070) Add a new API flag -Werror to treat warnings as errors.
  • (GR-69280) Allow use of the graal. prefix for options without issuing a warning.
  • (GR-2092) Add jitdump support for recording run-time compilation metadata for perf (see PerfProfiling.md). Can be enabled with -g -H:+RuntimeDebugInfo -H:RuntimeDebugInfoFormat=jitdump.
  • (GR-69116) Rename native-image-configure tool to native-image-utils.
  • (GR-69572) Deprecates the native-image-inspect tool. To extract embedded SBOMs, use native-image-utils extract-sbom --image-path=<path_to_binary>.
  • (GR-70136) Add a new tool --tool:llvm-backend for the LLVM backend of Native Image.
  • (GR-68984) Ship the reachability-metadata-schema.json together with GraalVM at <graalvm-home>/lib/svm/schemas/reachability-metadata-schema.json.
  • (GR-68984) Improve the schema to capture detailed constraints about each element in the reachability-metadata-schema.json.
  • (GR-57214) -H:... can now be used at build-time to set new defaults for both build-time and run-time options (for example, run-time option -R:MaxHeapSize can now also be set via -H:MaxHeapSize).
  • (GR-70046) Remove all support for running image builder on classpath.
  • (GR-71146) Make ParseRuntimeOptions a non-experimental flag and extract a separate (experimental) InitializeVM flag. If your project previously used ParseRuntimeOptions and you call VMRuntime.initialize() manually, you might have to disable the new flag.
  • (GR-73848) JNI_CreateJavaVM now runs Native Image startup hooks by default for JNI-created VMs. If your image must delay startup hooks until a later explicit VMRuntime.initialize() call, use -H:-InitializeVM.
  • (GR-69577) Retire --future-defaults=complete-reflection-types. All reflective operations on types registered for reflection will now return complete results.
  • (GR-71698) Introduced a new value for --future-defaults=run-time-initialize-resource-bundles that shifts away from build-time initialization for 'java.util.ResourceBundle'. Unless you store 'ResourceBundle'-related classes in the image heap, this option should not affect you. In case this option breaks your build, follow the suggestions in the error messages.
  • (GR-71607) Deprecated and deleted the FallbackFeature. The flag --no-fallback is deprecated and has no effect any longer, other related options are removed.
  • (GR-71698) Introduced --future-defaults=class-for-name-respects-class-loader that changes 'Class.forName' and 'ClassLoader#loadClass' to respect the class loader arguments.
  • (GR-72689) The context class loader seen during build-time context initialization is now part of the native image module layer. This means that by default, service loaders will now see some extra service providers definition coming from the native image module path.
  • (GR-74050) JFR now uses the safepoint-based execution sampler by default on all platforms. To use the signal-handler-based execution sampler instead, enable -H:+SignalHandlerBasedExecutionSampler.
  • (GR-75242) JFR stack trace support is no longer disabled entirely if runtime compilation is enabled. Instead, individual stack traces are skipped when they contain JIT-compiled code.
  • (GR-63737) Deprecated API function Threading.registerRecurringCallback(...) without replacement. This method should not be used as it is inherently unsafe.
  • (GR-63737) Removed deprecated API function ProcessPropertiesSupport.setLocale(...).
  • (GR-52538) (GR-69523) (GR-73129) Introduce new SerialGC policy Adaptive2 and default to mark-compact collection in the old generation. On average, this reduces memory usage and often improves throughput and latency. Restore the old behavior with: -H:-CompactingOldGen -H:InitialCollectionPolicy=Adaptive.
  • (GR-75348) Allow selecting the Serial GC collection policy at run time with -XX:InitialCollectionPolicy.
  • (GR-71974) Introduced -H:+CompatibilityMode that disables all Native Image features that allow users to diverge from original program semantics: build-time initialization for classpath classes, native-image-specific system properties, substitutions on the classpath, and user features, while enabling all future defaults. This mode does not modify key Native Image restrictions related to dynamic access (reachability metadata) and run-time class loading as those are accepted limitations of native image.
  • (GR-74008) On macOS, the build process now uses memory_pressure for a more accurate detection of free memory.
  • (GR-73792) Added randomized runtime code entry points. Enable with -H:+MaxRuntimeCodeOffset.
  • (GR-73792) Added AMD64 memory masking and fencing mitigation for untrusted code. Enable with -H:+MemoryMaskingAndFencing.
  • (GR-74988) Build position-independent executables (PIE) on Linux by default, increasing security by participating in address space layout randomization (ASLR). To disable PIE (even if the system toolchain would otherwise produce PIE), use -H:NativeLinkerOption=-no-pie. Note that on many Linux distributions, macOS, and Windows, the system toolchains used by Native Image have already been producing PIE.
  • (GR-74988) Turn on relative code pointers by default to reduce startup time, memory usage, and size for PIE and shared library images. Instead of dynamic linker relocations, they use a dedicated code base register to compute code addresses. To disable, use -H:-RelativeCodePointers.

GraalVM 25

  • (GR-52276) (GR-61959) Add support for Arena.ofShared().
  • (GR-58668) Enabled Whole-Program Sparse Conditional Constant Propagation (WP-SCCP) by default, improving the precision of points-to analysis in Native Image. This optimization enhances static analysis accuracy and scalability, potentially reducing the size of the final native binary.
  • (GR-59313) Deprecated class-level metadata extraction using native-image-inspect and removed option DumpMethodsData. Use class-level SBOMs instead by passing --enable-sbom=class-level,export to the native-image builder. The default value of option IncludeMethodData was changed to false.
  • (GR-52400) The build process now uses 85% of system memory in containers and CI environments. Otherwise, it tries to only use available memory. If less than 8GB of memory are available, it falls back to 85% of system memory. The reason for the selected memory limit is now also shown in the build resources section of the build output.
  • (GR-59864) Added JVM version check to the Native Image agent. The agent will abort execution if the JVM major version does not match the version it was built with, and warn if the full JVM version is different.
  • (GR-59135) Verify if hosted options passed to native-image exist prior to starting the builder. Provide suggestions how to fix unknown options early on.
  • (GR-61492) The experimental JDWP option is now present in standard GraalVM builds.
  • (GR-55222) Enabled lazy deoptimization of runtime-compiled code, which reduces memory used for deoptimization. Can be turned off with -H:-LazyDeoptimization.
  • (GR-54953) Add the experimental option -H:Preserve that makes the program work correctly without providing reachability metadata. Correctness is achieved by preserving all classes, resources, and reflection metadata in the image. Usage: -H:Preserve=[all|none|module=<module>|package=<package>|package=<package-wildcard>|path=<cp-entry>][,...].
  • (GR-58659) (GR-58660) Support for FFM API ("Panama") has been added for darwin-aarch64 and linux-aarch64.
  • (GR-49525) Introduced --future-defaults=[all|run-time-initialize-jdk|<options>|none] that enables options that are planned to become defaults in future releases. The enabled options are:
    1. run-time-initialize-jdk shifts away from build-time initialization of the JDK, instead initializing most of it at run time. This transition is gradual, with individual components of the JDK becoming run-time initialized in each release. In this release, it enables run-time-initialize-security-providers and run-time-initialize-file-system-providers. Unless you store classes from the JDK in the image heap, this option should not affect you. In case this option breaks your build, follow the suggestions in the error messages.
    2. complete-reflection-types reflective registration of a type, via metadata files or the Feature API, always includes all type metadata. Now, all registered types behave the same as types defined in 'reachability-metadata.json'.
    3. run-time-initialize-security-providers shifts away from build-time initialization for 'java.security.Provider'. Unless you store 'java.security.Provider'-related classes in the image heap, this option should not affect you. In case this option breaks your build, follow the suggestions in the error messages.
    4. 'run-time-initialize-file-system-providers' shifts away from build-time initialization for 'java.nio.file.spi.FileSystemProvider'. Unless you store 'FileSystemProvider'-related classes in the image heap, this option should not affect you. In case this option breaks your build, follow the suggestions in the error messages.
  • (GR-63494) Recurring callback support is no longer enabled by default. If this feature is needed, please specify -H:+SupportRecurringCallback at image build-time.
  • (GR-60209) New syntax for configuration of the Foreign Function & Memory API
  • (GR-64584) Experimental option -H:+RelativeCodePointers to significantly reduce relocation entries in position-independent executables and shared libraries.
  • (GR-60238) JNI registration is now included as part of the "reflection" section of reachability-metadata.json using the "jniAccessible" attribute. Registrations performed through the "jni" section of reachability-metadata.json and through jni-config.json will still be accepted and parsed correctly.
  • (GR-65008) Remove the sequential reachability handler. The only remaining variant is the concurrent reachability handler, which has been the default implementation since its introduction. Additionally, remove the -H:-RunReachabilityHandlersConcurrently option which was introduced to simplify migration and has been deprecated since Version 24.0.0.
  • (GR-53985) Add experimental option ClassForNameRespectsClassLoader that makes Class.forName(...) respect the class loader hierarchy.
  • (GR-59869) Implemented initial optimization of Java Vector API (JEP 338) operations in native images. See the compiler changelog for more details.
  • (GR-63268) Reflection and JNI queries do not require metadata entries to throw the expected JDK exception when querying a class that doesn't exist under --exact-reachability-metadata if the query cannot possibly be a valid class name
  • (GR-60208) Adds the Tracing Agent support for applications using the Foreign Function & Memory (FFM) API. The agent generates FFM configuration in foreign-config.json. Additionally, support for FFM configurations has been added to the native-image-configure tool.
  • (GR-64787) Enable --install-exit-handlers by default for executables and deprecate the option. If shared libraries were using this flag, the same functionality can be restored by using -H:+InstallExitHandlers.
  • (GR-47881) Remove the total number of loaded types, fields, and methods from the build output, deprecated these metrics in the build output schema, and removed already deprecated build output metrics.
  • (GR-64619) Missing registration errors are now subclasses of LinkageError.
  • (GR-63591) Resource bundle registration is now included as part of the "resources" section of reachability-metadata.json. When this is the case, the bundle name is specified using the "bundle" field.
  • (GR-57827) Security providers can now be initialized at run time (instead of build time) when using the option --future-defaults=all or --future-defaults=run-time-initialized-jdk. Run-time initialization of security providers helps reduce image heap size by avoiding unnecessary objects inclusion.
  • (GR-48191) Enable lambda classes to be registered for reflection and serialization in reachability-metadata.json. The format is detailed here.
  • (GR-54697) Parallelize debug info generation and add support for run-time debug info generation. -H:+RuntimeDebugInfo adds a run-time debug info generator into a native image for use with GDB.
  • (GR-65773) Integrate Foreign Function and Memory (FFM) API metadata into reachability-metadata.json.

GraalVM for JDK 24 (Internal Version 24.2.0)

  • (GR-59717) Added DuringSetupAccess.registerObjectReachabilityHandler to allow registering a callback that is executed when an object of a specified type is marked as reachable during heap scanning.
  • (GR-55708) (Alibaba contribution) Support for running premain methods of Java agents at runtime as an experimental feature. At build time, -H:PremainClasses is used to set the premain classes. At runtime, premain runtime options are set along with main class' arguments in the format of -XXpremain:[class]:[options].
  • (GR-54476): Issue a deprecation warning on first use of a legacy graal. prefix (see GR-49960 in Compiler changelog). The warning is planned to be replaced by an error in GraalVM 25.
  • (GR-48384) Added a GDB Python script (gdb-debughelpers.py) to improve the Native Image debugging experience.
  • (GR-49517) Add support for emitting Windows x64 unwind info. This enables stack walking in native tooling such as debuggers and profilers.
  • (GR-52576) Optimize FFM API upcalls for specifiable static upcall target methods.
  • (GR-56599) Update native image debuginfo from DWARF4 to DWARF5 and store type information for debugging in DWARF type units.
  • (GR-56601) Together with Red Hat, we added experimental support for jcmd on Linux and macOS. Add --enable-monitoring=jcmd to your build arguments to try it out.
  • (GR-57384) Preserve the origin of a resource included in a native image. The information is included in the report produced by -H:+GenerateEmbeddedResourcesFile.
  • (GR-58000) Support for GetStringUTFLengthAsLong added in JNI_VERSION_24 (JDK-8328877)
  • (GR-58383) The length of the printed stack trace when using -XX:MissingRegistrationReportingMode=Warn can now be set with -XX:MissingRegistrationWarnContextLines= and its default length is now 8.
  • (GR-58914) ActiveProcessorCount must be set at isolate or VM creation time.
  • (GR-59326) Ensure builder ForkJoin commonPool parallelism always respects NativeImageOptions.NumberOfThreads.
  • (GR-60081) Native Image now targets armv8.1-a by default on AArch64. Use -march=compatibility for best compatibility or -march=native for best performance if the native executable is deployed on the same machine or on a machine with the same CPU features. To list all available machine types, use -march=list.
  • (GR-60234) Remove "customTargetConstructorClass" field from the serialization JSON metadata. All possible constructors are now registered by default when registering a type for serialization. RuntimeSerialization.registerWithTargetConstructorClass is now deprecated.
  • (GR-60237) Include serialization JSON reachability metadata as part of reflection metadata by introducing the "serializable" flag for reflection entries.

GraalVM for JDK 23 (Internal Version 24.1.0)

  • (GR-51520) The old class initialization strategy, which was deprecated in GraalVM for JDK 22, is removed. The option StrictImageHeap no longer has any effect.
  • (GR-51106) Fields that are accessed via a VarHandle or MethodHandle are no longer marked as "unsafe accessed" when the VarHandle/MethodHandle can be fully intrinsified.
  • (GR-49996) Ensure explicitly set image name (e.g., via -o imagename) is not accidentally overwritten by -jar jarfile option.
  • (GR-48683) Together with Red Hat, we added partial support for the JFR event OldObjectSample.
  • (GR-51851) Together with Red Hat, we added initial support for native memory tracking (--enable-monitoring=nmt).
  • (GR-47109) Together with Red Hat, we added support for JFR event throttling and the event ObjectAllocationSample.
  • (GR-52030) Add a stable name for Proxy types in Native Image. The name $Proxy[id] is replaced by $Proxy.s[hashCode] where hashCode is computed using the names of the Proxy interfaces, the name of the class loader and the name of the module if it is not a dynamic module.
  • (GR-47712) Using the --static option without the --libc=musl option causes the build process to fail (and reports the appropriate error). Static linking is currently only supported with musl.
  • (GR-50434) Introduce a "type" field in reflection and JNI configuration files to support more than simple named types.
  • (GR-51053) Use vswhere to find Visual Studio installations more reliably and in non-standard installation locations.
  • (GR-47832) Experimental support for upcalls from foreign code and other improvements to our implementation of the Foreign Function & Memory API (part of "Project Panama", JEP 454) on AMD64. Must be enabled with -H:+ForeignAPISupport (requiring -H:+UnlockExperimentalVMOptions).
  • (GR-52314) -XX:MissingRegistrationReportingMode can now be used on program invocation instead of as a build option, to avoid a rebuild when debugging missing registration errors.
  • (GR-51086) Introduce a new --static-nolibc API option as a replacement for the experimental -H:±StaticExecutableWithDynamicLibC option.
  • (GR-52732) Introduce a new ReduceImplicitExceptionStackTraceInformation hosted option that reduces image size by reducing the runtime metadata for implicit exceptions, at the cost of stack trace precision. The option is disabled by default, but enabled with optimization level 3 and profile guided optimizations.
  • (GR-52534) Change the digest (used e.g. for symbol names) from SHA-1 encoded as a hex string (40 bytes) to 128-bit Murmur3 as a Base-62 string (22 bytes).
  • (GR-52578) Print information about embedded resources into embedded-resources.json using the -H:+GenerateEmbeddedResourcesFile option.
  • (GR-51172) Add support to catch OutOfMemoryError exceptions on native image if there is no memory left.
  • (GR-53803) In the strict reflection configuration mode (when ThrowMissingRegistrationErrors is enabled), only allow Unsafe.allocateInstance for types registered explicitly in the configuration.
  • (GR-43837) --report-unsupported-elements-at-runtime is now enabled by default and the option is deprecated.
  • (GR-53359) Provide the .debug_gdb_scripts section that triggers auto-loading of svmhelpers.py in GDB. Remove single and double quotes from ClassLoader.nameAndId in the debuginfo.
  • (GR-47365) Include dynamic proxy metadata in the reflection metadata with the syntax "type": { "proxy": [<interface list>] }. This allows members of proxy classes to be accessed reflectively. proxy-config.json is now deprecated but will still be honored.
  • (GR-18214) In-place compacting garbage collection for the Serial GC old generation with -H:+CompactingOldGen.
  • (GR-52844) Add -Os, a new optimization mode to configure the optimizer in a way to get the smallest code size.
  • (GR-49770) Add support for glob patterns in resource-config files in addition to regexp. The Tracing Agent now prints entries in the glob format.
  • (GR-46386) Throw missing registration errors for JNI queries when the query was not included in the reachability metadata.
  • (GR-51479) Implement cgroup support in native code. See the README and the PR description.
  • (GR-54241) Streamline Native Image reachability metadata into a single reachability-metadata.json. The formerly-used individual metadata files (reflection-config.json, resource-config.json, etc.) are now deprecated, but will still be accepted. Native Image will only output reachability-metadata.json files, and those will be readable on the previous LTS versions of GraalVM. See the documentation.

GraalVM for JDK 22 (Internal Version 24.0.0)

  • (GR-48304) Red Hat added support for the JFR event ThreadAllocationStatistics.
  • (GR-48343) Red Hat added support for the JFR events AllocationRequiringGC and SystemGC.
  • (GR-48612) Enable --strict-image-heap by default. The option is now deprecated and can be removed from your argument list. A blog post with more information will follow shortly.
  • (GR-48354) Remove native-image-agent legacy build-option
  • (GR-49221) Support for thread dumps can now be enabled with --enable-monitoring=threaddump. The option -H:±DumpThreadStacksOnSignal is deprecated and marked for removal.
  • (GR-48579) Options ParseOnce, ParseOnceJIT, and InlineBeforeAnalysis are deprecated and no longer have any effect.
  • (GR-39407) Add support for the NATIVE_IMAGE_OPTIONS environment variable, which allows users and tools to pass additional arguments via the environment. Similar to JAVA_TOOL_OPTIONS, the value of the environment variable is prepended to the options supplied to native-image.
  • (GR-20827): Introduce a dedicated caller-saved branch target register for software CFI implementations.
  • (GR-47937) Make the lambda-class name format in Native-Image consistent with the JDK name format.
  • (GR-45651) Methods, fields and constructors of Object, primitive classes and array classes are now registered by default for reflection.
  • (GR-45651) The Native Image agent now tracks calls to ClassLoader.findSystemClass, ObjectInputStream.resolveClass and Bundles.of, and registers resource bundles as bundle name-locale pairs.
  • (GR-49807) Before this change the function System#setSecurityManager was always halting program execution with a VM error. This was inconvenient as the VM error prints an uncomprehensible error message and prevents further continuation of the program. For cases where the program is expected to throw an exception when System#setSecurityManager is called, execution on Native Image was not possible. Now, System#setSecurityManager throws an java.lang.UnsupportedOperationException by default. If the property java.security.manager is set to anything but disallow at program startup this function will throw a java.lang.SecurityException according to the Java spec.
  • (GR-30433) Disallow the deprecated environment variable USE_NATIVE_IMAGE_JAVA_PLATFORM_MODULE_SYSTEM=false.
  • (GR-49655) Experimental support for parts of the Foreign Function & Memory API (part of "Project Panama", JEP 454) on AMD64. Must be enabled with -H:+ForeignAPISupport (requiring -H:+UnlockExperimentalVMOptions).
  • (GR-46407) Correctly rethrow build-time linkage errors at run-time for registered reflection queries.
  • (GR-51002) Improve intrinsification of method handles. This especially improves the performance of equals and hashCode methods for records, which use method handles that are now intrinsified.
  • (GR-50529) Native Image now throws a specific error when trying to access unregistered resource bundles instead of failing on a subsequent reflection or resource query.

GraalVM for JDK 21 (Internal Version 23.1.0)

  • (GR-35746) Lower the default aligned chunk size from 1 MB to 512 KB for the serial and epsilon GCs, reducing memory usage and image size in many cases.
  • (GR-45841) BellSoft added support for the JFR event ThreadCPULoad.
  • (GR-45994) Removed the option -H:EnableSignalAPI. Please use the runtime option EnableSignalHandling if it is necessary to enable or disable signal handling explicitly.
  • (GR-39406) Simulation of class initializer: Class initializer of classes that are not marked for initialization at image build time are simulated at image build time to avoid executing them at image run time.
  • (GR-39406) New option --strict-image-heap: All classes can now be used at image build time, even when they are not explicitly configured as --initialize-at-build-time. Note, however, that still only classes configured as --initialize-at-build-time are allowed in the image heap. Adopt this option as it will become the default in the next release of GraalVM.
  • (GR-46392) Add --parallelism option to control how many threads are used by the build process.
  • (GR-46392) Add build resources section to the build output that shows the memory and thread limits of the build process.
  • (GR-38994) Together with Red Hat, we added support for -XX:+HeapDumpOnOutOfMemoryError.
  • (GR-47365) Throw MissingReflectionRegistrationError when attempting to create a proxy class without having it registered at build-time, instead of a VMError.
  • (GR-46064) Add option -H:±IndirectBranchTargetMarker to mark indirect branch targets on AMD64 with an endbranch instruction. This is a prerequisite for future Intel CET support.
  • (GR-46740) Preview of Foreign Function & Memory API downcalls (part of "Project Panama", JEP 442) on AMD64. Must be enabled with --enable-preview.
  • (GR-27034) Add -H:ImageBuildID option to generate Image Build ID, which is a 128-bit UUID string generated randomly, once per bundle or digest of input args when bundles are not used.
  • (GR-47647) Add -H:±UnlockExperimentalVMOptions for unlocking access to experimental options similar to HotSpot's -XX:UnlockExperimentalVMOptions. Explicit unlocking will be required in a future release, which can be tested with the env setting NATIVE_IMAGE_EXPERIMENTAL_OPTIONS_ARE_FATAL=true. For more details, see issue #7105.
  • (GR-47647) Add --color[=WHEN] option to color the output WHEN ('always', 'never', or 'auto'). This API option supersedes the experimental option -H:+BuildOutputColorful.
  • (GR-43920) Add support for executing native image bundles as jar files with extra options --with-native-image-agent and --container.
  • (GR-43920) Add ,container[=<container-tool>], ,dockerfile=<dockerfile> and ,dry-run options to --bundle-createand --bundle-apply.
  • (GR-46420) Switch to directly using cgroup support from the JDK.
  • (GR-29688) More sophisticated intrinsification and inlining of method handle usages, both explicit and implicit (lambdas, string concatenation and record classes), and various fixes for non-intrinsified usages.

GraalVM for JDK 17 and GraalVM for JDK 20 (Internal Version 23.0.0)

  • (GR-40187) Report invalid use of SVM specific classes on image class- or module-path as error. As a temporary workaround, -H:+AllowDeprecatedBuilderClassesOnImageClasspath allows turning the error into a warning.
  • (GR-41196) Provide .debug.svm.imagebuild.* sections that contain build options and properties used in the build of the image.
  • (GR-41978) Disallow --initialize-at-build-time without arguments. As a temporary workaround, -H:+AllowDeprecatedInitializeAllClassesAtBuildTime allows turning this error into a warning.
  • (GR-41674) Class instanceOf and isAssignableFrom checks do need to make the checked type reachable.
  • (GR-41100) Add support for -XX:HeapDumpPath to control where heap dumps are created.
  • (GR-42148) Adjust build output to report types (primitives, classes, interfaces, and arrays) instead of classes and revise the output schema of -H:BuildOutputJSONFile.
  • (GR-42375) Add -H:±GenerateBuildArtifactsFile option, which generates a build-artifacts.json file with a list of all artifacts produced by Native Image. .build_artifacts.txt files are now deprecated, disabled (can be re-enabled with env setting NATIVE_IMAGE_DEPRECATED_BUILD_ARTIFACTS_TXT=true), and will be removed in a future release.
  • (GR-34179) Red Hat improved debugging support on Windows: Debug information now includes information about Java types.
  • (GR-41096) Support services loaded through the java.util.ServiceLoader.ModuleServicesLookupIterator. An example of such service is the com.sun.jndi.rmi.registry.RegistryContextFactory.
  • (GR-41912) The builder now generated reports for internal errors, which users can share when creating issues. By default, error reports follow the svm_err_b_<timestamp>_pid<pid>.md pattern and are created in the working directory. Use -H:ErrorFile to adjust the path or filename.
  • (GR-36951) Add RISC-V support for Native Image through the LLVM backend.
  • (GR-42964) Deprecate --enable-monitoring without an argument. The option will no longer default to all in a future release. Instead, please always explicitly specify the list of monitoring features to be enabled (for example, --enable-monitoring=heapdump,jfr,jvmstat").
  • (GR-19890) Native Image now sets up build environments for Windows users automatically. Running in an x64 Native Tools Command Prompt is no longer a requirement.
  • (GR-43410) Added support for the JFR event ExecutionSample.
  • (GR-44058) (GR-44087) Red Hat added support for the JFR events ObjectAllocationInNewTLAB and JavaMonitorInflate.
  • (GR-42467) The search path for System.loadLibrary() by default includes the directory containing the native image.
  • (GR-44216) Native Image is now shipped as part of the GraalVM JDK and thus no longer needs to be installed via gu install native-image.
  • (GR-44105) A warning is displayed when trying to generate debug info on macOS since that is not supported. It is now an error to use -H:+StripDebugInfo on macOS or -H:-StripDebugInfo on Windows since those values are not supported.
  • (GR-43966) Remove analysis options -H:AnalysisStatisticsFile and -H:ImageBuildStatisticsFile. Output files are now written to fixed subdirectories relative to image location (reports/image_build_statistics.json).
  • (GR-38414) BellSoft implemented the MemoryPoolMXBean for the serial and epsilon GCs.
  • (GR-40641) Dynamic linking of AWT libraries on Linux.
  • (GR-40463) Red Hat added experimental support for JMX, which can be enabled with the --enable-monitoring option (e.g. --enable-monitoring=jmxclient,jmxserver).
  • (GR-42740) Together with Red Hat, we added experimental support for JFR event streaming.
  • (GR-44110) Native Image now targets x86-64-v3 by default on AMD64 and supports a new -march option. Use -march=compatibility for best compatibility (previous default) or -march=native for best performance if the native executable is deployed on the same machine or on a machine with the same CPU features. To list all available machine types, use -march=list.
  • (GR-43971) Add native-image option -E<env-var-key>[=<env-var-value>] and support environment variable capturing in bundles. Previously almost all environment variables were available in the builder. To temporarily revert back to the old behaviour, env setting NATIVE_IMAGE_DEPRECATED_BUILDER_SANITATION=true can be used. The old behaviour will be removed in a future release.
  • (GR-43382) The build output now includes a section with recommendations that help you get the best out of Native Image.
  • (GR-44722) The output of native-image --version and various Java properties (e.g. java.vm.version) have been aligned with the OpenJDK. To distinguish between GraalVM CE, Oracle GraalVM, and GraalVM distributions from other vendors, please refer to java.vm.vendor or java.vendor.version.
  • (GR-45673) Improve the memory footprint of the Native Image build process. The builder now takes available memory into account to reduce memory pressure when many other processes are running on the same machine. It also consumes less memory in many cases and is therefore also less likely to fail due to out-of-memory errors. At the same time, we have raised its memory limit from 14GB to 32GB.

Version 22.3.0

  • (GR-35721) Remove old build output style and the -H:±BuildOutputUseNewStyle option.
  • (GR-39390) (GR-39649) (GR-40033) Red Hat added support for the JFR events JavaMonitorEnter, JavaMonitorWait, and ThreadSleep.
  • (GR-39497) Add -H:BuildOutputJSONFile=<file.json> option for JSON build output. Please feel free to provide feedback so that we can stabilize the schema/API.
  • (GR-40170) Add --silent option to silence the build output.
  • (GR-39475) Add initial support for jvmstat.
  • (GR-39563) Add support for JDK 19 and Project Loom Virtual Threads (JEP 425) for high-throughput lightweight concurrency. Enable on JDK 19 with native-image --enable-preview.
  • (GR-40264) Add --enable-monitoring=<all,heapdump,jfr,jvmstat> option to enable fine-grained control over monitoring features enabled in native executables. -H:±AllowVMInspection is now deprecated and will be removed in a future release.
  • (GR-15630) Allow multiple classes with the same name from different class loaders.
  • (GR-40198) Introduce public API for programmatic JNI / Resource / Proxy / Serialization registration from Feature classes during the image build.
  • (GR-38909) Moved strictly-internal annotation classes (e.g. @AlwaysInline, @NeverInline, @Uninterruptible, ...) out of com.oracle.svm.core.annotate. Moved remaining annotation classes to org.graalvm.sdk module.
  • (GR-40906) Add RuntimeResourceAccess#addResource(Module module, String resourcePath, byte[] resource) API method that allows injecting resources into images

Version 22.2.0

  • (GR-20653) Re-enable the usage of all CPU features for JIT compilation on AMD64.
  • (GR-38413) Add support for -XX:+ExitOnOutOfMemoryError.
  • (GR-37606) Add support for URLs and short descriptions to Feature. This info is shown as part of the build output.
  • (GR-38965) Heap dumps are now supported in Community Edition.
  • (GR-38951) Add -XX:+DumpHeapAndExit option to dump the initial heap of a native executable.
  • (GR-37582) Run image-builder on module-path per default. Opt-out with env setting USE_NATIVE_IMAGE_JAVA_PLATFORM_MODULE_SYSTEM=false.
  • (GR-38660) Expose -H:Name= as API option -o
  • (GR-39043) Make certain native-image options command-line only and ensure they get processed before other options (--exclude-config --configurations-path --version --help --help-extra --dry-run --debug-attach --expert-options --expert-options-all --expert-options-detail --verbose-server --server-*)

Version 22.1.0

  • (GR-36568) Add "Quick build" mode, enabled through option -Ob, for quicker native image builds.
  • (GR-35898) Improved handling of static synchronized methods: the lock is no longer stored in the secondary monitor map, but in the mutable DynamicHubCompanion object.
  • Remove support for JDK8. As a result, JDK8OrEarlier and JDK11OrLater have been deprecated and will be removed in a future release.
  • (GR-26814) (GR-37018) (GR-37038) (GR-37311) Red Hat added support for the following JFR events: SafepointBegin, SafepointEnd, GarbageCollection, GCPhasePause, GCPhasePauseLevel*, and ExecuteVMOperation. All GC-related JFR events are currently limited to the serial GC.
  • (GR-35721) Deprecate -H:±BuildOutputUseNewStyle option. The old build output style will be removed in a future release.
  • (GR-36905) Allow incomplete classes at build-time is now default. Add --link-at-build-time option and @ support for native-image.properties. Add --link-at-build-time-paths option.

Version 22.0.0

  • (GR-33930) Decouple HostedOptionParser setup from classpath/modulepath scanning (use ServiceLoader for collecting options).
  • (GR-33504) Implement --add-reads for native-image and fix --add-opens error handling.
  • (GR-33983) Remove obsolete com.oracle.svm.thirdparty.jline.JLineFeature from substratevm:LIBRARY_SUPPORT.
  • (GR-34577) Remove support for outdated JDK versions between 11 and 17. Since JDK versions 12, 13, 14, 15, 16 are no longer supported, there is no need to explicitly check for and allow these versions.
  • (GR-29957) Removed the option -H:SubstitutionFiles= to register substitutions via a JSON file. This was an early experiment and is no longer necessary.
  • (GR-32403) Use more compressed encoding for stack frame metadata.
  • (GR-35152) Add -H:DisableURLProtocols to allow specifying URL protocols that must never be included in the image.
  • (GR-35085) Custom prologue/epilogue/handleException customizations of @CEntryPoint must be annotated with @Uninterruptible. The synthetic methods created for entry points are now implicitly annotated with @Uninterruptible too.
  • (GR-34935) More compiler optimization phases are run before static analysis: Conditional Elimination (to remove redundant conditions) and Escape Analysis.
  • (GR-33602) Enable new user-friendly build output mode. The old output can be restored with -H:-BuildOutputUseNewStyle.