Logisim Evolution项目在Windows环境下使用Temurin JDK 24构建MSI包的问题分析与解决方案

问题背景

在Logisim Evolution项目的构建过程中，开发团队发现当使用Eclipse Temurin JDK 24在Windows 11 Pro系统上执行createMsi任务时，构建过程会失败。错误信息表明JDK缺少打包模块，无法使用jdk.jlink模块创建镜像。这一问题在使用JDK 23或其他JDK发行版24时不会出现。

根本原因分析

该问题的根源在于Eclipse Temurin JDK 24完全采纳了Java平台的一项改进规范，旨在简化JDK结构，移除传统打包工具模块。而其他JDK发行版仍保留了这些模块文件。

具体表现为：

1. jpackage工具需要访问JDK模块来创建自定义运行时镜像
2. Temurin JDK 24移除了这些模块，导致工具链中断
3. 错误信息明确指出"JDK does not contain packaged modules"

解决方案探索

通过分析Eclipse Temurin官方文档和技术讨论，我们确定了以下解决路径：

1. 使用jdeps工具分析项目依赖的Java模块
2. 明确指定项目所需的模块列表
3. 将这些模块传递给jpackage工具

具体实施步骤包括：

1. 执行jdeps --print-module-deps命令获取依赖模块
2. 处理可能出现的依赖缺失警告
3. 将确定的模块列表添加到Gradle构建脚本中

技术实现细节

在Logisim Evolution项目中，解决方案的具体实现包括：

1. 通过命令jdeps --print-module-deps --ignore-missing-deps logisim-evolution-4.0.0dev-all.jar获取依赖模块列表
2. 识别出项目核心依赖的模块：java.base、java.compiler、java.desktop、java.naming、java.prefs、java.scripting和java.sql
3. 将这些模块作为参数添加到Gradle构建脚本的jpackage任务配置中

解决方案效果

实施上述解决方案后：

1. MSI包构建任务成功执行
2. 安装包大小从184MB显著减少到106MB
3. 应用程序功能测试通过，包括帮助查看器等关键组件
4. 构建过程在不同JDK版本间获得更好的一致性

额外发现与建议

在解决主要问题的过程中，团队还发现了构建过程中生成的两个相似JAR文件的问题：

1. 一个完整的功能性JAR（logisim-evolution-4.0.0dev-all.jar）
2. 一个几乎为空的JAR（logisim-evolution-4.0.0-dev.jar）

建议后续优化构建配置，避免生成不必要的中间产物，使构建过程更加清晰高效。

总结

通过分析Logisim Evolution项目在Windows环境下使用Temurin JDK 24构建MSI包失败的问题，我们不仅解决了当前的技术障碍，还优化了应用程序的运行时镜像大小。这一案例也提醒Java开发者关注JDK发行版间的差异，特别是当采用新的Java规范时，可能需要调整构建工具链的配置。