文档

Version:
8.4.0 7.42.1
List icon 目录
Close
Gradle
Maven

JxBrowser 在 SWT 中的使用

在 SWT Gradle 项目中使用 JxBrowser 的最简单方法是克隆 GitHub 仓库，其中所有内容都已设置完毕，可以直接使用。

前提条件

获取项目

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

git clone https://github.com/TeamDev-IP/JxBrowser-QuickStart-Gradle-SWT.git
cd JxBrowser-QuickStart-Gradle-SWT

运行 SWT 应用程序

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

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

启动后，您将看到一个包含 BrowserView 组件的 SWT 应用程序，展示的网页为 https://html5test.teamdev.com：

SWT 应用中的 BrowserView

项目概述

本节将介绍如何配置 Gradle 项目以包含 JxBrowser，以及如何将 JxBrowser 的 BrowserView 组件嵌入到 SWT shell 中以显示已加载网页的内容。

配置 Gradle 项目

Gradle 项目使用 JxBrowser Gradle 插件来添加所需的 JxBrowser 依赖项、获取当前平台的 Chromium 二进制文件，并添加平台特定的 SWT 依赖项。

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

Kotlin
import org.apache.tools.ant.taskdefs.condition.Os
import org.apache.tools.ant.taskdefs.condition.Os.FAMILY_MAC

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

    // 允许添加 JxBrowser 依赖项。
    id("com.teamdev.jxbrowser") version "1.2.1"
}

repositories {
    mavenCentral()
}

jxbrowser {
    // 使用最新稳定的 JxBrowser 版本。
    version = "8.4.0"
}

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

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

    // 添加对 JxBrowser Kotlin DSL 的依赖项。
    implementation(jxbrowser.kotlin)

    // 添加平台特定的 SWT 依赖项。
    implementation(Swt.toolkitDependency)
}

Swt.configurePlatformDependency(project)

application {
    // 定义应用程序的主类。
    mainClass.set("com.teamdev.jxbrowser.quickstart.gradle.swt.App")

    // 定义 Kotlin 应用程序的主类。
    // mainClass.set("com.teamdev.jxbrowser.quickstart.gradle.swt.AppKt")
}

tasks.withType<JavaExec> {
    if (Os.isFamily(FAMILY_MAC)) {
        jvmArgs(
            // 对于 macOS，可以在 Cocoa 下运行 SWT。
            "-XstartOnFirstThread"
        )
    }

    // 将命令行中的所有 Java 系统属性分配给 JavaExec 任务以传递 JxBrowser 许可证密钥。
    systemProperties(System.getProperties().mapKeys { it.key as String })
}

将 JxBrowser 嵌入 SWT

该项目包含两个 SWT 应用程序实现：Java 和 Kotlin。

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

  1. 初始化 Engine（Chromium）实例。
  2. 创建 Browser 实例。
  3. 加载所需的网页。
  4. 将 BrowserView 组件嵌入到 SWT shell 以显示已加载的网页。
Java
Kotlin
import static com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED;

import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.view.swt.BrowserView;
import org.eclipse.swt.layout.FillLayout;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Shell;

public final class App {

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

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

        // 加载所需的网页。
        browser.navigation().loadUrl("https://html5test.teamdev.com");

        var display = new Display();
        var shell = new Shell(display);
        shell.setText("JxBrowser SWT");
        shell.setLayout(new FillLayout());

        // 创建并嵌入 SWT BrowserView 组件以显示 Web 内容。
        var view = BrowserView.newInstance(shell, browser);
        view.setSize(1280, 800);

        shell.pack();
        shell.open();

        while (!shell.isDisposed()) {
            if (!display.readAndDispatch()) {
                display.sleep();
            }
        }
        // 关闭 Chromium 并释放已分配的资源。
        engine.close();

        display.dispose();
    }
}

import com.teamdev.jxbrowser.dsl.Engine
import com.teamdev.jxbrowser.dsl.JxBrowserLicense
import com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED
import com.teamdev.jxbrowser.view.swt.BrowserView
import org.eclipse.swt.layout.FillLayout
import org.eclipse.swt.widgets.Display
import org.eclipse.swt.widgets.Shell

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

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

    // 加载所需的网页。
    browser.navigation().loadUrl("https://html5test.teamdev.com")

    val display = Display()
    val shell = Shell(display)
    shell.text = "JxBrowser SWT"
    shell.layout = FillLayout()

    // 创建并嵌入 SWT BrowserView 组件以显示 Web 内容。
    val view = BrowserView.newInstance(shell, browser)
    view.setSize(1280, 800)

    shell.pack()
    shell.open()

    while (!shell.isDisposed) {
        if (!display.readAndDispatch()) {
            display.sleep()
        }
    }
    // 关闭 Chromium 并释放已分配的资源。
    engine.close()

    display.dispose()
}

了解更多

查看代码