JFX11+IDEA跨平台打包發布的完美解決辦法


1 概述

IDEA2020.1的文檔中提到只有JFX8的工程才支持打成jar包,並且,如果直接使用Build Artifacts的話,會如下提示:
在這里插入圖片描述
IDEA文檔有提到這個的解決辦法,是使用一些第三方工具。里面介紹了通過IDEA結合自身/Maven/Gradle打包發布JFX11以上版本的方法。但是,不足的地方有:

  • 直接創建JFX工程默認只有一個src目錄,不像Maven工程還帶有resources與test,給管理資源文件以及外部依賴造成了困難,getClass().getResource()會出現空指針問題,但是好處是只需具備JDK環境,打包出來的文件能帶上jmods能跨平台直接運行
  • 直接創建Maven項目雖然是管理依賴以及資源文件方便,但是無論是直接通過Maven打出的jar包還是通過JavaFX Maven Plugins打出來的jar包默認綁定了開發平台的JFX SDK,簡單地說就是Linux開發的JFX程序不能直接跑在具有JDK環境的Win上,因為用的是Linux的JFX SDK而不是Win的JFX SDK

因此,本文結合這兩者的優點,參照Maven的目錄管理,以JFX工程為基礎,記錄了從新建工程到發布跨平台JFX應用的過程。

2 環境

  • IDEA 2020.1
  • OpenJDK 11
  • OpenJFX 11 Linux SDK
  • OpenJFX 11 Linux/Windows/Mac OS X jmods

JDK安裝就不說了,JFX直接下載然后在工程中通過外部庫引入即可,三種jmods解壓出來即可,用於最后生成可執行文件時添加的模塊。
下載鏈接戳這里

3 新建JFX工程

在這里插入圖片描述
這里的項目名為TestJFX,對應修改即可。
在這里插入圖片描述

4 添加JFX11 SDK

在這里插入圖片描述
添加上一步下載的對應平台的JFX SDK。
在這里插入圖片描述

5 添加module-info.java

在src目錄右鍵New->module-info.java,修改如下:

module TestJFX {
    requires javafx.fxml;
    requires javafx.controls;
    
    opens sample to javafx.fxml;
    exports sample;
}

其中TestJFX為新建項目時的項目名,這個創建module-info.java時就默認加上了,sample為默認包,對應修改。

6 添加VM Options

在這里插入圖片描述
在這里插入圖片描述
添加

--module-path /usr/local/jfx/lib:out/production

其中

/usr/local/jfx/lib

為下載的JFX JDK的lib目錄,后面的out不需要更改,是默認的編譯輸出的目錄。

7 運行

這時候應該可以Shift+F10或者點擊綠色小三角運行了:
在這里插入圖片描述
當然內容是空的,因為什么也沒有加。

8 添加資源文件

默認的fxml是放在與Main類同一目錄下的,getResource()也沒有加路徑直接寫上文件名:
在這里插入圖片描述
但是這是src文件夾,放個fxml還勉強可以接受,放張圖片總不合適吧?所以,新建一個資源文件夾,把css,fxml什么的都放里面:
在這里插入圖片描述
直接在IDEA中移動fxml文件,Main中的引用路徑也自動更改,不得不說這個特性是真的好用,但遺憾的是,拋出了空指針異常。
因此采取絕對路徑來進行讀取文件,通過URL+System.getProperty()指定絕對路徑:

@Override
public void start(Stage primaryStage) throws Exception{
    String path = System.getProperty("user.dir");
    URL fxmlUrl = new URL("file:"+path+"/resources/fxml/sample.fxml");
    Parent root = FXMLLoader.load(fxmlUrl);
    primaryStage.setTitle("Hello World");
    Scene scene = new Scene(root);
    scene.getStylesheets().add(new URL("file:"+path+"/resources/css/1.css").toString());
    primaryStage.setScene(scene);
    primaryStage.show();
}

其中

System.getProperty("user.dir")

獲取項目路徑,注意URL前面要加上“file:”,css的獲取也同理,只不過是需要轉換為String。

9 外部依賴

由於沒有了Maven管理依賴,所以外部依賴的管理會相對麻煩一點,基本上是以jar包的形式手動添加,這里以添加Gson為例,戳這里下載jar包,然后在項目目錄下新建一個lib文件夾,把jar包放進去:
在這里插入圖片描述
接着在項目結構中把整個lib文件夾添加到外部庫:
在這里插入圖片描述
然后VM Options中添加lib路徑,在上面的VM Options后面加一個冒號和lib就行:
在這里插入圖片描述
但是,此時可以IDEA還不能進行補全,最后需要修改module-info.java:
在這里插入圖片描述
加一行requires,此時IDEA能夠進行補全了,每個jar包都不同,對應修改即可。

10 制作跨平台鏡像

運行沒問題之后就可以制作運行時鏡像發布了,終端進入項目根路徑:

jlink --module-path jmod/linux:out/production:lib --add-modules TestJFX --output linux
linux/bin/java -m TestJFX/sample.Main

在這里插入圖片描述
其中

jmod/linux

為開發平台jmod的路徑,可以是絕對路徑,也可以是相對與項目根目錄的相對路徑,out/production與上面的VM Options保持一致。

--add-modules

后面跟的是模塊名,這是在生成module-info.java時指定的,為項目名。

--output

為輸出目錄。
后一條命令中-m指定模塊名,后面跟包名+主類名。
這樣linux平台的鏡像就制作好了,Mac與Win的同理,只需要把jmod換成對應平台的jmod即可,但是注意語法有一些差別,Mac的語法同Linux,只需要把jmod路徑換一下,但是注意需要整個工程在對應的平台進行jlink:

jlink --module-path xxxxx/{MAC_JMOD}:out/production:lib --add-modules TestJFX --output mac
mac/bin/java -m TestJFX/sample.Main

Win的語法有些區別,一樣需要在Win下進行jlink:

jlink --module-path "xxxxx/{WIN_JMOD};out/production" --add-modules TestJFX --output win
win\bin\java -m TestJFX/sample.Main

下面是Win下的截圖:
在這里插入圖片描述

11 demo

github

12 參考

Getting Started with JavaFX


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM