Installera Maestro och kör ert första flöde

En Maestro-flow är en YAML-fil. appId på toppnivå anger vilken app som ska testas – använd bundle identifier för iOS (till exempel com.example.myapp) eller paketnamnet för Android. Avgränsaren --- inleder kommandolistan.

Börja med kommandot launchApp för att öppna appen från början. Lägg sedan till assertioner och åtgärder. Den enklaste första flowen öppnar appen och verifierar att välkomstskärmen visas.

Kör en Maestro-flow med maestro test path/to/flow.yaml. Se till att en simulator eller emulator körs och att appen är installerad på den innan kommandot körs. Maestro ansluter automatiskt till den simulator som körs – ingen enhetsselektion behövs när det bara finns en.

Maestro skriver ut varje kommando medan det körs. Vid lyckad körning visas en grön bock för varje steg. Vid fel visas kommandot som misslyckades, en skärmbild av gränssnittet när felet inträffade och ett felmeddelande. Skärmbilden är ovärderlig när ni felsöker varför en assertion misslyckades.

Kommandot tapOn simulerar ett tryck med fingret. Ni kan trycka utifrån text (den synliga etiketten), id (elementets testID) eller en procentbaserad punkt på skärmen. Att trycka utifrån text är mest lättläst och står bäst emot layoutändringar.

Om flera element har samma text kan ni lägga till ett index för att ange vilket element som avses (index börjar på 0). Använd optional: true för att göra trycket villkorligt – det hoppas över utan att körningen misslyckas om elementet inte finns. Det är användbart när valfria behörighetsdialoger ska stängas.

Använd inputText för att skriva text i det inmatningsfält som för närvarande har fokus. Tryck först på TextInput för att ge det fokus och använd sedan inputText för att skriva. Maestro skriver in hela strängen på en gång i stället för tecken för tecken.

För fält där den befintliga texten först måste tas bort använder ni clearText före inputText. Använd hideKeyboard efter inmatningen för att dölja skärmtangentbordet, som annars kan täcka andra element som ni behöver interagera med.

Maestro genererar testresultat i flera format: oformaterad text i terminalen, JUnit XML (för CI-system som GitHub Actions) eller en interaktiv HTML-rapport. HTML-rapporten innehåller skärmbilder för varje steg, vilket gör det enkelt att visuellt granska vad som hände vid varje punkt i flowen.

När ett test misslyckas sparar Maestro en skärmbild av skärmen i det ögonblick då felet inträffade. Leta efter skärmbilden vid felet i utdatat för att förstå varför en assertion misslyckades – ofta visar skärmen en laddningsindikator i stället för det förväntade innehållet, vilket avslöjar ett timingproblem.

Kommandona i en Maestro-flow körs sekventiellt. Maestro väntar automatiskt på att varje kommando ska slutföras innan nästa körs. Tryck väntar på att elementet ska vara synligt och stabilt innan interaktionen utförs, och assertioner försöker igen tills elementet visas (med en konfigurerbar timeout).

Standard-timeouten för assertVisible är 5 sekunder. Om appen behöver längre tid för att läsa in en skärm, till exempel för att hämta data från ett långsamt API, kan ni öka timeout-värdet med alternativet timeout eller lägga till kommandot waitForAnimationToEnd.

Som standard tar launchApp appen till förgrunden om den redan körs (varmstart). För tester som måste börja med ett rent tillstånd – utan inloggad användare och med en tom databascache – använder ni clearState: true för att ta bort alla appdata innan appen startas.

Detta motsvarar att avinstallera och installera om appen. Använd det i era viktigaste testflows för att säkerställa att de börjar från en förutsägbar utgångspunkt och inte är beroende av data som tidigare flows har lämnat efter sig.

För repetitiva steg, som att logga in före varje test, kan ni flytta ut stegen till en separat subflow-YAML-fil och referera till den med runFlow. Då kan varje testflow fokusera på sitt specifika scenario, medan inloggningen blir ett återanvändbart steg på en rad.

Subflows fungerar som funktionsanrop i kod – de körs infogade i den överordnade flowen. Ni kan skicka parametrar till subflows med avsnittet env och på så sätt återanvända dem med olika data (olika användare och olika inmatningsvärden).

Maestro Studio är ett interaktivt webbaserat gränssnitt som strömmar skärmen från er simulator och låter er spela in flows genom att klicka på element. Kör maestro studio så öppnas en webbläsare där ni kan klicka för att automatiskt generera YAML-kommandon.

Detta är det snabbaste sättet att skapa era första flows – spela in det lyckade standardförloppet interaktivt och granska och redigera sedan den genererade YAML-filen för att lägga till assertioner och hantera specialfall. Studio visar även elementträdet för varje skärm, vilket hjälper er att hitta bästa möjliga testID eller text att rikta in er på.

I den här lektionen har ni lärt er hur ni installerar Maestro och skriver en YAML-flow-fil som startar appen och gör assertioner på synligt innehåll, hur ni använder tapOn, inputText och assertVisible för att styra användarinteraktioner i flows samt hur ni använder subflows för att dela repetitiva steg, som inloggning, mellan flera testflows. Nästa steg är att skriva mer avancerade Maestro-assertioner och hantera dynamiska UI-tillstånd.