Appium для мобильной автоматизации

# Установить Appium 2.x глобально
npm install -g appium

# Установить драйверы
appium driver install uiautomator2   # Для Android
appium driver install xcuitest       # Для iOS

# Запустить сервер
appium

# Установить Appium Inspector (отдельная загрузка)
# https://github.com/appium/appium-inspector/releases

# Проверить окружение
npx appium-doctor --android   # Проверить настройку Android
npx appium-doctor --ios       # Проверить настройку iOS

// Пример на Java — Android
UiAutomator2Options options = new UiAutomator2Options()
    .setPlatformName("Android")
    .setDeviceName("Pixel_7_API_34")
    .setApp("/path/to/app.apk")
    .setAutomationName("UiAutomator2")
    .setAppPackage("com.example.myapp")
    .setAppActivity("com.example.myapp.MainActivity")
    .setNoReset(true);

AndroidDriver driver = new AndroidDriver(
    new URL("http://localhost:4723"), options
);

// Пример на Java — iOS
XCUITestOptions options = new XCUITestOptions()
    .setPlatformName("iOS")
    .setDeviceName("iPhone 15")
    .setPlatformVersion("17.0")
    .setApp("/path/to/app.ipa")
    .setAutomationName("XCUITest")
    .setBundleId("com.example.myapp");

IOSDriver driver = new IOSDriver(
    new URL("http://localhost:4723"), options
);

// По Accessibility ID (рекомендуется — кроссплатформенный)
driver.findElement(AppiumBy.accessibilityId("loginButton"));

// По ID (Android resource ID)
driver.findElement(AppiumBy.id("com.example:id/login_button"));

// По XPath (медленный, но гибкий)
driver.findElement(AppiumBy.xpath("//android.widget.Button[@text='Login']"));

// По Class Name
driver.findElement(AppiumBy.className("android.widget.EditText"));

// По Android UIAutomator селектору (только Android, мощный)
driver.findElement(AppiumBy.androidUIAutomator(
    "new UiSelector().text(\"Login\")"
));

// По iOS predicate string (только iOS)
driver.findElement(AppiumBy.iOSNsPredicateString(
    "label == 'Login' AND type == 'XCUIElementTypeButton'"
));

// Нажатие на элемент
WebElement loginBtn = driver.findElement(AppiumBy.accessibilityId("loginButton"));
loginBtn.click();

// Ввод текста
WebElement emailField = driver.findElement(AppiumBy.accessibilityId("emailInput"));
emailField.sendKeys("user@example.com");

// Очистить и ввести заново
emailField.clear();
emailField.sendKeys("new@example.com");

// Скрыть клавиатуру (Android)
driver.hideKeyboard();

// Свайп вверх (скролл вниз)
Dimension size = driver.manage().window().getSize();
int startX = size.width / 2;
int startY = (int) (size.height * 0.8);
int endY = (int) (size.height * 0.2);

PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
Sequence swipe = new Sequence(finger, 1);
swipe.addAction(finger.createPointerMove(Duration.ZERO, PointerInput.Origin.viewport(), startX, startY));
swipe.addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()));
swipe.addAction(finger.createPointerMove(Duration.ofMillis(500), PointerInput.Origin.viewport(), startX, endY));
swipe.addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
driver.perform(List.of(swipe));

// BasePage.java
public abstract class BasePage {
    protected AndroidDriver driver;
    protected WebDriverWait wait;

    public BasePage(AndroidDriver driver) {
        this.driver = driver;
        this.wait = new WebDriverWait(driver, Duration.ofSeconds(10));
    }

    protected WebElement waitForElement(By locator) {
        return wait.until(ExpectedConditions.visibilityOfElementLocated(locator));
    }
}

// LoginPage.java
public class LoginPage extends BasePage {
    private final By emailInput = AppiumBy.accessibilityId("emailInput");
    private final By passwordInput = AppiumBy.accessibilityId("passwordInput");
    private final By loginButton = AppiumBy.accessibilityId("loginButton");
    private final By errorMessage = AppiumBy.accessibilityId("errorMessage");

    public LoginPage(AndroidDriver driver) {
        super(driver);
    }

    public DashboardPage loginAs(String email, String password) {
        waitForElement(emailInput).sendKeys(email);
        waitForElement(passwordInput).sendKeys(password);
        waitForElement(loginButton).click();
        return new DashboardPage(driver);
    }

    public String getErrorMessage() {
        return waitForElement(errorMessage).getText();
    }
}

// Тестовый класс
@Test
public void testSuccessfulLogin() {
    LoginPage loginPage = new LoginPage(driver);
    DashboardPage dashboard = loginPage.loginAs("admin@test.com", "password123");
    assertEquals("Welcome, Admin", dashboard.getWelcomeText());
}