文档

Version:
8.2.0 7.41.4
List icon 目录
Close
介绍
安装

配置 Gradle 项目

本页介绍如何将 JxBrowser 添加到 Gradle 项目中。

要将 JxBrowser 添加到 Gradle 项目中，您必须在构建脚本文件 build.gradle(.kts) 中添加 JxBrowser Gradle 插件，并在那里配置项目的依赖项。

应用插件

要应用 JxBrowser Gradle 插件，请使用 Gradle DSL 中的 plugins 块：

Kotlin
Groovy
plugins {
    id("com.teamdev.jxbrowser") version "1.2.1"
}

plugins {
    id 'com.teamdev.jxbrowser' version '1.2.1'
}

配置插件

应用了插件后，可以通过 build.gradle(.kts) 文件中的 jxbrowser 扩展来配置该插件。

版本

使用 version 属性设置所需的库版本：

Kotlin
Groovy
jxbrowser {
    version = "8.2.0"
}

jxbrowser {
    version '8.2.0'
}

version 属性是强制性的，省略它将导致 IllegalStateException。

存储库

您可以指定要使用的 JxBrowser 存储库的位置，可以是北美或欧洲：

Kotlin
Groovy
jxbrowser {
    version = "8.2.0"
    repository = Repository.EUROPE
}

jxbrowser {
    version '8.2.0'
    repository Repository.EUROPE
}

您也可以通过其 URL 指定自定义存储库，如下所示：

Kotlin
Groovy
jxbrowser {
    version = "8.2.0"
    repository = "https://my.custom.repository"
}

jxbrowser {
    version '8.2.0'
    repository 'https://my.custom.repository'
}

如果未指定 repository 属性，则位置将设置为北美。

依赖项

跨平台

要添加适用于 Windows、macOS 和 Linux 的 JxBrowser 库，请添加以下代码：

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.crossPlatform)
}

dependencies {
    implementation jxbrowser.crossPlatform
}

特定平台

如果您只需要特定平台的 JxBrowser JAR 文件，您可以使用如下所述的适当依赖项。

如果您的 Java 应用程序仅在 Windows 和 macOS 平台上运行，并且您不需要 Linux 依赖项，则可以只包含 Windows 和 macOS 依赖项。

Windows 32-bit

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.win32)
}

dependencies {
    implementation jxbrowser.win32
}

Windows 64-bit

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.win64)
}

dependencies {
    implementation jxbrowser.win64
}

Windows 64-bit ARM

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.winArm)
}

dependencies {
    implementation jxbrowser.winArm
}

macOS 64-bit

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.mac)
}

dependencies {
    implementation jxbrowser.mac
}

macOS 64-bit ARM

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.macArm)
}

dependencies {
    implementation jxbrowser.macArm
}

Linux 64-bit

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.linux64)
}

dependencies {
    implementation jxbrowser.linux64
}

Linux 64-bit ARM

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.linuxArm)
}

dependencies {
    implementation jxbrowser.linuxArm
}

当前平台

要检测当前平台并添加相应的 Chromium 二进制文件，请使用以下依赖项：

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.currentPlatform)
}

dependencies {
    implementation jxbrowser.currentPlatform
}

GUI 工具箱

Compose Desktop

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.compose)
}

dependencies {
    implementation jxbrowser.compose
}

Swing

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.swing)
}

dependencies {
    implementation jxbrowser.swing
}

JavaFX

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.javafx)
}

dependencies {
    implementation jxbrowser.javafx
}

SWT

Kotlin
Groovy
dependencies {
    implementation(jxbrowser.swt)
}

dependencies {
    implementation jxbrowser.swt
}

总结

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

Kotlin
Groovy
import com.teamdev.jxbrowser.gradle.Repository

plugins {
    java
    id("com.teamdev.jxbrowser") version "1.2.1"
}

jxbrowser {
    // JxBrowser 版本。必填字段。
    version = "8.2.0"

    // 要使用的 JxBrowser 存储库位置。 要么是北美，要么是欧洲。
    // 如果未指定，位置将设置为北美。
    repository = Repository.NORTH_AMERICA

    // 或者，它可以通过其 URL 指向自定义存储库，如下所示：
    // repository "https://my.custom.repository"
}

dependencies {
    // 添加对核心 JxBrowser API 的依赖项。
    implementation(jxbrowser.core)

    // 为所有支持的平台添加对 Chromium 二进制文件的依赖项。
    implementation(jxbrowser.crossPlatform)

    // 添加对特定平台的 Chromium 二进制文件的依赖项。
    implementation(jxbrowser.mac)
    implementation(jxbrowser.macArm)
    implementation(jxbrowser.win32)
    implementation(jxbrowser.win64)
    implementation(jxbrowser.winArm)
    implementation(jxbrowser.linux64)
    implementation(jxbrowser.linuxArm)

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

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

import com.teamdev.jxbrowser.gradle.Repository

plugins {
    id 'java'
    id 'com.teamdev.jxbrowser' version '1.2.1'
}

jxbrowser {
    // JxBrowser 版本。必填字段。
    version '8.2.0'

    // 要使用的 JxBrowser 存储库位置。 要么是北美，要么是欧洲。
    // 如果未指定，位置将设置为北美。
    repository Repository.NORTH_AMERICA

    // 或者，它可以通过其 URL 指向自定义存储库，如下所示：
    // repository = "https://my.custom.repository"

    // 将包含 JxBrowser 8 EAP 版本的存储库添加到项目。
    includePreviewBuilds()
}

dependencies {
    // 添加对核心 JxBrowser API 的依赖项。
    implementation jxbrowser.core

    // 为所有支持的平台添加对 Chromium 二进制文件的依赖项。
    implementation jxbrowser.crossPlatform

    // 添加对特定平台的 Chromium 二进制文件的依赖项。
    implementation jxbrowser.mac
    implementation jxbrowser.macArm
    implementation jxbrowser.win32
    implementation jxbrowser.win64
    implementation jxbrowser.winArm
    implementation jxbrowser.linux64
    implementation jxbrowser.linuxArm

    // 检测当前平台并添加相应的 Chromium 二进制文件。
    implementation jxbrowser.currentPlatform
    
    // 添加对 UI 工具包集成的依赖项。
    implementation jxbrowser.swt
    implementation jxbrowser.swing
    implementation jxbrowser.javafx
    implementation jxbrowser.compose
}