JxBrowser 在 Swing 中的使用
在 Swing Maven 项目中使用 JxBrowser 的最简单方法是克隆 GitHub 仓库,其中所有内容都已设置完毕,可以直接使用。
前提条件
- Git。
- Java 17 或更高版本。
- JxBrowser 许可证密钥,或免费 30 天试用密钥。
获取项目
使用以下命令克隆 GitHub 仓库:
git clone https://github.com/TeamDev-IP/JxBrowser-QuickStart-Maven-Swing.git
cd JxBrowser-QuickStart-Maven-Swing
运行 Swing 应用程序
使用以下命令构建并运行 Swing 应用程序:
mvn clean compile exec:java -Djxbrowser.license.key=<your_license_key>
启动后,您将看到一个包含 BrowserView
组件的 Swing 应用程序,展示的网页为 https://html5test.teamdev.com:
项目概述
本节将介绍如何配置 Maven 项目以包含 JxBrowser,以及如何将 JxBrowser BrowserView
组件嵌入到 Swing 框架中以显示已加载的网页内容。
配置 Maven 项目
该 Maven 项目配置为使用 JxBrowser Maven 仓库来获取所有平台所需的 JxBrowser 依赖项和 Chromium 二进制文件。
以下是 pom.xml
文件的配置方式:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.teamdev.jxbrowser.quickstart.maven</groupId>
<artifactId>swing</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<!-- 使用最新稳定的 JxBrowser 版本。 -->
<jxbrowser.version>8.3.0</jxbrowser.version>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<!-- 定义 Java 应用程序的主类。 -->
<exec.mainClass>com.teamdev.jxbrowser.quickstart.maven.swing.App</exec.mainClass>
</properties>
<repositories>
<!-- 为 JxBrowser 配置 Maven 仓库。 -->
<repository>
<id>com.teamdev</id>
<url>https://europe-maven.pkg.dev/jxbrowser/releases</url>
</repository>
</repositories>
<dependencies>
<!-- 获取所有平台的 Chromium 二进制文件。 -->
<dependency>
<groupId>com.teamdev.jxbrowser</groupId>
<artifactId>jxbrowser-cross-platform</artifactId>
<version>${jxbrowser.version}</version>
<type>pom</type>
</dependency>
<!-- 添加 Swing UI 工具包集成的依赖项。 -->
<dependency>
<groupId>com.teamdev.jxbrowser</groupId>
<artifactId>jxbrowser-swing</artifactId>
<version>${jxbrowser.version}</version>
</dependency>
</dependencies>
</project>
将 JxBrowser 嵌入 Swing
在 Swing 应用程序源代码 中,您可以看到如何:
- 初始化 Engine(Chromium 实例)。
- 创建 Browser 实例。
- 加载所需的网页。
- 将
BrowserView
组件嵌入 Swing 框架以显示已加载的网页。
import static com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED;
import static javax.swing.SwingUtilities.invokeLater;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.view.swing.BrowserView;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import javax.swing.JFrame;
public final class App {
public static void main(String[] args) {
// 初始化 Chromium。
var engine = Engine.newInstance(HARDWARE_ACCELERATED);
// 创建 Browser 实例。
var browser = engine.newBrowser();
invokeLater(() -> {
var frame = new JFrame("JxBrowser Swing");
frame.addWindowListener(new WindowAdapter() {
@Override
public void windowClosing(WindowEvent e) {
// 关闭 Chromium 并释放分配的资源。
engine.close();
}
});
// 创建并嵌入 Swing BrowserView 组件以显示 Web 内容。
frame.add(BrowserView.newInstance(browser));
frame.setSize(1280, 800);
frame.setLocationRelativeTo(null);
frame.setVisible(true);
// 加载所需的网页。
browser.navigation().loadUrl("https://html5test.teamdev.com/");
});
}
}
了解更多
- 详细了解如何添加 JxBrowser 到您的 Maven 项目中。
- 阅读关于如何将 JxBrowser 嵌入 Swing 应用。
- 查阅我们的指南,探索 JxBrowser 的所有功能。