Use new Native Image Maven plugin properties to configure the build process.

Author: nirvdrum

README.md

@@ -125,7 +125,7 @@ in Rosetta.
 ## Building the Native Image Playground
 
 The project's Maven configuration is split into multiple profiles, allowing you to pick the type of image you would
-like. The list of profiles are:
+like. The list of profiles is:
 
     * native-image: A standalone executable written in Java
     * native-library: A shared library written in Java
@@ -136,12 +136,24 @@ like. The list of profiles are:
     * benchmark-setup: Fetches and builds the Google Benchmark library for running benchmarks
     * benchmark: Runs benchmarks comparing `@CEntryPoint` and JNI Invocation API calls
 
+Additionally, the project uses some configuration values that allow you to customize the Native Image invocation. They
+can be configured at invocation time via the `-D` flag to the `mvn` command. The list of properties is:
+
+    * native.image.debug: Build a native image with debug symbols (Boolean; default: false)
+    * native.image.verbose: Build a native image verbosely (Boolean; default: false)
+
 To build any of these profiles, you run:
 
 ```
 $ mvn -P <profile_name> -D skipTests=true clean package
 ```
 
+To build a profile with verbose logging from Native Image, you run:
+
+```
+$ mvn -P <profile_name> -D skipTests=true -D native.image.verbose=true clean package
+```
+
 Maven stores the compiled artifacts in the `target/` directory. The `clean` option in the build command will delete
 the `target/` directory before building the new package with _native-image_. This will avoid any leftover artifacts
 from other profiles conflicting with your latest build. But, if you need to keep the old `target/` around for some

pom.xml

@@ -18,6 +18,8 @@
         <native.maven.plugin.version>0.9.20</native.maven.plugin.version>
         <graalvm.version>22.3.1</graalvm.version>
         <sis.version>1.0</sis.version>
+        <native.image.debug>false</native.image.debug>
+        <native.image.verbose>false</native.image.verbose>
     </properties>
 
     <dependencies>
@@ -117,6 +119,8 @@
                         </executions>
                         <configuration>
                             <mainClass>com.nirvdrum.truffleruby.NativeImage</mainClass>
+                            <debug>${native.image.debug}</debug>
+                            <verbose>${native.image.verbose}</verbose>
                             <imageName>native-image-playground</imageName>
                         </configuration>
                     </plugin>
@@ -156,7 +160,9 @@
                         <configuration>
                             <mainClass>com.nirvdrum.truffleruby.NativeLibrary</mainClass>
                             <imageName>lib${launcher.name}</imageName>
+                            <debug>${native.image.debug}</debug>
                             <sharedLibrary>true</sharedLibrary>
+                            <verbose>${native.image.verbose}</verbose>
                             <buildArgs>-H:+ParseRuntimeOptions</buildArgs>
                         </configuration>
                     </plugin>
@@ -223,7 +229,9 @@
                         <configuration>
                             <mainClass>com.nirvdrum.truffleruby.NativeLibraryRuby</mainClass>
                             <imageName>lib${launcher.name}</imageName>
+                            <debug>${native.image.debug}</debug>
                             <sharedLibrary>true</sharedLibrary>
+                            <verbose>${native.image.verbose}</verbose>
                             <buildArgs>--language:ruby</buildArgs>
                         </configuration>
                     </plugin>
@@ -378,7 +386,9 @@
                         <configuration>
                             <mainClass>com.nirvdrum.truffleruby.NativeLibraryRuby</mainClass>
                             <imageName>lib${launcher.name}</imageName>
+                            <debug>${native.image.debug}</debug>
                             <sharedLibrary>true</sharedLibrary>
+                            <verbose>${native.image.verbose}</verbose>
                             <buildArgs>--language:js --language:ruby -H:JNIConfigurationFiles=${project.build.sourceDirectory}/../resources/native-jni-config.json</buildArgs>
                         </configuration>
                     </plugin>
@@ -485,7 +495,9 @@
                         <configuration>
                             <mainClass>com.nirvdrum.truffleruby.NativeLibraryRuby</mainClass>
                             <imageName>lib${launcher.name}</imageName>
+                            <debug>${native.image.debug}</debug>
                             <sharedLibrary>true</sharedLibrary>
+                            <verbose>${native.image.verbose}</verbose>
                             <buildArgs>--language:js --language:ruby -H:JNIConfigurationFiles=${project.build.sourceDirectory}/../resources/native-jni-config.json</buildArgs>
                         </configuration>
                     </plugin>