Projít aplikace pro Android, iOS a desktop
Nativní aplikace Kaloko prochází stejně jako webové stránky: z každého kroku je screenshot s UI stromem, zkontrolovaná kritéria a místo na plachtě. Scénář říká, o jakou platformu jde, a konfigurace, kterou aplikaci otevřít.
1. Pojmenujte aplikaci pro každé prostředí
# kaloko.config.yml
environments:
staging:
app:
android: { package: com.acme.shop.staging, apk: build/app-staging.apk, reset: true }
ios: { bundle: com.acme.shop, app: build/Shop.app, device: iPhone 17 }
desktop:
app:
electron: { main: dist/main.js }
# desktop: { name: Notes } # aplikace pro macOS podle okna
# windows: { name: contoso, path: dist/Contoso.exe }2. Nastavte platformu ve scénáři
platform: android # android | ios | electron | desktop | windows
devices: [pixel-8-api-34, pixel-7-api-33]
color_schemes: [light, dark]
nodes:
- id: product
kind: screen
path: shop://product/42 # deep link
packs: [app]Na kroky se aplikace dostane přes deep link nebo skriptem kroku (app.tap(…), app.type(…)). V každém jazyce se aplikace spustí znovu a v daném jazyce, reset: true nejdřív smaže její data.
Co která platforma umí
| Platforma | Co ji ovládá | Poznámka |
|---|---|---|
| Android | adb: emulátor, telefon přes USB nebo přes Wi‑Fi | neběžící emulátor se spustí; tmavý režim a omezený pohyb se nastaví pro každý snímek |
| iOS Simulator | xcrun simctl | ťuknutí a UI strom potřebují idb; bez něj Kaloko přečte text z obrazovky |
| iPhone a iPad | devicectl a nástroj na screenshoty | jen zachycení, text se čte z obrazovky |
| Electron | Playwright | okno je webová stránka: platí všechny webové kontroly |
| Aplikace pro macOS | okno aplikace a strom přístupnosti | jen zachycení; mezi obrazovkami přechází váš nástroj, AppleScript nebo člověk |
| Aplikace pro Windows | UI Automation přes PowerShell | ťuknutí i psaní; procházejte ji ve Windows |
Pack app kontroluje popisky ovládacích prvků, velikost dotykových ploch, useknutý text a pády.
Obrazovky z jiných nástrojů
Screenshot může pořídit Maestro, Appium, XCUITest, Detox nebo člověk a Kaloko ho rozloží i s UI stromem:
npx kaloko capture --step checkout --image shot.png --tree hierarchy.xml --device "Pixel 8" --density 2.625--tree přečte XML z uiautomatoru nebo Appia, idb ui describe-all --json a JSON hierarchie z Maestra. Bez stromu přečte --ocr text z obrázku (na macOS). Celou složku screenshotů nebo report testů nahrajete přes npx kaloko import.
Nejdřív zkontrolujte počítač
npx kaloko doctorVypíše, které nástroje pro aplikace na počítači chybějí (adb, simctl, idb, ffmpeg), a jak je nainstalovat. Na macOS si kaloko doctor --fix vyžádá oprávnění k nahrávání obrazovky a zpřístupnění, která desktopové snímky potřebují.