Installere Maestro og kjøre den første flyten

En Maestro-flow er en YAML-fil. appId på øverste nivå angir hvilken app som skal testes – bruk bundle-identifikatoren for iOS (for eksempel com.example.myapp) eller pakkenavnet for Android. Skilletegnet --- begynner kommandolisten.

Start med kommandoen launchApp for å åpne appen på nytt. Legg deretter til påstander og handlinger. Den enkleste første flowen åpner bare appen og bekrefter at velkomstskjermen vises.

Kjør en Maestro-flow med maestro test path/to/flow.yaml. Sørg for at en simulator eller emulator kjører, og at appen er installert på den, før De kjører kommandoen. Maestro kobler seg automatisk til simulatoren som kjører – det er ikke nødvendig å velge enhet når det bare finnes én.

Maestro skriver ut hver kommando etter hvert som den kjøres. Ved suksess vises et grønt hakemerke for hvert trinn. Ved feil vises kommandoen som mislyktes, et skjermbilde av brukergrensesnittet da feilen oppsto, og en feilmelding. Skjermbildet er svært nyttig når De skal feilsøke hvorfor en påstand mislyktes.

Kommandoen tapOn simulerer et fingertrykk. De kan trykke basert på tekst (den synlige etiketten), id (elementets testID) eller et prosentbasert punkt på skjermen. Det er mest lesbart og robust mot layoutendringer å trykke basert på tekst.

Hvis flere elementer har samme tekst, kan De legge til en index for å angi hvilket element som skal brukes (indeksert fra 0). Bruk optional: true for å gjøre trykket betinget – det hoppes over uten feil hvis elementet ikke finnes. Dette er nyttig når valgfrie tillatelsesdialoger skal lukkes.

Bruk inputText til å skrive tekst i inndatafeltet som har fokus. Trykk først på TextInput for å gi det fokus, og bruk deretter inputText til å skrive. Maestro skriver inn hele strengen på én gang i stedet for tegn for tegn.

For felt der eksisterende tekst må slettes først, kan De bruke clearText før inputText. Bruk hideKeyboard etter skrivingen for å skjule skjermtastaturet, som kan dekke andre elementer De må samhandle med.

Maestro genererer testresultater i flere formater: ren tekst i terminalen, JUnit XML (for CI-systemer som GitHub Actions) eller en interaktiv HTML-rapport. HTML-rapporten inneholder skjermbilder for hvert trinn, slik at det er enkelt å se gjennom hva som skjedde på hvert punkt i flowen.

Når en test mislykkes, lagrer Maestro et skjermbilde av skjermen i det øyeblikket feilen oppsto. Se etter skjermbildet av feilen i resultatet for å forstå hvorfor en påstand mislyktes – ofte viser skjermen en lastespinner i stedet for det forventede innholdet, noe som avslører et timingproblem.

Kommandoene i en Maestro-flow kjøres sekvensielt. Maestro venter automatisk på at hver kommando skal fullføres før den går videre til neste. Trykk venter på at elementet skal være synlig og stabilt før det samhandles med det, og påstander prøves på nytt til elementet vises (med en konfigurerbar tidsavbruddsgrense).

Standardtidsavbruddet for assertVisible er 5 sekunder. Hvis appen bruker lengre tid på å laste inn en skjerm (for eksempel fordi den henter data fra et tregt API), kan De øke tidsavbruddet med alternativet timeout eller legge til kommandoen waitForAnimationToEnd.

Som standard henter launchApp appen frem i forgrunnen hvis den allerede kjører (varm start). For tester som må starte med en ren tilstand – ingen innlogget bruker og tom databuffer – kan De bruke clearState: true til å slette alle appdata før appen startes.

Dette tilsvarer å avinstallere og installere appen på nytt. Bruk dette i de viktigste testflowene for å sikre at de starter fra et forutsigbart utgangspunkt og ikke avhenger av data som tidligere flower har etterlatt.

For gjentatte trinn, som å logge inn før hver test, kan De trekke dem ut i en subflow-YAML-fil og referere til den med runFlow. Da kan hver testflow konsentreres om sitt spesifikke scenario, mens innloggingen blir et gjenbrukbart trinn på én linje.

Subflower fungerer som funksjonskall i kode – de kjøres inne i den overordnede flowen. De kan sende parametere til subflower ved hjelp av delen env, slik at de kan brukes på nytt med ulike data (ulike brukere og inndataverdier).

Maestro Studio er et interaktivt, nettbasert brukergrensesnitt som strømmer simulatorens skjerm og lar Dem ta opp flower ved å klikke på elementer. Kjør maestro studio, så åpnes en nettleser der De kan klikke for å generere YAML-kommandoer automatisk.

Dette er den raskeste måten å opprette Deres første flower på – ta opp happy path interaktivt, og gå deretter gjennom og rediger den genererte YAML-en for å legge til påstander og håndtere spesialtilfeller. Studio viser også elementtreet for hver skjerm, slik at det blir enklere å finne den beste testID-en eller teksten å målrette.

I denne leksjonen har De lært: hvordan De installerer Maestro og skriver en YAML-flow som starter appen og kontrollerer synlig innhold, hvordan De bruker tapOn, inputText og assertVisible til å styre brukerinteraksjoner i flowene, og hvordan De bruker subflower til å dele gjentatte trinn, som innlogging, mellom flere testflower. Neste trinn er å skrive mer avanserte Maestro-påstander og håndtere dynamiske tilstander i brukergrensesnittet.