List icon 目录

JxBrowser 在 Swing 中的使用

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

前提条件

获取项目

使用以下命令克隆 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:

Swing 应用中的 BrowserView

项目概述

本节将介绍如何配置 Maven 项目以包含 JxBrowser,以及如何将 JxBrowser BrowserView 组件嵌入到 Swing 框架中以显示已加载的网页内容。

配置 Maven 项目

该 Maven 项目配置为使用 JxBrowser Maven 仓库来获取所有平台所需的 JxBrowser 依赖项和 Chromium 二进制文件。

以下是 pom.xml 文件的配置方式:

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 应用程序源代码 中,您可以看到如何:

  1. 初始化 Engine(Chromium 实例)。
  2. 创建 Browser 实例。
  3. 加载所需的网页。
  4. BrowserView 组件嵌入 Swing 框架以显示已加载的网页。
Java
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/");
        });
    }
}

了解更多