在 JavaFX 中使用 Fuzio

本页面介绍如何在 Maven 项目中配置 Fuzio，并将其与 JavaFX GUI 工具包结合使用。

前提条件

Git。
Java 17 或更高版本。
Fuzio 许可证密钥，或免费试用密钥。

获取项目

本指南中描述的示例项目可在 Gitee 独立仓库中找到。

项目概述

本节说明 Maven 项目如何配置以包含 Fuzio，以及如何将 Fuzio 的 BrowserView 组件嵌入到 JavaFX 场景中，以显示加载的网页内容。

配置 Maven 项目

该 Maven 项目已配置为使用 Fuzio Maven 仓库来获取所需的 Fuzio 依赖项、下载所有平台的 Chromium 二进制文件，并添加 JavaFX UI 工具包集成。

以下是 pom.xml 文件的配置方式：

XML
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>tech.fuzio.quickstart.maven</groupId>
    <artifactId>javafx</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <!-- 使用最新稳定版本的 Fuzio。 -->
        <fuzio.version>2026.1.0</fuzio.version>

        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>

        <!-- 定义 Java 应用程序的主类。 -->
        <exec.mainClass>JavaFxApp</exec.mainClass>
    </properties>

    <repositories>
        <!-- 配置 Fuzio 的 Maven 仓库。 -->
        <repository>
            <id>tech.fuzio</id>
            <url>https://jiku.mycloudrepo.io/public/repositories/releases</url>
        </repository>
    </repositories>

    <dependencies>
        <!-- 获取适用于所有平台的 Chromium 二进制文件。 -->
        <dependency>
            <groupId>tech.fuzio</groupId>
            <artifactId>fuzio-cross-platform</artifactId>
            <version>${fuzio.version}</version>
            <type>pom</type>
        </dependency>

        <!-- 添加 JavaFX UI 工具包集成的依赖。 -->
        <dependency>
            <groupId>tech.fuzio</groupId>
            <artifactId>fuzio-javafx</artifactId>
            <version>${fuzio.version}</version>
        </dependency>
        <!-- 支持 JavaFX 集成。 -->
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>21.0.5</version>
        </dependency>
    </dependencies>

</project>

将 Fuzio 嵌入 JavaFX

在 JavaFX 应用程序源码中，你可以看到如何：

初始化 Engine（Chromium）实例。
创建 Browser 实例。
加载所需网页。
将 BrowserView 组件嵌入 JavaFX 场景中，以显示加载的网页。

Java
import static tech.fuzio.engine.RenderingMode.HARDWARE_ACCELERATED;

import tech.fuzio.engine.Engine;
import tech.fuzio.view.javafx.BrowserView;
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javafx.stage.Stage;

public final class JavaFxApp extends Application {

    public static void main(String[] args) {
        launch(args); // 启动 JavaFX 应用。
    }

    @Override
    public void start(Stage primaryStage) {
        // 初始化 Chromium。
        var engine = Engine.newInstance(HARDWARE_ACCELERATED);

        // 创建 Browser 实例并加载网页。
        var browser = engine.newBrowser();
        browser.navigation().loadUrl("https://html5test.jiku.co");

        // 创建并嵌入 JavaFX BrowserView 组件以显示网页内容。
        var view = BrowserView.newInstance(browser);
        
        var scene = new Scene(new BorderPane(view), 1280, 800);
        primaryStage.setTitle("Fuzio JavaFX");
        primaryStage.setScene(scene);
        primaryStage.show();

        // 关闭 Chromium 并释放资源。
        primaryStage.setOnCloseRequest(event -> engine.close());
    }
}

运行 JavaFX 应用程序

使用以下命令构建并运行 JavaFX 应用程序：

mvn clean compile exec:java -Dfuzio.license.key=<your_license_key>

启动后，你将看到一个包含 BrowserView 组件的 JavaFX 应用程序，该组件会显示 https://html5test.jiku.co：

JavaFX 应用程序中的 BrowserView

下一步

了解更多关于如何将 Fuzio 添加至 Maven 项目。
阅读关于如何将 Fuzio 嵌入 JavaFX 应用。
查阅我们的指南，探索 Fuzio 的全部功能。

Compose

SWT