<!-- pom.xml -->
<!-- 公眾號(hào)：測(cè)試工程師成長之路 -->
<properties>
    <serenity.version>4.0.0</serenity.version> <!-- 2026 年初最新穩(wěn)定版 -->
    <serenity.cucumber.version>4.0.0</serenity.cucumber.version>
    <junit.jupiter.version>5.10.1</junit.jupiter.version>
</properties>
<dependencies>
    <!-- Serenity 核心 -->
    <dependency>
        <groupId>net.serenity-bdd</groupId>
        <artifactId>serenity-core</artifactId>
        <version>${serenity.version}</version>
    </dependency>
    <!-- Cucumber BDD 支持 -->
    <dependency>
        <groupId>net.serenity-bdd</groupId>
        <artifactId>serenity-cucumber</artifactId>
        <version>${serenity.cucumber.version}</version>
    </dependency>
    <!-- JUnit 5 支持 -->
    <dependency>
        <groupId>net.serenity-bdd</groupId>
        <artifactId>serenity-junit5</artifactId>
        <version>${serenity.version}</version>
    </dependency>
    <!-- Selenium（由 Serenity 管理版本） -->
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>4.18.1</version> <!-- 兼容 Serenity 4.x -->
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>net.serenity-bdd.maven.plugins</groupId>
            <artifactId>serenity-maven-plugin</artifactId>
            <version>${serenity.version}</version>
            <executions>
                <execution>
                    <id>serenity-reports</id>
                    <phase>post-integration-test</phase>
                    <goals><goal>aggregate</goal></goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

src/test/java
├── features/          # Cucumber .feature 文件（BDD 場(chǎng)景）
├── pages/             # 頁面對(duì)象類（繼承 PageObject）
├── steps/             # 步驟庫（帶 @Steps 注解的類）
├── tasks/             # Screenplay 模式任務(wù)（高級(jí)用法）
├── runners/           # 測(cè)試運(yùn)行器（@CucumberOptions 或 @ExtendWith）
└── hooks/             # 全局鉤子（Before/After）
src/test/resources
├── serenity.conf      # 核心配置（瀏覽器、超時(shí)、基礎(chǔ) URL）
└── environment/       # 環(huán)境專屬配置（dev/staging/prod）

@DefaultUrl("https://app.example.com/login")
public class LoginPage extends PageObject {
    @FindBy(id = "username") WebElementFacade usernameField;
    @FindBy(id = "password") WebElementFacade passwordField;
    @FindBy(css = "button[type='submit']") WebElementFacade loginBtn;
    public void enterCredentials(String user, String pwd) {
        usernameField.type(user);
        passwordField.typeAndEnter(pwd); // 自動(dòng)提交
    }
    // 智能等待示例
    public boolean isErrorMessageVisible() {
        return $("#error-alert").isCurrentlyVisible();
    }
}

public class Login implements Task {
    private final String username, password;
    public static Login as(String user, String pwd) {
        return Tasks.instrumented(Login.class, user, pwd);
    }
    @Override
    public <T extends Actor> void performAs(T actor) {
        actor.attemptsTo(
            Enter.theValue(username).into("#username"),
            Enter.theValue(password).into("#password").thenHit(Keys.ENTER),
            WaitUntil.the(LoginPage.SUCCESS_MESSAGE, isVisible()).forNoMoreThan(10).seconds()
        );
    }
}

webdriver {
  driver = chrome
  chrome {
    arguments = ["--headless=new", "--disable-gpu", "--no-sandbox"]
  }
}
serenity {
  take.screenshots = FOR_FAILURES
  requirements.dir = "src/test/resources/features"
  output.directory = "target/site/serenity"
}
environments {
  default {
    base.url = "https://staging.example.com"
  }
  prod {
    base.url = "https://app.example.com"
  }
}