Selenium - 环境搭建

要开始开发 Selenium WebDriver 脚本，你需要搭建你的开发环境。这通常包括安装 Java、一个 IDE（集成开发环境）、一个构建工具，以及配置 Selenium 库和浏览器驱动。

本指南重点介绍基于 Java 和 Maven 的典型环境搭建过程。

步骤 1：安装 Java Development Kit (JDK)

Selenium 需要 Java 运行（特别是 JDK，而不仅仅是 JRE）。确保你安装了 JDK 8 或更高版本（如果需要，请查阅 Selenium 文档以获取特定版本兼容性信息）。

**下载：**从 Oracle (https://www.oracle.com/java/technologies/downloads/) 获取 JDK，或者选择一个 OpenJDK 分发版，例如 Adoptium Temurin (https://adoptium.net/)。
**安装：**按照你的操作系统相应的安装说明进行安装。
配置环境变量（至关重要）：
- 设置 JAVA_HOME 环境变量指向你的 JDK 安装目录。
- 将 JDK 的 bin 目录添加到系统的 PATH 环境变量中。
**验证安装：**打开新的终端或命令提示符，输入 java -version 和 javac -version。这两个命令都应该执行并显示已安装的 JDK 版本。

步骤 2：安装集成开发环境 (IDE)

IDE 提供了编写、运行和调试代码的工具。

**推荐的 IDE：**IntelliJ IDEA Community/Ultimate (https://www.jetbrains.com/idea/) 或 Eclipse IDE for Java Developers (https://www.eclipse.org/downloads/)。
**安装：**从相应的网站下载安装程序，并按照安装说明进行操作。

步骤 3：安装构建自动化工具 (Maven)

Maven 或 Gradle 等构建工具简化了项目设置、依赖管理以及构建/运行测试的过程。

**Maven：**通常与 IntelliJ IDEA 和 Eclipse 捆绑在一起。如果没有，请从 https://maven.apache.org/download.cgi 下载。
**安装：**按照 Maven 的安装指南进行操作，通常包括设置 M2_HOME 并将其 bin 目录添加到 PATH 中。
**验证安装：**打开新的终端并输入 mvn -version。它应该显示已安装的 Maven 版本。

步骤 4：创建 Maven 项目

使用你的 IDE 创建一个新的 Maven 项目。这将建立标准的项目结构（src/main/java, src/test/java, pom.xml）。

IntelliJ： File -> New -> Project... -> 选择 Maven -> 选择 JDK -> 提供 GroupId（例如 com.mycompany）和 ArtifactId（例如 selenium-tests）。
Eclipse： File -> New -> Maven Project -> 勾选 ‘Create a simple project’ -> 提供 GroupId 和 ArtifactId。

步骤 5：添加 Selenium 依赖项 (pom.xml)

打开位于项目根目录下的 pom.xml 文件。在 <dependencies> 部分中添加必要的依赖项。这将告诉 Maven 自动下载所需的 JAR 文件。

<project ...>
    <properties>
        <maven.compiler.source>11</maven.compiler.source> <!-- Set your Java version -->
        <maven.compiler.target>11</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- Selenium Java -->
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>4.10.0</version> <!-- Use the latest stable version -->
        </dependency>

        <!-- TestNG (or JUnit if you prefer) -->
        <dependency>
            <groupId>org.testng</groupId>
            <artifactId>testng</artifactId>
            <version>7.7.1</version> <!-- Use the latest stable version -->
            <scope>test</scope> <!-- Only needed for testing -->
        </dependency>

        <!-- WebDriverManager (Highly Recommended) -->
        <dependency>
            <groupId>io.github.bonigarcia</groupId>
            <artifactId>webdrivermanager</artifactId>
            <version>5.3.3</version> <!-- Use the latest stable version -->
            <scope>test</scope>
        </dependency>

        <!-- Optional: For logging (SLF4j API + Logback Implementation) -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>2.0.7</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.4.7</version>
            <scope>test</scope>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <!-- Maven Surefire Plugin to run tests -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.1.2</version>
                <configuration>
                    <!-- Configuration for TestNG (if using TestNG XML) -->
                    <!--
                    <suiteXmlFiles>
                        <suiteXmlFile>testng.xml</suiteXmlFile>
                    </suiteXmlFiles>
                     -->
                </configuration>
            </plugin>
            <!-- Maven Compiler Plugin -->
             <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
             </plugin>
        </plugins>
    </build>
</project>

添加依赖项后，在 IDE 中刷新你的 Maven 项目（IntelliJ 中选择 Maven -> Reload Project，或 Eclipse 中右键点击项目 -> Maven -> Update Project）以下载 JAR 文件。

步骤 6：浏览器驱动 (由 WebDriverManager 管理)

以前，你必须手动下载浏览器驱动可执行文件（如 chromedriver.exe, geckodriver.exe）并管理它们的路径。这既繁琐又容易出错。

上面作为依赖项添加的 WebDriverManager 自动化了这个过程。只需在你的测试设置代码中调用 WebDriverManager.chromedriver().setup(); 或 WebDriverManager.firefoxdriver().setup();，它就会自动下载与你机器上安装的浏览器相匹配的驱动版本，并配置必要的系统属性。

步骤 7：使用浏览器开发者工具 (取代 Firebug/FirePath)

Firebug 和 FirePath 等工具已被弃用。要检查网页元素并查找定位器（IDs, CSS Selectors, XPath）：

**打开开发者工具：**右键点击网页元素并选择“检查”或“检查元素”，或直接按 F12。
**检查元素：**使用元素选择工具（通常是一个箭头图标）点击页面上的元素。HTML 结构将在“Elements”（Chrome/Edge）或“Inspector”（Firefox）面板中高亮显示。
**查找定位器：**查看元素的属性（id, name, class）。在 HTML 视图中右键点击元素，复制其 CSS Selector 或 XPath（尽管手动编写 Selector/XPath 通常更稳定）。

你的环境现在已经准备好了！你可以开始在 Maven 项目的 src/test/java 目录中编写 Selenium WebDriver 测试了。