OpenJFX 开源项目教程
本教程将指导您了解 OpenJFX —— Java 的下一代客户端应用程序平台。我们将探讨其目录结构,启动文件以及配置文件。
1. 项目目录结构及介绍
在克隆或下载 https://github.com/openjdk/jfx.git
后,你会看到一个典型的 Git 仓库结构:
OpenJFX/
├── build.gradle // 项目构建脚本
├── gradle/ // 包含 Gradle 相关配置
├── modules/ // 存放各个模块源代码的地方
│ ├── ... // 模块子目录(如 javafx.controls)
├── samples/ // 示例应用
└── settings.gradle // 格式化项目设置
- build.gradle: 这是整个项目的顶级构建脚本,定义了依赖关系和其他构建规则。
- gradle/: 包含 Gradle 构建工具的相关配置文件。
- modules/: 各个 OpenJFX 模块的源代码存放于此,例如
javafx.controls
,javafx.graphics
等。 - samples/: 提供了一些示例应用,用于展示 OpenJFX 功能和如何使用它们。
- settings.gradle: 定义了项目中的所有子模块。
2. 项目的启动文件介绍
OpenJFX 本身是一个库项目,不包含可以直接运行的应用程序。通常,开发者会在自己的项目中引入 OpenJFX 作为依赖来创建 JavaFX 应用。启动一个 JavaFX 应用时,你需要创建一个主类,其中包含 public static void main(String[] args)
方法。例如:
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.stage.Stage;
public class HelloWorld extends Application {
public static void main(String[] args) {
launch(args);
}
@Override
public void start(Stage primaryStage) {
primaryStage.setTitle("Hello World!");
primaryStage.show();
}
}
然后使用 Java 编译器 (javac
) 和 Java 运行时 (java
) 来编译和运行应用。
3. 项目的配置文件介绍
OpenJFX 主要通过 JavaFX 应用的主类参数和模块系统来配置。配置主要涉及以下方面:
- 模块声明:在你的主类中,你需要明确指定使用的 OpenJFX 模块,例如
requires javafx.controls;
。 - 命令行参数:当运行应用时,可以使用
-p
或--module-path
参数指定模块路径,--add-modules
添加所需模块,以及--version
查看所用 OpenJFX 版本等。 - 资源文件:应用可能包含 CSS 样式表或其他资源,这些可以通过类路径加载。
为了运行一个包含 JavaFX 配置的应用,可以使用类似下面的命令:
java --module-path <path_to_jfx_libs> --add-modules=javafx.controls,javafx.fxml -cp <your_class_path> HelloWorld
这里 <path_to_jfx_libs>
是 OpenJFX 库的位置,而 <your_class_path>
是你的应用类文件或 JAR 文件所在位置。
以上就是对 OpenJFX 项目的基本介绍,包括目录结构、启动文件和配置文件。希望这个指南对理解 OpenJFX 并开始开发 JavaFX 应用有所帮助。