在 Swing 中使用 Fuzio

在 Swing Gradle 项目中使用 Fuzio 最简单的方法，是克隆我们准备好的 Gitee 仓库，所有内容都已配置完毕，可以直接运行。

前提条件

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

获取项目

使用以下命令克隆 Gitee 仓库：

git clone https://gitee.com/jiku-technology-dev/fuzio-quickstart-gradle-swing.git
cd fuzio-quickstart-gradle-swing

运行 Swing 应用程序

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

./gradlew run -Dfuzio.license.key=<your_license_key>

启动后，你将看到一个嵌入了 BrowserView 组件的 Swing 应用，其中显示 https://html5test.jiku.co：

Swing 应用中的 BrowserView

项目概述

本节将介绍如何配置 Gradle 项目以引入 Fuzio，以及如何将 Fuzio 的 BrowserView 组件嵌入到 Swing 框架中以显示已加载网页的内容。

配置 Gradle 项目

Gradle 项目使用 Fuzio Gradle 插件来添加所需的 Fuzio 依赖项，并自动获取当前平台的 Chromium 二进制文件。

以下是 build.gradle.kts 的配置方式：

plugins {
    java
    application
    kotlin("jvm") version "2.0.0"

    // 添加 Fuzio 依赖项。
    id("tech.fuzio.gradle") version "1.0.0"
}

repositories {
    mavenCentral()
}

fuzio {
    // 使用最新稳定的 Fuzio 版本。
    version = "2026.3.0"
}

dependencies {
    // 检测当前平台并获取对应的 Chromium 二进制文件。
    implementation(fuzio.currentPlatform)

    // 添加 Swing UI 工具包集成的依赖项。
    implementation(fuzio.swing)

    // 添加 Fuzio Kotlin DSL 的依赖项。
    implementation(fuzio.kotlin)
}

application {
    // 定义 Java 应用程序的主类。
    mainClass.set("tech.fuzio.quickstart.gradle.swing.App")

    // 或者，你也可以运行 Kotlin 示例：
    // mainClass.set("tech.fuzio.quickstart.gradle.swing.AppKt")
}

tasks.withType<JavaExec> {
    // 将命令行中的所有 Java 系统属性传递给 JavaExec 任务，
    // 以便注入 Fuzio 许可证密钥。
    systemProperties(System.getProperties().mapKeys { it.key as String })
    jvmArgs(
        // 授予对 java.desktop/java.awt 模块的访问权限，
        // 以便 Fuzio 访问 Swing 焦点遍历功能。
        "--add-opens=java.desktop/java.awt=ALL-UNNAMED"
    )
}

在 Swing 中嵌入 Fuzio

项目中提供了两种 Swing 应用实现：Java 和 Kotlin。

两种实现类似，都演示了如何：

初始化 Engine（Chromium）实例。
创建 Browser 实例。
加载所需网页。
将 Web 视图组件嵌入 Swing 框架以显示已加载的网页：

Java
Kotlin
import static tech.fuzio.engine.RenderingMode.HARDWARE_ACCELERATED;
import static javax.swing.SwingUtilities.invokeLater;

import tech.fuzio.engine.Engine;
import tech.fuzio.view.swing.BrowserView;

import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import javax.swing.JFrame;

public final class App {

    public static void main(String[] args) {
        // 初始化 Chromium。
        var engine = Engine.newInstance(HARDWARE_ACCELERATED);

        // 创建 Browser 实例。
        var browser = engine.newBrowser();

        invokeLater(() -> {
            var frame = new JFrame("Fuzio Swing");
            frame.addWindowListener(new WindowAdapter() {
                @Override
                public void windowClosing(WindowEvent e) {
                    // 关闭 Chromium 并释放已分配的资源。
                    engine.close();
                }
            });
            // 创建并嵌入 Swing BrowserView 组件以显示 Web 内容。
            frame.add(BrowserView.newInstance(browser));
            frame.setSize(1280, 800);
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);

            // 加载所需网页。
            browser.navigation().loadUrl("https://html5test.jiku.co/");
        });
    }
}
import tech.fuzio.dsl.Engine
import tech.fuzio.engine.RenderingMode.HARDWARE_ACCELERATED
import tech.fuzio.view.swing.BrowserView
import java.awt.event.WindowAdapter
import java.awt.event.WindowEvent
import javax.swing.JFrame
import javax.swing.SwingUtilities

fun main() {
    // 初始化 Chromium。
    val engine = Engine(HARDWARE_ACCELERATED)

    // 创建 Browser 实例。
    val browser = engine.newBrowser()

    SwingUtilities.invokeLater {
        JFrame("Fuzio Swing").apply {
            // 在窗口关闭时关闭 Chromium 并释放资源。
            addWindowListener(object : WindowAdapter() {
                override fun windowClosing(e: WindowEvent) {
                    engine.close()
                }
            })
            // 创建并嵌入 Swing BrowserView 组件以显示网页内容。
            add(BrowserView.newInstance(browser))
            setSize(1280, 800)
            setLocationRelativeTo(null)
            isVisible = true
        }

        // 加载所需网页。
        browser.navigation().loadUrl("https://html5test.jiku.co/")
    }
}

了解更多

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

JavaFX

SWT