添加 Fuzio 至 Gradle 项目

将 Fuzio 添加到 Gradle 项目最简单的方式是使用 Fuzio Gradle 插件。本指南将介绍如何使用它。

应用插件

你可以通过将 Fuzio Gradle 插件添加到 plugins 块中，或者作为 buildscript 依赖项的方式，将其应用到 Gradle 项目中。无论采用哪种方式，都需要指定插件版本。本指南使用最新版本的插件（1.0.0），你可以在 Gradle 插件门户上找到该版本。

使用 `plugins` 块

请在 Gradle DSL 的 plugins 块中添加以下代码：

Kotlin
Groovy
plugins {
    id("tech.fuzio.gradle") version "1.0.0"
}
plugins {
    id 'tech.fuzio.gradle' version '1.0.0'
}

作为 `buildscript` 依赖项

如果你必须使用传统方式来应用插件，可以将 Fuzio Gradle 插件作为 buildscript 依赖项添加：

Kotlin
Groovy
buildscript {
    repositories {
        maven {
            url = uri("https://plugins.gradle.org/m2/")
        }
    }
    dependencies {
        classpath("tech.fuzio:fuzio-gradle-plugin:1.0.0")
    }
}

apply(plugin = "tech.fuzio.gradle")
buildscript {
    repositories {
        maven {
            url "https://plugins.gradle.org/m2/"
        }
    }
    dependencies {
        classpath "tech.fuzio:fuzio-gradle-plugin:1.0.0"
    }
}

apply plugin: "tech.fuzio.gradle"

配置插件

应用插件后，可以通过 build.gradle(.kts) 文件中的 fuzio 扩展进行配置。

Fuzio 版本

version 属性是必需属性，用于指定 Fuzio 的版本。以下是将插件配置为使用最新版本 Fuzio 的方式：

Kotlin
Groovy
fuzio {
    version = "2026.3.0"
}
fuzio {
    version = '2026.3.0'
}

所有可用的 Fuzio 版本列表可在版本发布说明页面查看。

存储库

Fuzio 工件托管在我们自己的 Maven 仓库中。我们使用自有仓库而不是 Maven Central，以加快新版本发布速度，并确保对仓库及其配置拥有完全控制权。

Fuzio 仓库位于中国。默认情况下，插件会使用 Jiku 官方托管的仓库，因此无需进行额外配置。

如果你希望将 Fuzio 工件存储在自定义 Maven 仓库中，也可以按如下方式配置插件来使用该仓库：

Kotlin
Groovy
fuzio {
    repository = "https://my.custom.repository"
}
fuzio {
    repository = 'https://my.custom.repository'
}

依赖项

Fuzio 是一个跨平台库，支持不同的操作系统、CPU 架构和 Java UI 工具包。它集成了 Chromium，并将其二进制文件打包在 JAR 文件中。针对每一类操作系统和 CPU 架构，Fuzio 都提供了一个单独的依赖项，其中包含所需的 Chromium 二进制文件。

包含 Chromium 二进制文件的依赖项大小可能会因操作系统和 CPU 架构而异，最大可能达到 110MB。因此，只向项目中添加所需的依赖项非常重要。

特定平台

如果你面向特定操作系统和 CPU 架构进行开发，可以使用以下代码向项目中添加一个或多个平台专用依赖项：

Kotlin
Groovy
dependencies {
    implementation(fuzio.win32)        // Windows 32-bit
    implementation(fuzio.win64)        // Windows 64-bit
    implementation(fuzio.winArm)       // Windows 64-bit ARM
    implementation(fuzio.mac)          // Mac Intel
    implementation(fuzio.macArm)       // Mac Apple Silicon
    implementation(fuzio.linux64)      // Linux 64-bit
    implementation(fuzio.linuxArm)     // Linux 64-bit ARM
    implementation(fuzio.linux64Loong) // Linux 64-bit LoongArch
}
dependencies {
    implementation fuzio.win32         // Windows 32-bit
    implementation fuzio.win64         // Windows 64-bit
    implementation fuzio.winArm        // Windows 64-bit ARM
    implementation fuzio.mac           // Mac Intel
    implementation fuzio.macArm        // Mac Apple Silicon
    implementation fuzio.linux64       // Linux 64-bit
    implementation fuzio.linuxArm      // Linux 64-bit ARM
    implementation fuzio.linux64Loong  // Linux 64-bit LoongArch
}

支持的操作系统和 CPU 架构列表可在系统要求中查看。

当前平台

如果你为多个平台开发，并希望自动检测当前平台、仅下载对应的 Chromium 二进制文件，则可以使用 currentPlatform 依赖项：

Kotlin
Groovy
dependencies {
    implementation(fuzio.currentPlatform)
}
dependencies {
    implementation fuzio.currentPlatform
}

该依赖项非常适合在开发阶段使用。如果你计划使用 Gradle 脚本进行部署，则应添加所有需要的特定平台依赖项；否则只会获取 Gradle 脚本执行所在操作系统的二进制文件。

GUI 工具包

如果你使用 Swing、JavaFX、SWT 或 Compose Desktop UI 工具包来构建应用程序的 GUI，请同时添加对应的 Fuzio 依赖项：

Kotlin
Groovy
dependencies {
    implementation(fuzio.swt)
    implementation(fuzio.swing)
    implementation(fuzio.javafx)
    implementation(fuzio.compose)
}
dependencies {
    implementation fuzio.swt
    implementation fuzio.swing
    implementation fuzio.javafx
    implementation fuzio.compose
}

Kotlin DSL

如果你使用 Kotlin 进行开发，建议添加 Fuzio Kotlin DSL 以获得最佳使用体验。

Kotlin
Groovy
dependencies {
    implementation(fuzio.kotlin)
}
dependencies {
    implementation fuzio.kotlin
}

总结

以下是完整的 build.gradle(.kts) 代码：

Kotlin
Groovy
import tech.fuzio.gradle.Repository

plugins {
    java
    id("tech.fuzio.gradle") version "1.0.0"
}

fuzio {
    // Fuzio 版本（必需）。
    version = "2026.3.0"

    // 要使用的 Fuzio Maven 仓库（可选）。
    // 默认使用 Jiku 官方托管的仓库。
    // repository = Repository.DEFAULT

    // 或者，也可以像下面这样通过 URL 指向自定义仓库：
    // repository = "https://my.custom.repository"
}

dependencies {
    // 添加特定平台的 Chromium 二进制文件依赖项。
    implementation(fuzio.mac)          // Mac Intel
    implementation(fuzio.macArm)       // Mac Apple Silicon
    implementation(fuzio.win32)        // Windows 32-bit
    implementation(fuzio.win64)        // Windows 64-bit
    implementation(fuzio.winArm)       // Windows 64-bit ARM
    implementation(fuzio.linux64)      // Linux 64-bit
    implementation(fuzio.linuxArm)     // Linux 64-bit ARM
    implementation(fuzio.linux64Loong) // Linux 64-bit LoongArch

    // 检测当前平台并添加相应的 Chromium 二进制文件。
    implementation(fuzio.currentPlatform)

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

    // 添加 Fuzio Kotlin DSL 的依赖。
    implementation(fuzio.kotlin)
}
import tech.fuzio.gradle.Repository

plugins {
    id 'java'
    id 'tech.fuzio.gradle' version '1.0.0'
}

fuzio {
    // Fuzio 版本（必需）。
    version = '2026.3.0'

    // 要使用的 Fuzio Maven 仓库（可选）。
    // 默认使用 Jiku 官方托管的仓库。
    // repository = Repository.DEFAULT

    // 或者，也可以像下面这样通过 URL 指向自定义仓库：
    // repository = 'https://my.custom.repository'
}

dependencies {
    // 添加特定平台的 Chromium 二进制文件依赖项。
    implementation fuzio.mac           // Mac Intel
    implementation fuzio.macArm        // Mac Apple Silicon
    implementation fuzio.win32         // Windows 32-bit
    implementation fuzio.win64         // Windows 64-bit
    implementation fuzio.winArm        // Windows 64-bit ARM
    implementation fuzio.linux64       // Linux 64-bit
    implementation fuzio.linuxArm      // Linux 64-bit ARM
    implementation fuzio.linux64Loong  // Linux 64-bit LoongArch

    // 检测当前平台并添加相应的 Chromium 二进制文件。
    implementation fuzio.currentPlatform

    // 添加 UI 工具包集成的依赖项。
    implementation fuzio.swt
    implementation fuzio.swing
    implementation fuzio.javafx
    implementation fuzio.compose

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

无头模式

Maven