添加 Fuzio 至 Gradle 项目

本页介绍如何配置 Gradle 项目以使用 Fuzio。

Fuzio 版本

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

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

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

存储库

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

Fuzio 仓库位于中国。你可以通过设置 repository 属性来指定应使用哪个 Fuzio 仓库。

以下代码片段展示了如何使用我们的 Fuzio 仓库：

Kotlin
Groovy
repositories {
    maven("https://jiku.mycloudrepo.io/public/repositories/releases")
}
repositories {
    maven "https://jiku.mycloudrepo.io/public/repositories/releases"
}

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

Kotlin
Groovy
repositories {
    maven("https://my.custom.repository")
}
repositories {
    maven 'https://my.custom.repository'
}

依赖项

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

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

特定平台

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

Kotlin
Groovy
dependencies {
    implementation("tech.fuzio:fuzio-win32:${fuzioVersion}")           // Windows 32-bit
    implementation("tech.fuzio:fuzio-win64:${fuzioVersion}")           // Windows 64-bit
    implementation("tech.fuzio:fuzio-win64-arm:${fuzioVersion}")       // Windows 64-bit ARM
    implementation("tech.fuzio:fuzio-mac:${fuzioVersion}")             // Mac Intel
    implementation("tech.fuzio:fuzio-mac-arm:${fuzioVersion}")         // Mac Apple silicon
    implementation("tech.fuzio:fuzio-linux64:${fuzioVersion}")         // Linux 64-bit
    implementation("tech.fuzio:fuzio-linux64-arm:${fuzioVersion}")     // Linux 64-bit ARM
    implementation("tech.fuzio:fuzio-linux64-loong:${fuzioVersion}")   // Linux 64-bit Loong
}
dependencies {
    implementation 'tech.fuzio:fuzio-win32:' + fuzioVersion             // Windows 32-bit
    implementation 'tech.fuzio:fuzio-win64:' + fuzioVersion             // Windows 64-bit
    implementation 'tech.fuzio:fuzio-win64-arm:' + fuzioVersion         // Windows 64-bit ARM
    implementation 'tech.fuzio:fuzio-mac:' + fuzioVersion               // Mac Intel
    implementation 'tech.fuzio:fuzio-mac-arm:' + fuzioVersion           // Mac Apple silicon
    implementation 'tech.fuzio:fuzio-linux64:' + fuzioVersion           // Linux 64-bit
    implementation 'tech.fuzio:fuzio-linux64-arm:' + fuzioVersion       // Linux 64-bit ARM
    implementation 'tech.fuzio:fuzio-linux64-loong:' + fuzioVersion     // Linux 64-bit Loong
}

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

GUI 工具包

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

Kotlin
Groovy
dependencies {
    implementation("tech.fuzio:fuzio-swing:${fuzioVersion}")
    implementation("tech.fuzio:fuzio-javafx:${fuzioVersion}")
    implementation("tech.fuzio:fuzio-swt:${fuzioVersion}")
    implementation("tech.fuzio:fuzio-compose:${fuzioVersion}")
}
dependencies {
    implementation 'tech.fuzio:fuzio-swing:' + fuzioVersion
    implementation 'tech.fuzio:fuzio-javafx:' + fuzioVersion
    implementation 'tech.fuzio:fuzio-swt:' + fuzioVersion
    implementation 'tech.fuzio:fuzio-compose:' + fuzioVersion
}

Kotlin DSL

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

Kotlin
Groovy
dependencies {
    implementation("tech.fuzio:fuzio-kotlin:${fuzioVersion}")
}
dependencies {
    implementation 'tech.fuzio:fuzio-kotlin:' + fuzioVersion
}

总结

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

Kotlin
Groovy
import tech.fuzio.gradle.Repository

plugins {
    java
}

val fuzioVersion = "2026.1.0"

repositories {
    // 使用原始 Fuzio 仓库。
    maven("https://jiku.mycloudrepo.io/public/repositories/releases")

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

dependencies {
    implementation("tech.fuzio:fuzio-win32:${fuzioVersion}")           // Windows 32-bit
    implementation("tech.fuzio:fuzio-win64:${fuzioVersion}")           // Windows 64-bit
    implementation("tech.fuzio:fuzio-win64-arm:${fuzioVersion}")       // Windows 64-bit ARM
    implementation("tech.fuzio:fuzio-mac:${fuzioVersion}")             // Mac Intel
    implementation("tech.fuzio:fuzio-mac-arm:${fuzioVersion}")         // Mac Apple silicon
    implementation("tech.fuzio:fuzio-linux64:${fuzioVersion}")         // Linux 64-bit
    implementation("tech.fuzio:fuzio-linux64-arm:${fuzioVersion}")     // Linux 64-bit ARM
    implementation("tech.fuzio:fuzio-linux64-loong:${fuzioVersion}")   // Linux 64-bit Loong

    // 添加 UI 工具包集成的依赖项。
    implementation("tech.fuzio:fuzio-swing:${fuzioVersion}")
    implementation("tech.fuzio:fuzio-javafx:${fuzioVersion}")
    implementation("tech.fuzio:fuzio-swt:${fuzioVersion}")
    implementation("tech.fuzio:fuzio-compose:${fuzioVersion}")

    // 添加 Fuzio Kotlin DSL 的依赖。
    implementation("tech.fuzio:fuzio-kotlin:${fuzioVersion}")
}
import tech.fuzio.gradle.Repository

plugins {
    java
}

fuzioVersion = '2026.1.0'

repositories {
    maven {
        // 使用原始 Fuzio 仓库。
        url = 'https://jiku.mycloudrepo.io/public/repositories/releases'
        // 或者，也可以像下面这样通过 URL 指向自定义仓库：
        // url = 'https://my.custom.repository'
    }
}

dependencies {
    implementation 'tech.fuzio:fuzio-win32:' + fuzioVersion            // Windows 32-bit
    implementation 'tech.fuzio:fuzio-win64:' + fuzioVersion            // Windows 64-bit
    implementation 'tech.fuzio:fuzio-win64-arm:' + fuzioVersion        // Windows 64-bit ARM
    implementation 'tech.fuzio:fuzio-mac:' + fuzioVersion              // Mac Intel
    implementation 'tech.fuzio:fuzio-mac-arm:' + fuzioVersion          // Mac Apple silicon
    implementation 'tech.fuzio:fuzio-linux64:' + fuzioVersion          // Linux 64-bit
    implementation 'tech.fuzio:fuzio-linux64-arm:' + fuzioVersion      // Linux 64-bit ARM
    implementation 'tech.fuzio:fuzio-linux64-loong:' + fuzioVersion    // Linux 64-bit Loong

    // 添加 UI 工具包集成的依赖项。
    implementation 'tech.fuzio:fuzio-swing:' + fuzioVersion
    implementation 'tech.fuzio:fuzio-javafx:' + fuzioVersion
    implementation 'tech.fuzio:fuzio-swt:' + fuzioVersion
    implementation 'tech.fuzio:fuzio-compose:' + fuzioVersion

    // 添加 Fuzio Kotlin DSL 的依赖项。
    implementation 'tech.fuzio:fuzio-kotlin:' + fuzioVersion
}

无头模式

Maven