Installation af Maestro og kørsel af det første flow

Et Maestro-flow er en YAML-fil. appId på øverste niveau angiver, hvilken app der skal testes — brug bundle-id'et til iOS (f.eks. com.example.myapp) eller pakkenavnet til Android. Separatoren --- starter kommandolisten.

Start med kommandoen launchApp for at åbne appen fra en frisk tilstand. Tilføj derefter påstande og handlinger. Det enkleste første flow åbner appen og bekræfter, at velkomstskærmen vises.

Kør et Maestro-flow med maestro test path/to/flow.yaml. Sørg for, at en simulator eller emulator kører, og at appen er installeret på den, før du udfører kommandoen. Maestro opretter automatisk forbindelse til den kørende simulator — du behøver ikke vælge en enhed, når der kun er én.

Maestro udskriver hver kommando, efterhånden som den udføres. Ved succes vises et grønt flueben for hvert trin. Ved fejl vises den fejlslagne kommando, et skærmbillede af brugerfladen på fejlstedet og en fejlmeddelelse. Skærmbilledet er uvurderligt, når du skal fejlfinde, hvorfor en påstand mislykkedes.

Kommandoen tapOn simulerer et tryk med en finger. Du kan trykke ud fra tekst (den synlige etiket), ud fra id (elementets testID) eller på et procentbaseret punkt på skærmen. Det er mest læsbart og robust over for layoutændringer at trykke ud fra tekst.

Hvis flere elementer har den samme tekst, kan du tilføje et index for at angive hvilket der skal bruges (indekseret fra 0). Brug optional: true for at gøre trykket betinget — det springes over uden fejl, hvis elementet ikke findes. Det er nyttigt til at lukke valgfrie dialogbokse med tilladelser.

Brug inputText til at skrive tekst i det inputfelt, der har fokus. Tryk først på TextInput for at give det fokus, og brug derefter inputText til at skrive. Maestro skriver hele strengen på én gang i stedet for tegn for tegn.

Hvis et felt først skal tømmes for eksisterende tekst, skal du bruge clearText før inputText. Brug hideKeyboard efter indtastningen for at skjule softwaretastaturet, som kan dække andre elementer, du skal interagere med.

Maestro genererer testresultater i flere formater: almindelig tekst i terminalen, JUnit XML (til CI-systemer som GitHub Actions) eller en interaktiv HTML-rapport. HTML-rapporten indeholder skærmbilleder for hvert trin, så du nemt visuelt kan gennemgå, hvad der skete på hvert tidspunkt i flowet.

Når en test mislykkes, gemmer Maestro et skærmbillede af skærmen på fejløjeblikket. Se efter fejlskærmbilledet i outputtet for at forstå, hvorfor en påstand mislykkedes — ofte viser skærmen en indlæsningsindikator i stedet for det forventede indhold, hvilket afslører et timingproblem.

Kommandoerne i et Maestro-flow udføres sekventielt. Maestro venter automatisk på, at hver kommando bliver færdig, før den går videre til den næste. Tryk venter på, at elementet bliver synligt og stabilt, før der interageres med det, og påstande gentages, indtil elementet vises (med en konfigurerbar timeout).

Standard-timeoutværdien for assertVisible er 5 sekunder. Hvis din app er længere tid om at indlæse en skærm (f.eks. fordi den henter data fra en langsom API), kan du øge timeoutværdien med indstillingen timeout eller tilføje kommandoen waitForAnimationToEnd.

Som standard bringer launchApp appen i forgrunden, hvis den allerede kører (varm start). Til test, der skal begynde med en ren tilstand — ingen bruger er logget ind, og databasedata i cachen er tomme — skal du bruge clearState: true til at slette alle appdata, før appen startes.

Det svarer til at afinstallere og geninstallere appen. Brug det i dine vigtigste testflows for at sikre, at de starter fra et forudsigeligt udgangspunkt og ikke afhænger af data, som tidligere flows har efterladt.

Ved gentagne trin som login før hver test kan du udtrække trinnene til en underflow-YAML-fil og referere til den med runFlow. Det holder hvert testflow fokuseret på sit specifikke scenarie og gør loginopsætningen til et genanvendeligt trin på én linje.

Underflows fungerer som funktionskald i kode — de udføres på stedet som en del af det overordnede flow. Du kan sende parametre til underflows ved hjælp af sektionen env, så de kan genbruges med forskellige data (forskellige brugere eller inputværdier).

Maestro Studio er en interaktiv webbaseret brugerflade, der viser din simulators skærm direkte og lader dig optage flows ved at klikke på elementer. Kør maestro studio, så åbner der en browser, hvor du kan klikke for automatisk at generere YAML-kommandoer.

Det er den hurtigste måde at oprette dine første flows på — optag den forventede brugerrejse interaktivt, og gennemgå og rediger derefter den genererede YAML for at tilføje påstande og håndtere særlige tilfælde. Studio viser også elementtræet for hver skærm, så du lettere kan finde det bedste testID eller den bedste tekst at målrette.

I denne lektion har du lært: hvordan du installerer Maestro og skriver en YAML-flow-fil, der starter appen og kontrollerer synligt indhold, hvordan du bruger tapOn, inputText og assertVisible til at styre brugerinteraktioner i flows og hvordan du bruger underflows til at dele gentagne trin som login på tværs af flere testflows. Næste emne er at skrive mere avancerede Maestro-påstande og håndtere dynamiske tilstande i brugerfladen.