教程

集成

日志记录

日志重定向

Chromium 功能

语音识别

配置 Selenium WebDriver

本教程展示了如何创建一个简单的 Selenium WebDriver 应用程序，该应用程序被配置为使用 JxBrowser 访问在桌面 Java 应用程序中加载的网页。

本教程只适用于 Windows 操作系统。

前提条件

为完成本教程，我们需要：

Git。
Java 17 或更高版本。
一个有效的 JxBrowser 许可证。它可以是评估版或商业版。关于许可证的更多信息，请参见许可证指南。
下载了用于 Selenium 的 ChromeDriver。由于 JxBrowser 是基于 Chromium Engine 的，我们不能使用其他 Web 驱动程序（例如，Firefox WebDriver)。在本教程中使用的是 ChromeDriver 88.0.4324.96。

获取代码

要查看本教程中创建的完整应用程序，请查看我们的示例集合：

$ git clone https://github.com/TeamDev-IP/JxBrowser-Examples
$ cd JxBrowser-Examples/tutorials/selenium

JxBrowser 应用程序

创建应用程序

创建一个简单的 JxBrowser 应用程序。

添加许可证

要继续，请将许可证密钥添加到应用程序中。

配置 Chromium Engine

当 Selenium 启动我们的应用程序时，ChromeDriver 会将 --remote-debugging-port=<port> 参数传递给命令行参数。

在我们的应用程序中，我们首先从命令行参数中获取 --remote-debugging-port 参数：

private static Optional<Integer> remoteDebuggingPortFromCommandLine(String[] args) {
    if (args.length > 0) {
        for (String arg : args) {
            if (arg.startsWith(REMOTE_DEBUGGING_PORT_ARG)) {
                String port = arg.substring(REMOTE_DEBUGGING_PORT_ARG.length());
                return Optional.of(Integer.parseInt(port));
            }
        }
    }
    return Optional.empty();
}

然后将其传递给由 JxBrowser 启动的 Chromium Engine：

// 为 EngineOptions 创建一个构建器。
EngineOptions.Builder builder = EngineOptions.newBuilder(HARDWARE_ACCELERATED);

// 使用从命令行参数中获取的远程调试端口配置 Engine。
remoteDebuggingPortFromCommandLine(args).ifPresent(builder::remoteDebuggingPort);

现在我们可以创建一个 Browser 实例并加载一个网页，Selenium WebDriver 将通过 ChromeDriver 检测到它并与之交互。

import static com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED;

import com.teamdev.jxbrowser.browser.Browser;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.engine.EngineOptions;
import com.teamdev.jxbrowser.view.swing.BrowserView;
import java.awt.BorderLayout;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.util.Optional;
import javax.swing.JFrame;
import javax.swing.SwingUtilities;
import javax.swing.WindowConstants;

/**
 * 这个示例展示了如何创建一个简单的 Swing 应用程序，其中包含一个
 * 加载在 BrowserView 中的网页，并通过从命令行获取的远程调试端口
 * 将 JxBrowser 的 Chromium Engine 与 Selenium 连接起来。
 */
public final class TargetApp {

    private static final String REMOTE_DEBUGGING_PORT_ARG = "--remote-debugging-port=";

    public static void main(String[] args) {
        // 设置您的 JxBrowser 许可证密钥。
        System.setProperty("jxbrowser.license.key", "your_license_key");

        // 为 EngineOptions 创建一个构建器。
        EngineOptions.Builder builder = EngineOptions.newBuilder(HARDWARE_ACCELERATED);

        // 使用从命令行参数中获取的远程调试端口来配置 Engine。
        remoteDebuggingPortFromCommandLine(args).ifPresent(builder::remoteDebuggingPort);

        // 创建 Chromium Engine。
        Engine engine = Engine.newInstance(builder.build());
        Browser browser = engine.newBrowser();

        SwingUtilities.invokeLater(() -> {
            // 创建 Swing 组件来渲染给定 Browser 实例中加载的 Web 内容。
            BrowserView view = BrowserView.newInstance(browser);

            // 创建并显示 Swing 应用程序 Frame。
            JFrame frame = new JFrame();
            frame.addWindowListener(new WindowAdapter() {
                @Override
                public void windowClosing(WindowEvent e) {
                    engine.close();
                }
            });
            frame.setDefaultCloseOperation(WindowConstants.DISPOSE_ON_CLOSE);
            frame.add(view, BorderLayout.CENTER);
            frame.setSize(800, 700);
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);

            browser.navigation().loadUrl("https://google.com");
        });
    }

    private static Optional<Integer> remoteDebuggingPortFromCommandLine(String[] args) {
        if (args.length > 0) {
            for (String arg : args) {
                if (arg.startsWith(REMOTE_DEBUGGING_PORT_ARG)) {
                    String port = arg.substring(REMOTE_DEBUGGING_PORT_ARG.length());
                    return Optional.of(Integer.parseInt(port));
                }
            }
        }
        return Optional.empty();
    }
}

查看完整的应用程序。

创建可执行文件

要创建我们程序的可执行文件，可以使用 launch4j Gradle 插件，或以您方便的任何方式手动创建。

Selenium 应用程序

安装 Selenium 依赖项

创建一个独立的项目并安装依赖项以使用 ChromeDriver 运行 Selenium 测试。