詳解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 jmodsJDK安裝就不說了,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()指定絕對路徑:
@Overridepublic 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 linuxlinux/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 macmac/bin/java -m TestJFX/sample.Main
Win的語法有些區別,一樣需要在Win下進行jlink:
jlink --module-path 'xxxxx/{WIN_JMOD};out/production' --add-modules TestJFX --output winwinbinjava -m TestJFX/sample.Main
下面是Win下的截圖:
11 demo
github
12 參考
Getting Started with JavaFX
到此這篇關于詳解JFX11+IDEA跨平臺打包發布的完美解決辦法的文章就介紹到這了,更多相關JFX11+IDEA跨平臺打包內容請搜索好吧啦網以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持好吧啦網!
相關文章:
