Add Cucumber step definitions for Percy visual testing

[neha-sanse]

Summary

• Add PercySteps class in io.percy.appium.cucumber package with Gherkin step definitions for Percy Screenshot with Appium
• Add setClientInfo/setEnvironmentInfo to Percy and Environment for framework wrapper identification
• Expose CliWrapper.getEnvironment() for client info override
• Cucumber dependency is provided scope -- users bring their own version

Cucumber Steps

Screenshot

When I take a Percy screenshot named "Homepage"
When I take a Percy screenshot named "Full Page" with full page
When I take a Percy screenshot named "With Options" with options

Ignore/Consider Regions

Given I add ignore region XPath "//android.widget.Button[@text='AD']"
Given I add ignore region accessibility ID "ad-banner"
Given I add consider region XPath "//android.widget.LinearLayout[@content-desc='main']"

Device Config

Given I set device name "Samsung Galaxy S22"
Given I set orientation "portrait"
Given I set status bar height 50
Given I set full page to "true"
Given I set labels "smoke,regression"
Given I set test case "TC-001"

Setup

@Before
public void setUp() {
    AppiumDriver driver = new AndroidDriver(url, caps);
    PercySteps.setDriver(driver);  // auto-sets cucumber env info
}

@After
public void tearDown() {
    PercySteps.reset();
}

Test plan

• Unit tests pass
• Compile with Cucumber 7.x provided dependency
• Verify steps work in a Cucumber feature file with Percy exec
• Build info shows percy-cucumber-java-appium/<version> and cucumber-java/<version>; appium-java

🤖 Generated with Claude Code