Maven Shade JavaFX运行时组件丢失

Z时代
2024-01-10
分类：问答

我正在尝试使用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>

回答：

这个答案解释了为什么在JavaFX 11上胖/超级jar失败的原因。

此错误来自java.base模块中的sun.launcher.LauncherHelper。原因是Main应用程序扩展了Application并具有main方法。如果是这种情况，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>

最后，树荫插件，你将要产生的脂肪jar，你的机器上。

这意味着到目前为止，你的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

现在，如果你制作了胖子罐，则将所有这些依赖项（以及项目中的其他常规第三方依赖项）捆绑在一起，然后可以按以下方式运行项目：

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>