Java Swing桌面项目打包成可执行jar

前言

最近有需求，将Swing项目打包为一个可执行的jar包，遇见了一些问题，参考AI助手，解决了遇到的问题，也有一些亲身实践体会，记录一下。开发环境IntelliJ IDEA，JDK8，用kotlin语言实现了一些类。

1.IDEA打jar包配置，没有用gradle或maven

内容来源某一言
如果你没有使用 Gradle，你可以按照以下步骤手动打包你的 Swing 项目为可执行的 JAR 文件：

1. 确保你的项目设置正确:

   • 确保你的项目是一个 Kotlin Swing 项目，并且所有源代码都在正确的目录结构中。

2. 打开你的项目在 IntelliJ IDEA 中:

3. 配置项目:

   • 在项目视图中，找到并右击你的项目。
   • 选择 “Open Module Settings” 或 “Project Structure”。
   • 在左侧菜单中选择 “Modules”。
   • 在右侧的 “Dependencies” 选项卡中，确保你的所有依赖都被正确添加。对于 Swing，你可能需要添加一些库或框架的依赖。

4. 创建可执行的 JAR 文件:

   • 打开项目结构设置后，选择 “Artifacts”。
   • 在左侧的列表中，选择 “Kotlin class” 或类似的选项。
   • 在右侧，选择 “From Modules with dependencies”。
   • 在 “Output layout” 中，确保你的主类和资源都被包含在内。
   • 在 “Build on make” 下拉菜单中，选择一个适当的选项，如 “package project into a single file”。
   • 点击 “OK” 来关闭对话框。

5. 生成 JAR 文件:

   • 在 IntelliJ IDEA 的顶部菜单中，选择 “Build” 或 “Rebuild Project”。这将会重新构建你的项目并生成 JAR 文件。

6. 找到并运行 JAR 文件:

   • 在项目目录下的 out/artifacts/ 文件夹中找到生成的 JAR 文件。
   • 使用命令行或终端，导航到该文件夹并运行以下命令来执行 JAR 文件：

   bash`java -jar yourprojectname.jar`
   

   这里 yourprojectname.jar 是你的 JAR 文件名。确保你有足够的权限来执行这个文件。如果你在 Windows 上，你可能需要使用 .exe 后缀来执行 JAR 文件。例如：java -jar yourprojectname.jar.exe。

2.资源的处理

在使用资源的时候，需要注意这个问题，比如图片、音频等，在开发阶段，使用方法和打包为可执行jar后还是有区别的。不然可能造成资源读取失败。

>image
  bg_key.png
>page
  Work.java

    val path = javaClass.getResource("../image/bg_key.png")
    println(path)
    var img = ImageIO.read(path)

上面这段代码是根据相对路径读取图片资源，图片保存在一个java package文件夹中，这样运行起来，可以正常读取到图片。

可是如果打包为可执行jar，程序就出错了。报错类似下图

这种情况可以使用Class.getResourceAsStream() 方法来读取资源，路径的话就是jar包中的路径，注意加/，/代表jar文件的根目录路径。

val stream = javaClass.getResourceAsStream("/game/image/bg_key.png")
val img = ImageIO.read(stream)

实践证明，也可以继续使用Class.getResource()方法，只要资源路径没问题，就能正常读取到资源。

3.第三方jar包的处理

如果没有处理第三方jar的引入，打包的可执行jar将出现找不到第三方jar中的类的错误，类似NoClassDefineFound之类的错误。

这时候在IDEA中，依次选择菜单Build–>Build Artifacts–>在弹出的Action菜单中，选择Edit，弹出一个对话框，左侧Artifacts默认选中，在右侧Output Layout中，Available Elements列表找到第三方jar，右键点击，弹出菜单中选择Extract Into Output Root即可，再重新Build Artifacts就可以找到第三方jar的类了。

2ref.资源处理参考某一言

当你将一个 Java 项目打包为一个可执行的 JAR 文件时，类的 class 路径和 JAR 文件的 class 路径是不同的。在打包之前，你可以通过相对路径或绝对路径来访问类路径下的资源。但在打包为 JAR 文件后，这些资源被包含在 JAR 文件中，不再是类路径下的文件。

如果你在打包后的 JAR 文件中尝试使用类路径来访问图片文件，那么将会失败，因为 JAR 文件并不包含类路径下的文件结构。

要解决这个问题，你可以使用以下方法之一：

1. 使用 Class.getResourceAsStream() 方法:
   这是最常见的方法，用于从 JAR 文件中读取资源。这种方法使用的是 JAR 文件的资源路径，而不是类路径。例如：

InputStream inputStream = YourClass.class.getResourceAsStream("/images/my_image.png");

注意，路径前面的 / 是必需的，它表示从 JAR 文件的根目录开始查找资源。
2. 将资源放在正确的位置:
确保你的图片文件放在了正确的位置，以便能够通过 getResourceAsStream() 方法正确地访问它。通常，你可以将资源放在与类相同的包中，或者放在一个单独的包中，并在 getResourceAsStream() 方法中使用适当的路径。
3. 使用外部资源:
如果你的应用程序需要访问外部文件或目录中的资源，而不是从 JAR 文件中访问资源，那么你可能需要将这些资源放在一个外部位置（例如文件系统中的一个文件夹），并在代码中提供适当的路径来访问它们。
4. 修改构建脚本:
如果你使用 Gradle 或 Maven 等构建工具，你可以修改构建脚本，以便在打包 JAR 文件时将资源包含在内。例如，在 Gradle 中，你可以使用 resources 配置来包含资源。

总之，当你在打包 JAR 文件后遇到资源访问问题时，关键是要了解 JAR 文件和类路径之间的区别，并使用适当的方法来访问资源。

4.总结

参考AI助手，解决问题快多了。