Logisim Evolution项目在Windows下使用Temurin JDK 24构建MSI包的问题分析

问题背景

在Logisim Evolution项目的构建过程中，当使用Eclipse Temurin JDK 24在Windows 11 Pro系统上执行createMsi任务时，构建过程会失败。错误信息显示："This JDK does not contain packaged modules and cannot be used to create another image with the jdk.jlink module"。

根本原因分析

这个问题源于JDK 24中引入的JEP 493（移除打包工具模块）特性。Eclipse Temurin JDK 24完全采纳了这一特性，移除了.jmod文件，而其他JDK发行版（如Azul Zulu）则仍然保留了这些文件。这一变化影响了jlink和jpackage工具的正常使用。

解决方案探索

模块依赖分析

通过jdeps工具分析项目JAR文件的模块依赖关系，可以获取所需的Java模块列表。执行以下命令：

jdeps --print-module-deps --ignore-missing-deps logisim-evolution-4.0.0dev-all.jar

输出结果为：

java.base,java.compiler,java.desktop,java.naming,java.prefs,java.scripting,java.sql

构建脚本修改

在项目的build.gradle.kts文件中，需要将这些模块明确添加到jpackage的参数中。具体修改是在params列表中添加以下参数：

-add modules java.base,java.compiler,java.desktop,java.naming,java.prefs,java.scripting,java.sql

实施效果

实施这一修改后，不仅解决了构建失败的问题，还带来了以下好处：

1. 构建成功：createMsi任务能够正常完成
2. 体积优化：安装包大小从184MB显著减少到106MB
3. 功能完整：经过测试，包括帮助查看器在内的所有功能均正常工作

额外发现

在构建过程中还发现生成了两个名称相似的JAR文件：

• logisim-evolution-4.0.0-dev.jar（小文件）
• logisim-evolution-4.0.0dev-all.jar（主文件）

经分析，小文件是由打包插件生成的，仅包含基本的MANIFEST信息，对项目运行没有实际影响。这可能是构建配置中的命名自定义导致的副产品。

总结与建议

对于使用JDK 24及以上版本构建Java应用程序的项目，特别是需要创建自定义运行时镜像的情况，开发人员应当：

1. 明确指定应用程序所需的Java模块
2. 使用jdeps工具分析模块依赖关系
3. 在构建配置中显式声明这些模块依赖
4. 考虑模块化带来的体积优化优势

这一问题的解决不仅修复了构建失败的问题，还通过模块化优化显著减小了应用程序的部署体积，体现了现代Java开发的模块化优势。