Appium — mi ez, működési elvek és cross-platform tesztelés

Mi az Appium

Appium egy nyílt forráskódú keretrendszer mobilalkalmazások tesztelésének automatizálására, kliens-szerver architektúrára építve. Az Appium szerver parancsokat fogad a klienstől a WebDriver protokollon keresztül, és továbbítja azokat a natív illesztőprogramoknak: XCUITest iOS-hez, UiAutomator2 Androidhoz és WinAppDriver Windowshoz.

Történelem és közösség

Az Appium 2013-ban jött létre, és azóta ipari szabvánnyá vált a cross-platform tesztelésben. A projektet az Appium Foundation kezeli, és nagyvállalatok támogatják: Sauce Labs, HeadSpin, Microsoft. Havonta több mint 500 ezer tesztelő használja az Appiumot világszerte.

Támogatott alkalmazástípusok

Az Appium három típusú alkalmazást támogat: natív (iOS, Android, Windows), mobil webböngészők (Safari, Chrome) és hibrid alkalmazások (WebView natív héjban). Minden típus a saját kontextusát használja: NATIVE_APP, WEBVIEW vagy CHROMIUM.

Az Appium és WebDriver architektúrája

Az Appium architektúrája négy rétegből áll: kliens kód → Appium Client Library → Appium Server → natív illesztőprogram. A klienskönyvtár megvalósítja a WebDriver protokollt, és HTTP kéréseket küld a szervernek. A szerver ezeket a platform natív illesztőprogramjának parancsaivá alakítja.

WebDriver protokoll

A WebDriver a W3C szabványa a böngészők automatizálására, amelyet az Appium adaptált mobileszközökhöz. Minden művelet — elem keresése, kattintás, szöveg beírása — HTTP kérésként kerül elküldésre a szervernek. Például a POST /session/{id}/element új tesztelési munkamenetet hoz létre.

Munkamenetek és Desired Capabilities

Minden teszt egy munkamenet létrehozásával kezdődik a Desired Capabilities objektumon keresztül. Ebben meg kell adni: platformName, deviceName, appPath, automationName és további paramétereket. Az Appium ezeket az adatokat használja a megfelelő natív illesztőprogram kiválasztásához és az eszköz konfigurálásához.

# Példa Desired Capabilities Androidhoz
desired_caps = {
    'platformName': 'Android',
    'deviceName': 'Pixel_4',
    'app': '/path/to/app.apk',
    'automationName': 'UiAutomator2',
    'appPackage': 'com.example.app',
    'appActivity': '.MainActivity'
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

Az Appium telepítése és konfigurálása

Az Appium telepítése npm-en keresztül történik: npm install -g appium. A telepítés után konfigurálni kell a natív illesztőprogramokat minden platformhoz: appium driver install xcuitest és appium driver install uiautomator2. Az iOS-hez Xcode, az Androidhoz pedig Android SDK szükséges.

Appium Inspector

Az Appium Inspector egy grafikus eszköz a felületi elemek ellenőrzésére. Csatlakozik a futó Appium szerverhez, és megjeleníti a UI komponensek hierarchiáját, attribútumaikat és lokátoraikat. Az Inspector lehetővé teszi a szelektor ellenőrzését a teszt megírása előtt.

Szerver indítása

Az Appium szerver az appium paranccsal indítható opcionális paraméterekkel: port, cím, naplózás. Alapértelmezés szerint a szerver a 4723-as porton figyel. Több eszköz párhuzamos indításához különböző portokat vagy Appium klasztereket használnak.

# Appium szerver indítása naplózással
appium \
  --port 4723 \
  --log-level debug \
  --use-plugins images \
  --base-path /wd/hub

Tesztek írása Appiumban

Az Appium tesztek a Page Object mintát használják a kód szervezésére. Az alkalmazás minden képernyőjét egy külön osztály írja le elem lokátorokkal és interakciós metódusokkal. A Page Object Model leegyszerűsíti a tesztek karbantartását a felület változásainál, és újrahasznosítja a szelektorokat a tesztforgatókönyvek között.

Elem lokátorok

Az Appium számos elemkeresési stratégiát támogat: id, xpath, accessibilityId, className, androidUIAutomator és iOSClassChain. A leginkább ajánlottak az accessibilityId és id — ezek stabilak az elrendezés változásainál. Az XPath csak más lokátorok hiányában használható.

// Page Object a bejelentkezési képernyőhöz
public class LoginPage {
    private AppiumDriver driver;

    private MobileElement emailField =
        (MobileElement) driver.findElement(MobileBy.AccessibilityId("emailInput"));
    private MobileElement passwordField =
        (MobileElement) driver.findElement(MobileBy.AccessibilityId("passwordInput"));
    private MobileElement loginButton =
        (MobileElement) driver.findElement(MobileBy.AccessibilityId("loginButton"));

    public void login(String email, String password) {
        emailField.sendKeys(email);
        passwordField.sendKeys(password);
        loginButton.click();
    }
}

Munka gesztusokkal és akciókkal

Az Appium támogatja az összetett gesztusokat a TouchAction osztályon vagy a W3C Actions API-n keresztül: csúsztatások, multitouch, hosszú lenyomások, görgetés elemhez. Az új W3C Actions API ajánlott új projektekhez, mivel szabványosított és stabilabban működik a platformok különböző verzióin.

Az Appium összehasonlítása alternatívákkal

Az Appiumot gyakran hasonlítják össze a Detox-szal, XCUITest-tel és Espresso-val. Az Appium fő előnye a cross-platform képesség: egy teszt futtatható iOS-en és Androidon módosítások nélkül. A Detox azonban jobb szinkronizációt biztosít a React Native-hoz, az XCUITest/Espresso pedig gyorsabb végrehajtást a natív tesztekhez.

Mikor válasszuk az Appiumot

Az Appium olyan projektekhez alkalmas, amelyek egységes keretrendszert igényelnek iOS, Android és web számára. Nélkülözhetetlen azokban a csapatokban, ahol a tesztelők Java-ban vagy Python-ban írnak. Sok E2E teszttel rendelkező React Native projektekhez jobb megfontolni a Detox-ot az automatikus szinkronizáció miatt.

Appium Grid és felhőalapú tesztelés

Az Appium Grid egy kiterjesztés a tesztek párhuzamos futtatására több eszközön egyszerre. Az Appium Grid a Selenium Grid alapjaira épül, és lehetővé teszi a tesztek elosztását több Appium szerver között, amelyek mindegyike saját eszköz- vagy emulátorkészletet kezel. Ez kritikus fontosságú nagy projekteknél, ahol a regressziós futtatás egyetlen eszközön órákig tart — a Grid az időt percekre csökkenti a csomópontok számával arányosan.

Grid konfiguráció

A Grid beállításához JSON formátumú konfigurációs fájlt használnak, amelyben a csomópontokat (nodes) eszközökkel írják le. Minden csomópont megadja: a szerver portját, az eszközök listáját platformmal, OS verzióval és a maximális munkamenetek számát. A Hub elosztja a teszteket a szabad csomópontok között, biztosítva az infrastruktúra maximális kihasználtságát.

{
  "capabilities": [
    {
      "browserName": "android",
      "platformName": "Android",
      "deviceName": "Pixel_4",
      "platformVersion": "14.0",
      "maxInstances": 2
    }
  ],
  "configuration": {
    "port": 4724,
    "registerCycle": 5000
  }
}

Felhőszolgáltatások

Ha a saját eszköz infrastruktúra nem áll rendelkezésre, léteznek felhőszolgáltatások: Sauce Labs, BrowserStack, LambdaTest. Ezek százával kínálnak valódi eszközöket és emulátorokat a felhőben. Az Appiummal való integráció minimális: elég megadni a felhő hub URL-jét és a hitelesítő adatokat a Desired Capabilities-ben a localhost helyett.

Párhuzamos futtatás

Az Appium támogatja a tesztek párhuzamos futtatását TestNG (Java) vagy pytest-xdist (Python) segítségével. A párhuzamosítás egyedi portokat igényel minden munkamenethez és elkülönített tesztadatokat. Minden szál a saját Appium munkamenetét indítja el egy külön eszközön vagy emulátoron. Felhőszolgáltatások használatakor a párhuzamosítás automatikus — a platform maga osztja el a teszteket a rendelkezésre álló eszközök között, és felszabadítja azokat a befejezés után.

Az Appium diagnosztikája és hibakeresése

Az Appiummal kapcsolatos problémák esetén az első lépés a szerver naplójának ellenőrzése (appium --log-level debug). Tipikus hibák: a port foglalt (adjon meg másik --port-ot), nem kompatibilis illesztőprogram-verzió, hiányzó Android SDK vagy Xcode. iOS esetén győződjön meg arról, hogy a WebKitAgent fut és hozzáfér a szimulátorhoz.

Problémák az elemek megtalálásával

Ha az Appium nem talál egy elemet, ellenőrizze: helyes-e a kontextus (NATIVE_APP vs WEBVIEW), látható-e az elem a képernyőn, szükséges-e görgetés, és helyes-e a lokátor. Használja az Appium Inspector-t interaktív kereséshez és XPath kifejezések ellenőrzéséhez, mielőtt beillesztené a tesztbe. Hasznos továbbá az elem megjelenésére való várakozás bekapcsolása WebDriverWait segítségével — ez megoldja a szinkronizációs problémát lassú UI betöltés esetén.

Munkamenetek kezelése

A munkamenetek helytelen befejezése az Appium tesztek instabilitásának gyakori oka. Mindig zárja be az illesztőprogramot a finally blokkban vagy AutoCloseable segítségével. Hibák esetén használja a kényszerített driver.quit()-et. iOS esetén győződjön meg arról, hogy a WebKitAgent (WDA) újraindul a munkamenetek között, ellenkező esetben session not created hiba léphet fel. A munkamenetek állapotának CI-ben történő figyeléséhez hasznos az Appium Dashboard bővítmény csatlakoztatása, amely valós időben vizualizálja az összes futó teszt állapotát.

Stabilitási jelzők

A tesztek stabilitásának növeléséhez használja: shouldTerminateApp (alkalmazás bezárása a tesztek között), noReset (adatok megőrzése a munkamenetek között), autoGrantPermissions (rendszerpárbeszédpanelek automatikus engedélyezése). Szintén ajánlott az animációk kikapcsolása az eszközön a Developer Options segítségével.