build: Add instructions for Java modules

Author: aalmiray

README.adoc

@@ -3,6 +3,7 @@
 This repository shows how to configure link:https://github.com/features/actions[GitHub Actions] and link:https://jreleaser.org/[JReleaser] to:
 
  * compile a helloworld app with bundled Java Runtimes using jlink for:
+  ** `linux_musl-x86_64`
   ** `linux-x86_64`
   ** `linux-aarch_64`
   ** `osx-x86_64`
@@ -11,3 +12,19 @@ This repository shows how to configure link:https://github.com/features/actions[
   ** `windows-aarch_64`
  * assemble zip distributions with JReleaser
  * create rolling early-access releases with JReleaser on every push to `main` branch
+
+There are two modes for packaging this application: classpath & modulepath.
+
+*classpath*
+
+ 1. `./mvnw verify`
+ 2. `./mvnw -Pjdks`
+ 3. `jreleaser assemble`
+
+*modulepath*
+
+ 1. `./mvnw verify`
+ 2. `./mvnw -Pjdks`
+ 3. `jreleaser assemble --config-file jreleaser-modules.yml`
+
+In both cases the assembled archive is placed at `out/jreleaser/assemble/helloworld/jlink`.

jreleaser-modules.yml

@@ -0,0 +1,54 @@
+environment:
+  properties:
+    jdkPathPrefix: 'target/jdks'
+    jdkFilePrefix: 'zulu17.32.13-ca-jdk17.0.2'
+
+project:
+  name: helloworld
+  description: HelloWorld in Java
+  longDescription: HelloWorld in Java
+  links:
+    homepage: https://github.com/jreleaser/helloworld-java-jlink
+  authors:
+    - Andres Almiray
+  license: APACHE-2.0
+  inceptionYear: 2023
+  stereotype: cli
+  java:
+    version: 11
+    groupId: org.jreleaser.examples
+    artifactId: helloworld
+    mainClass: org.jreleaser.examples.HelloWorld
+    mainModule: org.jreleaser.examples
+
+release:
+  github:
+    overwrite: true
+    changelog:
+      formatted: ALWAYS
+      preset: conventional-commits
+      contributors:
+        format: '- {{contributorName}}{{#contributorUsernameAsLink}} ({{.}}){{/contributorUsernameAsLink}}'
+
+assemble:
+  jlink:
+    helloworld:
+      active: ALWAYS
+      imageName: '{{distributionName}}-{{projectVersion}}'
+      targetJdks:
+        - path: '{{jdkPathPrefix}}/zulu17OsxIntel/{{jdkFilePrefix}}-macosx_x64/zulu-17.jdk/Contents/Home'
+          platform: 'osx-x86_64'
+        - path: '{{jdkPathPrefix}}/zulu17OsxArm/{{jdkFilePrefix}}-macosx_aarch64/zulu-17.jdk/Contents/Home'
+          platform: 'osx-aarch_64'
+        - path: '{{jdkPathPrefix}}/zulu17LinuxIntel/{{jdkFilePrefix}}-linux_x64'
+          platform: 'linux-x86_64'
+        - path: '{{jdkPathPrefix}}/zulu17LinuxMuslIntel/{{jdkFilePrefix}}-linux_musl_x64'
+          platform: 'linux_musl-x86_64'
+        - path: '{{jdkPathPrefix}}/zulu17LinuxArm/{{jdkFilePrefix}}-linux_aarch64'
+          platform: 'linux-aarch_64'
+        - path: '{{jdkPathPrefix}}/zulu17WindowsIntel/{{jdkFilePrefix}}-win_x64'
+          platform: 'windows-x86_64'
+        - path: '{{jdkPathPrefix}}/zulu17WindowsArm/{{jdkFilePrefix}}-win_aarch64'
+          platform: 'windows-aarch_64'
+      mainJar:
+        path: 'target/{{distributionName}}-{{projectVersion}}.jar'

jreleaser.yml

@@ -15,10 +15,10 @@ project:
   inceptionYear: 2023
   stereotype: cli
   java:
+    version: 11
     groupId: org.jreleaser.examples
     artifactId: helloworld
     mainClass: org.jreleaser.examples.HelloWorld
-    version: 11
 
 release:
   github:
@@ -41,6 +41,8 @@ assemble:
           platform: 'osx-aarch_64'
         - path: '{{jdkPathPrefix}}/zulu17LinuxIntel/{{jdkFilePrefix}}-linux_x64'
           platform: 'linux-x86_64'
+        - path: '{{jdkPathPrefix}}/zulu17LinuxMuslIntel/{{jdkFilePrefix}}-linux_musl_x64'
+          platform: 'linux_musl-x86_64'
         - path: '{{jdkPathPrefix}}/zulu17LinuxArm/{{jdkFilePrefix}}-linux_aarch64'
           platform: 'linux-aarch_64'
         - path: '{{jdkPathPrefix}}/zulu17WindowsIntel/{{jdkFilePrefix}}-win_x64'
@@ -49,4 +51,3 @@ assemble:
           platform: 'windows-aarch_64'
       mainJar:
         path: 'target/{{distributionName}}-{{projectVersion}}.jar'
-

pom.xml

@@ -67,7 +67,7 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-compiler-plugin</artifactId>
-        <version>3.10.1</version>
+        <version>3.11.0</version>
       </plugin>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
@@ -92,9 +92,16 @@
           <plugin>
             <groupId>org.jreleaser</groupId>
             <artifactId>jdks-maven-plugin</artifactId>
-            <version>1.4.0</version>
+            <version>1.5.1</version>
             <configuration>
               <pkgs>
+                <pkg>
+                  <name>zulu17LinuxMuslIntel</name>
+                  <platform>linux-x86_64</platform>
+                  <version>${jdk.version}</version>
+                  <libcType>musl</libcType>
+                  <archiveType>tar.gz</archiveType>
+                </pkg>
                 <pkg>
                   <name>zulu17LinuxIntel</name>
                   <platform>linux-x86_64</platform>

src/main/java/module-info.java

@@ -0,0 +1,3 @@
+module org.jreleaser.examples {
+    exports org.jreleaser.examples;
+}