64

我正在尝试使用 maven 依赖项创建一个 JFX11 自包含 jar。从我所做的研究来看,似乎最好的方法是通过 maven shade 插件。但是,当我运行它时,我得到了这个错误:

错误:缺少 JavaFX 运行时组件,需要运行此应用程序

我不明白为什么会这样。我在搞砸什么?有一个更好的方法吗?我还尝试了具有相同消息的 maven 程序集插件。

pom文件供参考

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>Application</groupId>
    <artifactId>Main</artifactId>
    <packaging>jar</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>SpaceRunner</name>
    <url>http://maven.apache.org</url>
    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>11</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.0</version>
                <configuration>
                    <release>10</release>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>exec-maven-plugin</artifactId>
                <version>1.6.0</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>java</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <mainClass>Application.Main</mainClass>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-jar-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>
                                Application.Main
                            </mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>Application.Main</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>
4

1 回答 1

135

更新 10/2021

由于 JavaFX 16,当 JavaFX 不在模块路径上运行时会显示警告,这是 uber/fat jar 的情况:

$ java -jar myFatJar-1.0-SNAPSHOT.jar
Oct 02, 2021 1:45:21 PM com.sun.javafx.application.PlatformImpl startup
WARNING: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @14c24f4c'

此外,您会收到来自 shade 插件本身的警告:

[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.

虽然这些警告最初可以被忽略,但它们是有原因的。

如本CSR所述:

JavaFX 是作为一组命名模块构建和分发的,每个模块都在其自己的模块化 jar 文件中,并且 JavaFX 运行时期望其类从一组命名 javafx.* 模块加载,并且不支持从类路径加载这些模块.

和:

当从类路径加载 JavaFX 类时,它会破坏封装,因为我们不再能从 java 模块系统中受益。

因此,即使这个被广泛接受的答案也解释了如何在 Maven 项目上创建 uber/fat jar,不鼓励使用它,并且应该使用其他现代替代方法来分发您的应用程序jlink,例如jpackagenative-image

原始答案

这个答案解释了为什么胖/超级 jar 在 JavaFX 11 上失败。简而言之:

此错误来自 java.base 模块中的 sun.launcher.LauncherHelper。原因是主应用程序扩展了应用程序并有一个主方法。如果是这种情况,LauncherHelper 将检查javafx.graphics模块是否作为命名模块存在。如果该模块不存在,则中止启动。

并且已经提出了 Gradle 的修复方案。

对于 Maven,解决方案完全相同:提供一个不从Application.

您的application包中将有新课程(坏名):

// NewMain.java
public class NewMain {

    public static void main(String[] args) {
        Main.main(args);
    }
}

和您现有的Main课程一样:

//Main.java
public class Main extends Application {

    @Override
    public void start(Stage stage) {
        ...
    }

    public static void main(String[] args) {
        launch(args);
    }
}

现在你需要修改你的 pom 并为不同的插件设置你的主类:

<mainClass>application.NewMain</mainClass>

平台特定的 Fat jar

最后,使用 shade 插件,您将在您的机器上生成一个胖罐子。

这意味着,到目前为止,您的 JavaFX 依赖项使用的是唯一的分类器。例如,如果您在 Windows 上,Maven 将在内部使用win分类器。这具有仅包括 Windows 的本机库的效果。

所以你正在使用:

  • org.openjfx:javafx-controls:11
  • org.openjfx:javafx-controls:11:win
  • org.openjfx:javafx-graphics:11
  • org.openjfx:javafx-graphics:11:win <-- 这包含 Windows 的本机 dll
  • org.openjfx:javafx-base:11
  • org.openjfx:javafx-base:11:win

现在,如果您生成 fat jar,您将捆绑所有这些依赖项(以及项目中的其他常规第三方依赖项),并且您将能够以如下方式运行您的项目:

java -jar myFatJar-1.0-SNAPSHOT.jar

虽然这很好,但如果你想分发你的 jar,请注意这个 jar不是跨平台的,它只能在你的平台上工作,在这种情况下是 Windows。

跨平台脂肪罐

有一种解决方案可以生成可以分发的跨平台 jar:包括其他平台的其余本机库。

这很容易做到,因为您只需要包含三个平台的图形模块依赖项:

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>11</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-graphics </artifactId>
        <version>11</version>
        <classifier>win</classifier>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-graphics </artifactId>
        <version>11</version>
        <classifier>linux</classifier>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-graphics </artifactId>
        <version>11</version>
        <classifier>mac</classifier>
    </dependency>
</dependencies>

尺寸

这种方法有一个主要问题:大小。正如您在其他答案中看到的那样,如果您使用 WebView 控件,由于 WebKit 本机库,您将捆绑大约 220 MB。

于 2018-10-04T20:37:17.373 回答