List icon Conteúdo

Configurando o Projeto Gradle

Esta página descreve como adicionar o JxBrowser a um projeto Gradle.

Para adicionar o JxBrowser a um projeto Gradle, você deve incluir o plugin JxBrowser Gradle no seu arquivo de script de construção build.gradle(.kts) e configurar o projeto dependências lá.

Aplicando o plug-in

Para aplicar o plugin JxBrowser Gradle, use o bloco plugins do Gradle DSL:

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

Configurando o plug-in

Uma vez aplicado, o plugin pode ser configurado através da extensão jxbrowser no arquivo build.gradle(.kts).

Versão

Defina a versão da biblioteca necessária utilizando a propriedade version:

Groovy
Kotlin
jxbrowser {
    version '8.2.0'
}
jxbrowser {
    version = "8.2.0"
}

A propriedade version é obrigatória, a sua omissão resultará numa IllegalStateException.

Repositório

Você pode especificar a localização do repositório JxBrowser a ser utilizado, que pode ser a América do Norte ou a Europa:

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

Também pode especificar um repositório personalizado através do seu URL, como se mostra abaixo:

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

Se a propriedade repository não for especificada, a localização é definida como América do Norte.

Pré-visualização de compilações

Utilize includePreviewBuilds() para adicionar ao projeto um repositório com builds de preview do JxBrowser:

Groovy
Kotlin
jxbrowser {
    version '8.2.0'
    includePreviewBuilds()
}
jxbrowser {
    version = "8.2.0"
    includePreviewBuilds()
}

Dependências

Multiplataforma

Para adicionar a biblioteca JxBrowser que funciona no Windows, macOS e Linux, adicione o seguinte código:

Groovy
Kotlin
dependencies {
    implementation jxbrowser.crossPlatform
}
dependencies {
    implementation(jxbrowser.crossPlatform)
}

Específico da plataforma

Se precisar de arquivos JAR do JxBrowser apenas para uma plataforma específica, pode utilizar a dependência adequada, conforme descrito abaixo.

Se a sua aplicação Java for executada apenas nas plataformas Windows e macOS e não necessitar da dependência do Linux, você pode incluir apenas as dependências do Windows e do macOS.

Windows 32-bit

Groovy
Kotlin
dependencies {
    implementation jxbrowser.win32
}
dependencies {
    implementation(jxbrowser.win32)
}

Windows 64-bit

Groovy
Kotlin
dependencies {
    implementation jxbrowser.win64
}
dependencies {
    implementation(jxbrowser.win64)
}

Windows 64-bit ARM

Groovy
Kotlin
dependencies {
    implementation jxbrowser.winArm
}
dependencies {
    implementation(jxbrowser.winArm)
}

macOS 64-bit

Groovy
Kotlin
dependencies {
    implementation jxbrowser.mac
}
dependencies {
    implementation(jxbrowser.mac)
}

macOS 64-bit ARM

Groovy
Kotlin
dependencies {
    implementation jxbrowser.macArm
}
dependencies {
    implementation(jxbrowser.macArm)
}

Linux 64-bit

Groovy
Kotlin
dependencies {
    implementation jxbrowser.linux64
}
dependencies {
     implementation(jxbrowser.linux64)
}

Linux 64-bit ARM

Groovy
Kotlin
dependencies {
    implementation jxbrowser.linuxArm
}
dependencies {
    implementation(jxbrowser.linuxArm)
}

Plataforma atual

Para detectar a plataforma atual e adicionar os binários Chromium correspondentes, utilize a seguinte dependência:

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

Conjunto de ferramentas GUI

Compose Desktop

Groovy
Kotlin
dependencies {
    implementation jxbrowser.compose
}
dependencies {
    implementation(jxbrowser.compose)
}

Swing

Groovy
Kotlin
dependencies {
    implementation jxbrowser.swing
}
dependencies {
    implementation(jxbrowser.swing)
}

JavaFX

Groovy
Kotlin
dependencies {
    implementation jxbrowser.javafx
}
dependencies {
    implementation(jxbrowser.javafx)
}

SWT

Groovy
Kotlin
dependencies {
    implementation jxbrowser.swt
}
dependencies {
    implementation(jxbrowser.swt)
}

Resumo

Aqui está o código completo do build.gradle(.kts):

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

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

jxbrowser {
    // A versão do JxBrowser. Um campo obrigatório.
    version '8.2.0'

    // A localização do repositório do JxBrowser a utilizar. Pode ser na América do Norte ou na Europa.
    // Se não for especificado, a localização é definida para a América do Norte.
    repository Repository.NORTH_AMERICA

    // Alternativamente, ele pode apontar para um repositório personalizado através de sua URL, como a seguir:
    // repository "https://my.custom.repository"
}

dependencies {
    // Adiciona uma dependência ao núcleo da API do JxBrowser.
    implementation jxbrowser.core

    // Adiciona dependências aos binários do Chromium para todas as plataformas suportadas.
    implementation jxbrowser.crossPlatform

    // Adiciona uma dependência aos binários do Chromium específicos da plataforma.
    implementation jxbrowser.mac
    implementation jxbrowser.macArm
    implementation jxbrowser.win32
    implementation jxbrowser.win64
    implementation jxbrowser.winArm
    implementation jxbrowser.linux64
    implementation jxbrowser.linuxArm

    // Detecta a plataforma atual e adiciona os binários Chromium correspondentes.
    implementation jxbrowser.currentPlatform

    // Adiciona dependências às integrações do kit de ferramentas UI.
    implementation jxbrowser.swt
    implementation jxbrowser.swing
    implementation jxbrowser.javafx
    implementation jxbrowser.compose
}
import com.teamdev.jxbrowser.gradle.Repository

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

jxbrowser {
    // A versão do JxBrowser. Um campo obrigatório.
    version = "8.2.0"

    // A localização do repositório do JxBrowser a utilizar. Pode ser América do Norte ou Europa.
    // Se não for especificado, a localização é definida para a América do Norte.
    repository = Repository.NORTH_AMERICA

    // Alternativamente, ele pode apontar para um repositório personalizado através de sua URL, como segue:
    // repository = "https://my.custom.repository"
}

dependencies {
    // Adiciona uma dependência ao núcleo da API do JxBrowser.
    implementation(jxbrowser.core)

    // Adiciona dependências aos binários do Chromium para todas as plataformas suportadas.
    implementation(jxbrowser.crossPlatform)

    // Adiciona uma dependência aos binários do Chromium específicos da plataforma.
    implementation(jxbrowser.mac)
    implementation(jxbrowser.macArm)
    implementation(jxbrowser.win32)
    implementation(jxbrowser.win64)
    implementation(jxbrowser.winArm)
    implementation(jxbrowser.linux64)
    implementation(jxbrowser.linuxArm)
    
    // Detecta a plataforma atual e adiciona os binários Chromium correspondentes.
    implementation(jxbrowser.currentPlatform)
    
    // Adiciona dependências às integrações do kit de ferramentas UI.
    implementation(jxbrowser.swt)
    implementation(jxbrowser.swing)
    implementation(jxbrowser.javafx)
    implementation(jxbrowser.compose)
}