- jdk: 11.0.15.1
- Javafx: 19.0.2.1
- Jfoenix: 9.0.10
ifoenix 库 采用 gradle 来管理，clone 下代码之后，很遗憾没有编译通过，因此重新创建项目使用 maven 进行管理；并将其 demo 模块移植过来；创建项目可以参考 javafx —— 创建项目与打包。
1、导入依赖
dependencies {
// implementation 'com.jfoenix:jfoenix:9.0.10'
compile project(':jfoenix')
// NOTE: the latest version _is_ 8.0.1!
// 8.0.7 was published by mistake
compile 'io.datafx:datafx:8.0.1'
compile 'io.datafx:flow:8.0.1'
// FontAwesome
// Versions higher than 2.x are for Java 11
compile 'org.kordamp.ikonli:ikonli-javafx:2.4.0'
compile 'org.kordamp.ikonli:ikonli-fontawesome5-pack:2.4.0'
}
查看 jfoenix 项目的 demo 模块中，gradle 引入的依赖如上所示，将其在 maven 项目中引入；上面 compile project(':jfoenix') 用于引入 jfoenix 模块，可以将其替换成 com.jfoenix:jfoenix:9.0.10。
<dependencies>
<dependency>
<groupId>com.jfoenix</groupId>
<artifactId>jfoenix</artifactId>
<version>9.0.10</version>
</dependency>
<dependency>
<groupId>io.datafx</groupId>
<artifactId>datafx</artifactId>
<version>8.0.1</version>
</dependency>
<dependency>
<groupId>io.datafx</groupId>
<artifactId>flow</artifactId>
<version>8.0.1</version>
</dependency>
<dependency>
<groupId>org.kordamp.ikonli</groupId>
<artifactId>ikonli-javafx</artifactId>
<version>2.4.0</version>
</dependency>
<dependency>
<groupId>org.kordamp.ikonli</groupId>
<artifactId>ikonli-fontawesome5-pack</artifactId>
<version>2.4.0</version>
</dependency>
</dependencies>
2、移入代码
删除新建 JavaFX 项目中 src/main 目录下的 java 代码和 resources 资源，并将 jfoenix 项目 demo 模块下的 src/main 中的 java 代码和 resources 资源拷贝过来；拷贝完成之后，还需要修改 javafx-maven-plugin 中的 mainClass 参数用于运行和打包。
<plugin>
<groupId>org.openjfx</groupId>
<artifactId>javafx-maven-plugin</artifactId>
<version>0.0.8</version>
<configuration>
<mainClass>demos/demos.MainDemo</mainClass>
<launcher>app</launcher>
<jlinkZipName>app</jlinkZipName>
<jlinkImageName>app</jlinkImageName>
<noManPages>true</noManPages>
<stripDebug>true</stripDebug>
<noHeaderFiles>true</noHeaderFiles>
</configuration>
</plugin>
此时尝试执行 mvn javafx:run 运行，提示 程序包javax.annotation不存在、找不到符号: 类 PostConstruct。
根据报错前的提示信息，选择 Add Java EE 6 JARs to module dependencies，在其弹出的面板中，选中 Download，点击 Configure… 打开下载选项，默认是会下载如下 9 个 jar 包，此处只需要勾选 javax.annotation.jar；点击 OK，完成依赖的导入。
如果是直接点击运行的 main 方法，上面导入 jar 即可，而要用到 javafx 插件运行打包，还需要将本地 jar 引用到 maven 中，配置如下：
<dependency>
<groupId>javax.annotation</groupId>
<artifactId>javax.annotation</artifactId>
<version>1.0.0</version>
<scope>system</scope>
<systemPath>${project.basedir}/lib/javax.annotation.jar</systemPath>
</dependency>
其中 groupId、artifactId、version 任意填写即可。上面的方法引入 javax.annotation 也可以简化成直接导入 maven 依赖；两种方式选择其一即可。
<dependency>
<groupId>javax.annotation</groupId>
<artifactId>javax.annotation-api</artifactId>
<version>1.3.2</version>
</dependency>
3、运行打包
不幸的是，经过上面的配置，此时程序还是不能运行，直接运行 main 方法提示的错误如下：
错误: 缺少 JavaFX 运行时组件, 需要使用该组件来运行此应用程序
可以打开启动类的运行配置，点击 Modify opotions —> Add VM option 添加如下参数。
--module-path=${javafx-sdk本地路径}/lib
--add-modules=javafx.controls,javafx.fxml,javafx.graphics
--add-exports=javafx.controls/com.sun.javafx.scene.control.behavior=ALL-UNNAMED
--add-exports=javafx.base/com.sun.javafx.binding=ALL-UNNAMED
--add-exports=javafx.base/com.sun.javafx.event=ALL-UNNAMED
--add-exports=javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED
--add-exports=javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED
--add-exports=javafx.controls/com.sun.javafx.scene.control.behavior=ALL-UNNAMED
--add-exports=javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED
另外，javafx:run 编译运行时也会抛出如下异常，需要将上面的 VM options 配置在 javafx-maven-plugin 中。
Caused by: io.datafx.controller.flow.FlowException: io.datafx.controller.FxmlLoadException: Can't create controller for class class demos.gui.main.MainController
<plugin>
<groupId>org.openjfx</groupId>
<artifactId>javafx-maven-plugin</artifactId>
<version>0.0.8</version>
<configuration>
<options>
<option>--module-path=${javafx-sdk本地路径}/lib</option>
<option>--add-modules=javafx.controls,javafx.fxml,javafx.graphics</option>
<option>--add-exports=javafx.controls/com.sun.javafx.scene.control.behavior=ALL-UNNAMED</option>
<option>--add-exports=javafx.base/com.sun.javafx.binding=ALL-UNNAMED</option>
<option>--add-exports=javafx.base/com.sun.javafx.event=ALL-UNNAMED</option>
<option>--add-exports=javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED</option>
<option>--add-exports=javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED</option>
<option>--add-exports=javafx.controls/com.sun.javafx.scene.control.behavior=ALL-UNNAMED</option>
<option>--add-exports=javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED</option>
</options>
<mainClass>demos.MainDemo</mainClass>
<launcher>app</launcher>
<jlinkZipName>app</jlinkZipName>
<jlinkImageName>app</jlinkImageName>
<noManPages>true</noManPages>
<stripDebug>true</stripDebug>
<noHeaderFiles>true</noHeaderFiles>
</configuration>
</plugin>
上面的参数配置，可以在导入的 jfoenix 依赖库的 module-info.class 中找到，因此对应不同版本可自行查看 VM options。
上面的 VM 参数中，需要指定本地 javafx-sdk 的路径，因此还需要下载 javafx 的 sdk，根据需要选择对应的系统架构和SDK版本，此时我选择的是和 pom.xml 中的 19.0.2.1 版本一致（非必须）。
至此，项目正常运行，效果如下，接下来可以学习下 Material Design 组件了。代码已提交到 github。
