QAwalk

Všichni průvodci › Podle použití

Podle použití

Mobilní aplikace: projděte obrazovky Androidu a iOS jako webové stránky

QAwalk ovládá Android emulátor přes adb a iOS Simulator, zachytí každou obrazovku i s UI stromem, zkontroluje popisky, dotykové cíle a pády a rozloží flow aplikace na stejnou plachtu jako vaše webové stránky.

Webová flow procházíte na plachtě. Aplikace nese stejné funkce, jenže její obrazovky vedle sebe nikdo neuvidí dřív než při review v obchodě. QAwalk projde i aplikaci a obojí se kontroluje na jednom místě.

Problém

Mobilní end-to-end testy dokážou, že jde tlačítko ťuknout. Neukážou, jestli obrazovka dává smysl v češtině, jestli se popisek na malém telefonu neusekl a jestli má ikonové tlačítko popisek pro VoiceOver. Screenshoty skončí ve vlákně chatu, odtržené od kritérií.

Co se s QAwalkem změní

Ve scénáři stojí platform: android nebo platform: ios. Na kroky se dostanete deep linkem nebo krátkým skriptem. Z každého kroku vznikne screenshot a UI strom, kritéria se kontrolují nad stromem a plachta ukáže flow v rámečcích zařízení. Kontrolující přijímají a vracejí kroky stejně jako u webových běhů.

Jak to funguje

  1. Pojmenujte aplikaci

    v qawalk.config.yml pro každé prostředí: balíček pro Android (a APK k instalaci), nebo bundle a simulátor pro iOS.

  2. Popište flow

    obrazovky s deep linky (shop://product/42) nebo skripty typu app.tap('button[text="Do košíku"]'). Každý jazyk startuje aplikaci znovu a v daném jazyce.

  3. Projděte

    npx qawalk walk spustí aplikaci v emulátoru nebo simulátoru a zachytí každou obrazovku. Na Androidu přes adb screencap se stromem z uiautomatoru, na iOS přes simctl se stromem z idb (bez idb rozpozná text ze snímku). Z logu aplikace na Androidu pozná pády.

  4. Zkontrolujte

    pack app hlídá popisky všech ovládacích prvků, dotykové cíle (48 dp / 44 pt), useknuté texty a pády. Vlastní kritéria používají CSS-like selektory nad stromem. Sémantické otázky čtou obrazovku jako osnovu.

  5. Cokoli dalšího

    reálná zařízení, Maestro, Appium, Detox nebo XCUITest pořídí screenshot a qawalk capture --image shot.png --tree hierarchy.xml ho přinese i s UI dumpem.

Skilly a prompty

Projdi checkout naší Android aplikace na emulátoru v cs a en: detail produktu deep linkem, přidání do košíku, košík. Použij pack app a zkontroluj formát ceny.
Náš Maestro flow už prochází onboarding na iOS. Po každé obrazovce ji zachyť do QAwalku i s hierarchií a běh nasdílej na design review.

Očekávaný výsledek: plachta obrazovek aplikace v rámečcích telefonu pro každý jazyk. Každá má UI strom, zvýrazněné prvky u nesplněných kritérií (třeba ikonové tlačítko 30×30 bez popisku) a značku pádu, pokud aplikace spadla.

Co získáte

FAQ

Potřebuji Appium?

Ne. Android potřebuje adb a emulátor nebo zařízení. iOS potřebuje Simulator z Xcode; idb přidá plný UI strom a ťukání. Když už Appium, Maestro nebo XCUITest používáte, nechte si je a jejich obrazovky importujte.

Funguje to s Flutterem nebo React Native?

Ano, pokud UI strom platformy prvky ukazuje (Flutter se semantics, React Native s accessibility labels). Jinak QAwalk použije rozpoznání textu ze snímku.

Jde to na skutečném iPhonu?

Vestavěný ovladač používá Simulator. U reálného zařízení zachyťte obrazovku svým nástrojem (XCUITest, Appium) a importujte screenshot i page source přes qawalk capture --image --tree.

Další průvodci

Akceptace tasku s AI agentem přímo v pull requestuRegrese před releasem: porovnání běhu s přijatým referenčním běhemSEO a kontrola landing pages na produkci, jen pro čtení, každý denE‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Instalace ve třech krocích

QAwalk běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev @qawalk/cli

    Potřebuje Node 20 nebo novější. Aktualizace později přes npm update @qawalk/cli.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx qawalk init --agent claude --org <your-org>
    npx qawalk doctor

    Skill se zkopíruje do .claude/skills/qawalk.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    QAWALK_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator
  4. Spusťte a nasdílejte
    npx qawalk start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
    npx qawalk walk        # playwright steps; agent/manual steps: qawalk capture
    npx qawalk evaluate
    npx qawalk share --pr

    Nebo požádejte agenta: “Projdi akceptační plán TASK-123 s QAwalk na localu a nasdílej výsledek.”