Make JAR packaging portable across desktop systems

2026-08-03 15:10:41 +08:00
parent 0384efae28
commit 777a5f0c52
3 changed files with 165 additions and 43 deletions
@@ -0,0 +1,109 @@
+package com.example.workutils.system.support;
+
+import org.junit.jupiter.api.Test;
+import org.w3c.dom.Document;
+import org.w3c.dom.Element;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+import javax.xml.parsers.DocumentBuilderFactory;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+class BuildPortabilityTest {
+
+    private final Path projectRoot = Path.of("").toAbsolutePath().normalize();
+
+    @Test
+    void compilerUsesTheMavenJdkWithoutAnExternalExecutable() throws Exception {
+        Document pom = parsePom();
+        Element compiler = pluginUnder(directChild(element(pom, "project"), "build"),
+                "maven-compiler-plugin");
+
+        assertEquals("17", childText(directChild(compiler, "configuration"), "release"));
+        assertFalse(hasDirectChild(directChild(compiler, "configuration"), "executable"));
+        assertFalse(hasDirectChild(directChild(compiler, "configuration"), "fork"));
+    }
+
+    @Test
+    void launch4jOnlyBelongsToTheWindowsProfile() throws Exception {
+        Document pom = parsePom();
+        Element project = element(pom, "project");
+        assertFalse(hasPlugin(directChild(project, "build"), "launch4j-maven-plugin"));
+
+        Element windowsProfile = profile(project, "windows-package");
+        assertEquals("Windows", childText(directChild(directChild(windowsProfile, "activation"), "os"), "family"));
+        assertTrue(hasPlugin(directChild(windowsProfile, "build"), "launch4j-maven-plugin"));
+    }
+
+    @Test
+    void portableShellLauncherIsShippedByTheDefaultBuild() throws Exception {
+        assertTrue(Files.isRegularFile(projectRoot.resolve(Path.of("scripts", "start.sh"))));
+        Document pom = parsePom();
+        Element resourcesPlugin = pluginUnder(
+                directChild(element(parsePom(), "project"), "build"), "maven-resources-plugin");
+        assertTrue(resourcesPlugin.getTextContent().contains("start.sh"));
+        assertFalse(resourcesPlugin.getTextContent().contains("start.bat"));
+    }
+
+    private Document parsePom() throws Exception {
+        DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
+        factory.setNamespaceAware(false);
+        return factory.newDocumentBuilder().parse(projectRoot.resolve("pom.xml").toFile());
+    }
+
+    private static Element element(Document document, String name) {
+        return (Element) document.getElementsByTagName(name).item(0);
+    }
+
+    private static Element directChild(Element parent, String name) {
+        for (Node node = parent.getFirstChild(); node != null; node = node.getNextSibling()) {
+            if (node instanceof Element child && name.equals(child.getTagName())) return child;
+        }
+        throw new AssertionError("Missing element " + name + " under " + parent.getTagName());
+    }
+
+    private static boolean hasDirectChild(Element parent, String name) {
+        for (Node node = parent.getFirstChild(); node != null; node = node.getNextSibling()) {
+            if (node instanceof Element child && name.equals(child.getTagName())) return true;
+        }
+        return false;
+    }
+
+    private static String childText(Element parent, String name) {
+        return directChild(parent, name).getTextContent().trim();
+    }
+
+    private static Element pluginUnder(Element build, String artifactId) {
+        Element plugins = directChild(build, "plugins");
+        NodeList nodes = plugins.getElementsByTagName("plugin");
+        for (int i = 0; i < nodes.getLength(); i++) {
+            Element plugin = (Element) nodes.item(i);
+            if (artifactId.equals(childText(plugin, "artifactId"))) return plugin;
+        }
+        throw new AssertionError("Missing plugin " + artifactId);
+    }
+
+    private static boolean hasPlugin(Element build, String artifactId) {
+        try {
+            pluginUnder(build, artifactId);
+            return true;
+        } catch (AssertionError ignored) {
+            return false;
+        }
+    }
+
+    private static Element profile(Element project, String id) {
+        Element profiles = directChild(project, "profiles");
+        NodeList nodes = profiles.getElementsByTagName("profile");
+        for (int i = 0; i < nodes.getLength(); i++) {
+            Element profile = (Element) nodes.item(i);
+            if (id.equals(childText(profile, "id"))) return profile;
+        }
+        throw new AssertionError("Missing profile " + id);
+    }
+}