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

news2024/9/29 13:31:12

前言

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

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

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

确保你的项目设置正确:
- 确保你的项目是一个 Kotlin Swing 项目，并且所有源代码都在正确的目录结构中。
打开你的项目在 IntelliJ IDEA 中:
配置项目:
- 在项目视图中，找到并右击你的项目。
- 选择 “Open Module Settings” 或 “Project Structure”。
- 在左侧菜单中选择 “Modules”。
- 在右侧的 “Dependencies” 选项卡中，确保你的所有依赖都被正确添加。对于 Swing，你可能需要添加一些库或框架的依赖。
创建可执行的 JAR 文件:
- 打开项目结构设置后，选择 “Artifacts”。
- 在左侧的列表中，选择 “Kotlin class” 或类似的选项。
- 在右侧，选择 “From Modules with dependencies”。
- 在 “Output layout” 中，确保你的主类和资源都被包含在内。
- 在 “Build on make” 下拉菜单中，选择一个适当的选项，如 “package project into a single file”。
- 点击 “OK” 来关闭对话框。
生成 JAR 文件:
- 在 IntelliJ IDEA 的顶部菜单中，选择 “Build” 或 “Rebuild Project”。这将会重新构建你的项目并生成 JAR 文件。
找到并运行 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()方法，只要资源路径没问题，就能正常读取到资源。

2.资源处理参考某一言

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

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

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

使用 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 配置来包含资源。