我有一個 maven 專案,我想將其匯出到可運行的 .jar 檔案中。
在 VSCode 中,該專案可以正常作業。匯出的專案包括一個 .jar 檔案和一個libs包含所有 javaFX 檔案的檔案夾:
Documents/prosjekt/target
├── classes
├── generated-sources
├── generated-test-sources
├── libs
│ ├── apiguardian-api-1.1.0.jar
│ ├── javafx-base-18.0.1-mac-aarch64.jar
│ ├── javafx-base-18.0.1.jar
│ ├── javafx-controls-18.0.1-mac-aarch64.jar
│ ├── javafx-controls-18.0.1.jar
│ ├── javafx-fxml-18.0.1-mac-aarch64.jar
│ ├── javafx-fxml-18.0.1.jar
│ ├── javafx-graphics-18.0.1-mac-aarch64.jar
│ ├── javafx-graphics-18.0.1.jar
│ ├── javafx-media-18.0.1-mac-aarch64.jar
│ ├── javafx-media-18.0.1.jar
│ ├── junit-jupiter-api-5.7.0.jar
│ ├── junit-jupiter-engine-5.7.0.jar
│ ├── junit-platform-commons-1.7.0.jar
│ ├── junit-platform-engine-1.7.0.jar
│ └── opentest4j-1.2.0.jar
├── maven-archiver
├── maven-status
├── surefire-reports
├── prosjekt_boilerplate-1.0-SNAPSHOT.jar
└── test-classes
當我運行以下命令時會出現問題:
? java -jar /Users/user/Documents/prosjekt/target/prosjekt_boilerplate-1.0-SNAPSHOT.jar
Error: JavaFX runtime components are missing, and are required to run this application
我不明白為什么會出現此錯誤,因為所有 JavaFX 檔案都位于libs檔案夾中并且可見。
我目前使用 SDKman 的 Java Temurin 18.0.1。
? java -version
openjdk version "18.0.1" 2022-04-19
OpenJDK Runtime Environment Temurin-18.0.1 10 (build 18.0.1 10)
OpenJDK 64-Bit Server VM Temurin-18.0.1 10 (build 18.0.1 10, mixed mode)
Pom.xml檔案:
<?xml version="1.0" encoding="UTF-8"?>
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>project</groupId>
<artifactId>prosjekt_boilerplate</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>prosjekt_boilerplate</name>
<dependencies>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-fxml</artifactId>
<version>18.0.1</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-media</artifactId>
<version>18.0.1</version>
</dependency>
<!-- JUnit 5 -->
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
<version>5.7.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<release>17</release>
</configuration>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.0.0-M5</version>
<configuration>
<argLine>--enable-preview</argLine>
</configuration>
</plugin>
<plugin>
<artifactId>maven-failsafe-plugin</artifactId>
<version>3.0.0-M5</version>
<configuration>
<argLine>--enable-preview</argLine>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>prepare-package</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
<configuration>
<outputDirectory>
${project.build.directory}/libs
</outputDirectory>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifest>
<addClasspath>true</addClasspath>
<classpathPrefix>libs/</classpathPrefix>
<mainClass>
asteroids.AsteroidsApp
</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
</plugins>
</build>
</project>
編輯
我嘗試下載 JavaFX SDK 并運行以下命令:
? java -jar --module-path /Users/user/Downloads/javafx-sdk-18.0.1/lib \
--add-modules=javafx.controls,javafx.media,javafx.fxml,javafx.graphics \
/Users/user/Documents/prosjekt/target/prosjekt_boilerplate-1.0-SNAPSHOT.jar
它奏效了!但它仍然沒有回答我原來的問題。
uj5u.com熱心網友回復:
盡管出于解釋的目的,這是一個很長的答案,但修復實際上非常簡單。
唯一需要做的是將帶有模塊的 jar 放在模塊路徑而不是類路徑上。
回答您的問題以解釋您的原始方法為何失敗。
當我運行以下命令時會出現問題:
java -jar /Users/user/Documents/prosjekt/target/prosjekt_boilerplate-1.0-SNAPSHOT.jar
Error: JavaFX runtime components are missing, and are required to run this application我不明白為什么會出現此錯誤,因為所有 JavaFX 檔案都位于 libs 檔案夾中并且可見。
您收到此錯誤的原因是您正在運行類路徑而不是模塊路徑的所有代碼。
現代 JavaFX 版本未設計或支持從類路徑運行。它們應該從模塊路徑運行。
您已完成以下操作,這將使程式僅在類路徑上執行:
- 使用您的應用程式創建了一個 jar。
- 在 jar 中創建了一個清單,用于指定您的執行類。
- 向清單添加了庫路徑。
背景資訊
您的應用程式類不需要是模塊化的,并且能夠從類路徑而不是模塊路徑執行的其他(非 JavaFX)庫在放置在類路徑上時將起作用,但 JavaFX 庫將失敗。
解決方案是至少將 JavaFX 類放在模塊路徑上。理想情況下,您還可以使您的應用程式模塊化(module-info.java為它定義一個檔案)并在您的應用程式中僅使用非自動模塊化 jar(也定義 a 的那些module-info.java)。但理想的情況不是必需的(除非您想使用 jlink 打包您的應用程式),只需要在模塊路徑上包含 JavaFX 類。
您不能(當前)通過 jar 清單將其他 jar 或檔案夾添加到模塊路徑,就像您當前可以使用類路徑一樣。有關這方面的資訊,請參閱此問題的答案(以及對此答案的評論):
- Java 模塊和 JAR MANIFEST 類路徑屬性
相反,您需要指定在命令列中添加的模塊的位置(或依賴由 jlink 創建的預先捆綁了所需模塊的 JRE 映像)。
此外,如果您的應用程式是模塊化的,您應該使用-m開關來指定由它所在的模塊限定的主類,并且您的應用程式 jar 也應該在模塊路徑上。如果您的應用程式不是模塊化的,那么您仍然可以使用說明-jar符并在 jar 清單中對主類名稱進行編碼,而不是作為命令列開關。
例子
因此,假設您將應用程式分發為一個 zip,其中包含您的應用程式 jar 和依賴庫,位于名為 lib 的子檔案夾中。
對于這些示例,應用程式 jar 是一個普通的瘦 jar(它不是一個有陰影或包含 JavaFX 運行時代碼的胖 jar)。
對于非模塊化應用程式,這在伊甸園編碼中進行了討論。用戶解壓縮包后,假設主類名已編碼在清單中,則可以通過以下方式運行應用程式:
java -jar myJar.jar --module-path lib --add-modules javafx.controls,javafx.fxml
如果您使用額外的 JavaFX 模塊,例如 javafx-media,它們不是傳遞依賴,那么也包括這些。
如果你的應用程式是模塊化的,那么你不需要在 jar 清單中編碼額外的資訊,但你需要module-info.java在你的 jar 檔案中包含一個。這樣做時,最好將您的 jar 放在與您正在使用的其他模塊相同的 lib 目錄中,這樣您就不需要將它單獨添加到模塊路徑中。完成此操作后,您可以像這樣運行應用程式(此示例來自jenkov 關于 Java 模塊的教程):
java --module-path lib -m com.jenkov.mymodule/com.jenkov.mymodule.Main
您可以使用 jar 命令設定一個主類來運行模塊化 jar 檔案(在 jenkov 教程中也有演示)。然后,您可以在不顯式提供主類的情況下運行該模塊化 jar,但指定 jar 檔案和模塊路徑(JavaFX 應用程式仍需要模塊路徑):
jar -c --file=lib/com-jenkov-mymodule.jar --main-class=com.jenkov.mymodule.Main -C out/com.jenkov.mymodule .
java --module-path lib -jar lib/com-jenkov-javafx.jar
我不確切知道 jar 命令將執行命令添加到 jar 檔案中的作用,但我不認為它使用清單來執行此操作。目前,我認為 maven jar 命令不能正確執行此操作(我認為它只是將資訊放在清單中,而不是在 jar 中放置模塊化主類執行資訊)。
總之,使用 Java 模塊和使用類路徑是不同的并且令人困惑。. . :-)
哈克
有(至少對于 Java 17)一個 hack 來創建一個單獨的啟動器類,它繞過運行時檢查以允許從模塊路徑而不是類路徑啟動 JavaFX 框架,但它不受支持。我不推薦它,所以我不會在這里進一步解釋。
進一步的建議
由于命令列開關容易出錯或輸入錯誤,因此最好在部署 JavaFX 應用程式時提供特定于平臺的執行腳本(unix/mac shell 腳本或 windows 批處理檔案),用戶可以更輕松地使用它來執行應用程式.
還可以考慮使用 Java 運行時分發,通過壓縮的 jlink 映像或 jpackage 創建的安裝程式。這使您的用戶更容易,因為他們不需要找到并安裝適當的 java 運行時來使用您的應用程式。作為獎勵,jlink 可以創建一個示例 shell 腳本來執行您的應用程式。通過 maven 執行此操作很容易,使用 maven-javafx-plugin 的 jlink 選項并指定 jlinkZipName。
jpackage 可以創建一個作業系統級別的圖示,用戶只需單擊即可運行應用程式,但不能直接從 maven-javafx-plugin 使用。
其他資源
更多資訊,包括javafx 標簽資訊包裝資源中的JPackageScriptFX等包裝選項的鏈接。
相關問題:如何使用 Maven Assembly 插件為 JavaFX 專案創建一體化 jar?
轉載請註明出處,本文鏈接:https://www.uj5u.com/qiye/481858.html
