使用 Java 11 构建 HMCL (#4078)

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

HMCLBoot/build.gradle.kts

@@ -0,0 +1,7 @@
+plugins {
+    id("java-library")
+}
+
+tasks.withType<JavaCompile> {
+    options.release.set(8)
+}

HMCLBoot/src/main/java/org/jackhuang/hmcl/BootProperties.java

@@ -0,0 +1,38 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl;
+
+import org.jackhuang.hmcl.util.UTF8Control;
+
+import java.util.ResourceBundle;
+
+final class BootProperties {
+
+    private static ResourceBundle resourceBundle;
+
+    static ResourceBundle getResourceBundle() {
+        if (resourceBundle == null) {
+            resourceBundle = ResourceBundle.getBundle("assets.lang.boot", new UTF8Control());
+        }
+
+        return resourceBundle;
+    }
+
+    private BootProperties() {
+    }
+}

HMCLBoot/src/main/java/org/jackhuang/hmcl/EntryPoint.java

@@ -0,0 +1,30 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl;
+
+/**
+ * This is a dummy class and will be overwritten in the shadow jar.
+ */
+public final class EntryPoint {
+    private EntryPoint() {
+    }
+
+    public static void main(String[] args) {
+        throw new AssertionError("This method should not be called, please verify that the HMCL is complete.");
+    }
+}

HMCLBoot/src/main/java/org/jackhuang/hmcl/Main.java

@@ -0,0 +1,73 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl;
+
+import org.jackhuang.hmcl.util.SwingUtils;
+
+/**
+ * @author Glavo
+ */
+public final class Main {
+    private static final int MINIMUM_JAVA_VERSION = 11;
+
+    private Main() {
+    }
+
+    /**
+     * Check if the current Java version is compatible with HMCL.
+     */
+    static boolean checkJavaVersion(String javaVersion) {
+        if (javaVersion == null) {
+            return false;
+        }
+
+        try {
+            int major;
+            int dot = javaVersion.indexOf('.');
+
+            if (dot >= 0) {
+                major = Integer.parseInt(javaVersion.substring(0, dot));
+                if (major == 1 && dot < javaVersion.length() - 1) {
+                    int begin = dot + 1;
+                    dot = javaVersion.indexOf('.', begin);
+
+                    major = dot > begin
+                            ? Integer.parseInt(javaVersion.substring(begin, dot))
+                            : Integer.parseInt(javaVersion.substring(begin));
+                }
+            } else {
+                major = Integer.parseInt(javaVersion);
+            }
+
+            return major >= MINIMUM_JAVA_VERSION;
+        } catch (NumberFormatException e) {
+            return false;
+        }
+    }
+
+    public static void main(String[] args) throws Throwable {
+        if (checkJavaVersion(System.getProperty("java.version"))) {
+            EntryPoint.main(args);
+        } else {
+            String errorMessage = BootProperties.getResourceBundle().getString("boot.unsupported_java_version");
+            System.err.println(errorMessage);
+            SwingUtils.showErrorDialog(errorMessage);
+            System.exit(1);
+        }
+    }
+}

HMCLBoot/src/main/java/org/jackhuang/hmcl/util/SwingUtils.java

@@ -0,0 +1,53 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl.util;
+
+import javax.swing.*;
+
+/**
+ * @author Glavo
+ */
+public final class SwingUtils {
+    static {
+        if (System.getProperty("swing.defaultlaf") == null) {
+            try {
+                UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
+            } catch (Throwable ignored) {
+            }
+        }
+    }
+
+    private SwingUtils() {
+    }
+
+    public static void initLookAndFeel() {
+        // Make sure the static constructor is called
+    }
+
+    public static void showInfoDialog(Object message) {
+        JOptionPane.showMessageDialog(null, message, "Info", JOptionPane.INFORMATION_MESSAGE);
+    }
+
+    public static void showWarningDialog(Object message) {
+        JOptionPane.showMessageDialog(null, message, "Warning", JOptionPane.WARNING_MESSAGE);
+    }
+
+    public static void showErrorDialog(Object message) {
+        JOptionPane.showMessageDialog(null, message, "Error", JOptionPane.ERROR_MESSAGE);
+    }
+}

HMCLBoot/src/main/java/org/jackhuang/hmcl/util/UTF8Control.java

@@ -0,0 +1,64 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl.util;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.net.URL;
+import java.net.URLConnection;
+import java.util.Locale;
+import java.util.PropertyResourceBundle;
+import java.util.ResourceBundle;
+
+import static java.nio.charset.StandardCharsets.UTF_8;
+
+public final class UTF8Control extends ResourceBundle.Control {
+
+    public UTF8Control() {}
+
+    @Override
+    public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload) throws IOException {
+        // The below is a copy of the default implementation.
+        String bundleName = toBundleName(baseName, locale);
+        String resourceName = toResourceName(bundleName, "properties");
+        ResourceBundle bundle = null;
+        InputStream stream = null;
+        if (reload) {
+            URL url = loader.getResource(resourceName);
+            if (url != null) {
+                URLConnection connection = url.openConnection();
+                if (connection != null) {
+                    connection.setUseCaches(false);
+                    stream = connection.getInputStream();
+                }
+            }
+        } else {
+            stream = loader.getResourceAsStream(resourceName);
+        }
+        if (stream != null) {
+            try {
+                // Only this line is changed to make it to read properties files as UTF-8.
+                bundle = new PropertyResourceBundle(new InputStreamReader(stream, UTF_8));
+            } finally {
+                stream.close();
+            }
+        }
+        return bundle;
+    }
+}

HMCLBoot/src/main/resources/assets/lang/boot.properties

@@ -0,0 +1,19 @@
+#
+# Hello Minecraft! Launcher
+# Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+boot.unsupported_java_version=HMCL requires Java 11 or later to run, but still supports launching games with Java 8. Please install the latest version of Java and try opening HMCL again.\nYou can keep your old version of Java. HMCL can detect and manage multiple Java installations, and will automatically select the appropriate Java version for your game.

HMCLBoot/src/main/resources/assets/lang/boot_zh.properties

@@ -0,0 +1,19 @@
+#
+# Hello Minecraft! Launcher
+# Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+boot.unsupported_java_version=HMCL 需要 Java 11 或更高版本才能執行，但依然支援使用 Java 8 啟動遊戲。請安裝最新版本的 Java 再嘗試開啟 HMCL。\n你可以繼續保留舊版本 Java。HMCL 能夠識別與管理多個 Java，並會自動根據遊戲版本為你選取合適的 Java。

HMCLBoot/src/main/resources/assets/lang/boot_zh_CN.properties

@@ -0,0 +1,19 @@
+#
+# Hello Minecraft! Launcher
+# Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+boot.unsupported_java_version=HMCL 需要 Java 11 或更高版本才能运行，但依然支持使用 Java 8 启动游戏。请安装最新版本的 Java 再尝试启动 HMCL。\n你可以继续保留旧版本 Java。HMCL 能够识别与管理多个 Java，并会自动根据游戏版本为你选择合适的 Java。\n你可以访问 https://docs.hmcl.net/help.html 页面寻求帮助。

HMCLBoot/src/test/java/org/jackhuang/hmcl/MainTest.java

@@ -0,0 +1,39 @@
+/*
+ * Hello Minecraft! Launcher
+ * Copyright (C) 2025 huangyuhui <huanghongxun2008@126.com> and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.jackhuang.hmcl;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public final class MainTest {
+    @Test
+    public void testCheckJavaVersion() {
+        assertFalse(Main.checkJavaVersion("1.6.0"));
+        assertFalse(Main.checkJavaVersion("1.6.0_45"));
+        assertFalse(Main.checkJavaVersion("1.7.0"));
+        assertFalse(Main.checkJavaVersion("1.7.0_80"));
+        assertFalse(Main.checkJavaVersion("1.8"));
+        assertFalse(Main.checkJavaVersion("1.8.0_321"));
+
+        assertTrue(Main.checkJavaVersion("11"));
+        assertTrue(Main.checkJavaVersion("11.0.26"));
+        assertTrue(Main.checkJavaVersion("21"));
+    }
+}