javafx —— 组件库 jfoenix

作者: JinYx | 来源:发表于2023-06-01 12:54 被阅读0次

JavaFX与TestFX——踩坑实录
安装IDEA 2018.3.6，打开个JavaFx桌面小应用，踩
maven+IDEA+JavaFX+JFoenix
JavaSE 学习路线图
什么是JavaFX，为什么要用Kotlin扩展
SpringBoot整合JavaFx、Jfoenix开发一个简单
TornadoFX编程指南，第3章，组件
在Eclipse中安装e(fx)lipse (JavaFX工具）
Swing使用JavaFXweb组件
JFoenix使用

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。