UI-testning ui-testing
Anpassad gränssnittstestning är en valfri funktion som gör att du kan skapa och automatiskt köra gränssnittstester för dina program.
Översikt custom-ui-testing
AEM innehåller en integrerad svit med Kvalitetsportar för Cloud Manager för smidiga uppdateringar av anpassade program. I synnerhet har IT-testportar redan stöd för att skapa och automatisera anpassade tester med AEM API:er.
Användargränssnittstester är paketerade i en Docker-bild för att ge ett brett val i språk och miljöer (som Cypress, Selenium, Java och Maven samt JavaScript). Ett UI-testprojekt kan också enkelt genereras med AEM Project Archetype.
Adobe uppmuntrar användningen av Cypress eftersom det ger realtidsladdning och automatisk väntetid, vilket sparar tid och förbättrar produktiviteten under testningen. Cypress har också en enkel och intuitiv syntax som gör det enkelt att lära sig och använda, även för dem som inte har testat tidigare.
Gränssnittstester utförs som en del av en viss kvalitetsgrind för varje Cloud Manager-pipeline med en Anpassade gränssnittstestningar steg in produktionsrörledningar eller valfritt rörledningar för icke-produktion. Alla gränssnittstester, inklusive regression och nya funktioner, gör att fel kan upptäckas och rapporteras.
Till skillnad från anpassade funktionstester, som är HTTP-tester skrivna i Java, kan gränssnittstester vara en dockningsbild med tester skrivna på vilket språk som helst, förutsatt att de följer konventionerna som definieras i avsnittet Skapar gränssnittstester.
Kom igång med gränssnittstester get-started-ui-tests
I det här avsnittet beskrivs stegen som krävs för att konfigurera gränssnittstester för körning i Cloud Manager.
-
Bestäm vilket programmeringsspråk du vill använda.
-
För Cypress använder du exempelkoden från AEM Test Samples.
-
För JavaScript och WDIO använder du exempelkoden som automatiskt genereras i
ui.tests
i din Cloud Manager-databas.note note NOTE Om din databas skapades innan Cloud Manager skapades automatiskt ui.tests
kan du även generera den senaste versionen med AEM Project Archettype. -
För Java och WebDriver använder du exempelkoden i AEM Test Samples.
-
För andra programmeringsspråk, se avsnittet Skapar gränssnittstester i det här dokumentet för att konfigurera testprojektet.
-
-
Se till att gränssnittstestning är aktiverat enligt avsnittet Kundens deltagande i det här dokumentet.
-
Utveckla testfall och köra testerna lokalt.
-
Implementera koden i molnhanterarens databas och kör en Cloud Manager-pipeline.
Skapar gränssnittstester building-ui-tests
Ett Maven-projekt genererar ett Docker-byggsammanhang. I denna Docker build-kontext beskrivs hur du skapar en Docker-bild som innehåller gränssnittstester, som används i Cloud Manager för att generera en Docker-bild som innehåller de faktiska gränssnittstester.
I det här avsnittet beskrivs stegen som krävs för att lägga till ett UI-testprojekt i din databas.
Skapa en kontext för Docker Build generate-docker-build-context
För att skapa en Docker-byggkontext behöver du en Maven-modul som:
- Skapar ett arkiv som innehåller en
Dockerfile
och alla andra filer som behövs för att bygga Docker-bilden med testerna. - Taggar arkivet med
ui-test-docker-context
klassificerare.
Det enklaste sättet att göra detta är att konfigurera Maven Assembly Plugin för att skapa kontextarkivet för Docker-bygget och tilldela rätt klassificerare till det.
Du kan skapa gränssnittstester med olika tekniker och ramverk, men i det här avsnittet förutsätts att ditt projekt är utformat på ett sätt som liknar följande.
├── Dockerfile
├── assembly-ui-test-docker-context.xml
├── pom.xml
├── test-module
│ ├── package.json
│ ├── index.js
│ └── wdio.conf.js
└── wait-for-grid.sh
The pom.xml
filen tar hand om Maven-bygget. Lägg till en exekvering av Maven Assembly Plugin som liknar följande.
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptors>
<descriptor>${project.basedir}/assembly-ui-test-docker-context.xml</descriptor>
</descriptors>
<tarLongFileMode>gnu</tarLongFileMode>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
Den här exekveringen instruerar Maven Assembly Plugin att skapa ett arkiv baserat på instruktionerna i assembly-ui-test-docker-context.xml
, som kallas sammansättningsbeskrivning i pluginens jargon. Sammansättningsbeskrivningen visar alla filer som måste ingå i arkivet.
<assembly>
<id>ui-test-docker-context</id>
<includeBaseDirectory>false</includeBaseDirectory>
<formats>
<format>tar.gz</format>
</formats>
<fileSets>
<fileSet>
<directory>${basedir}</directory>
<includes>
<include>Dockerfile</include>
<include>wait-for-grid.sh</include>
</includes>
</fileSet>
<fileSet>
<directory>${basedir}/test-module</directory>
<excludes>
<exclude>node/**</exclude>
<exclude>node_modules/**</exclude>
<exclude>reports/**</exclude>
</excludes>
</fileSet>
</fileSets>
</assembly>
Sammansättningsbeskrivningen instruerar plugin-programmet att skapa ett arkiv av typen .tar.gz
och tilldelar ui-test-docker-context
-klassificerare. Dessutom listas de filer som måste ingå i arkivet, inklusive följande:
- A
Dockerfile
, obligatoriskt för att bygga dockningsbilden - The
wait-for-grid.sh
skript, vars syften beskrivs nedan - De faktiska gränssnittstesterna, som implementeras av ett Node.js-projekt i
test-module
mapp
Sammansättningsbeskrivningen utesluter också vissa filer som kan genereras när användargränssnittstesterna körs lokalt. Detta garanterar ett mindre arkiv och snabbare byggen.
Arkivet som innehåller Docker-byggkontexten hämtas automatiskt av Cloud Manager, som skapar Docker-bilden som innehåller testerna i samband med driftsättningen. Till slut körs Docker-avbildningen i Cloud Manager för att köra UI-testerna mot ditt program.
Bygget ska antingen producera noll eller ett arkiv. Om inga arkiv skapas godkänns teststeget som standard. Om bygget skapar mer än ett arkiv är det valda arkivet inte deterministiskt.
Kundens deltagande customer-opt-in
För att Cloud Manager ska kunna bygga och köra dina gränssnittstester måste du välja den här funktionen genom att lägga till en fil i databasen.
- Filnamnet måste vara
testing.properties
. - Filinnehållet måste vara
ui-tests.version=1
. - Filen måste finnas under maven-undermodulen för gränssnittstester intill
pom.xml
fil för undermodulen för gränssnittstester. - Filen måste finnas i roten för den inbyggda
tar.gz
-fil.
UI-testerna byggs och körningarna hoppas över om filen inte finns.
Ta med en testing.properties
fil i build-artefakten, lägga till en include
programsats i assembly-ui-test-docker-context.xml
-fil.
[...]
<includes>
<include>Dockerfile</include>
<include>wait-for-grid.sh</include>
<include>testing.properties</include> <!-- opt-in test module in Cloud Manager -->
</includes>
[...]
Om du använder exemplen från Adobe:
-
För JavaScript-baserade
ui.tests
mapp som genererats baserat på AEM Project Archettypekan du köra nedanstående kommando för att lägga till den konfiguration som krävs.code language-shell echo "ui-tests.version=1" > testing.properties if ! grep -q "testing.properties" "assembly-ui-test-docker-context.xml"; then awk -v line=' <include>testing.properties</include>' '/<include>wait-for-grid.sh<\/include>/ { printf "%s\n%s\n", $0, line; next }; 1' assembly-ui-test-docker-context.xml > assembly-ui-test-docker-context.xml.new && mv assembly-ui-test-docker-context.xml.new assembly-ui-test-docker-context.xml fi
-
Testexemplen av Cypress och Java Selenium som tillhandahålls av Adobe har redan flaggan opt-in.
Skriver gränssnittstester writing-ui-tests
I det här avsnittet beskrivs de konventioner som Docker-bilden som innehåller dina gränssnittstester måste följa. Docker-bilden är inbyggd i Docker-konstruktionssammanhanget som beskrivs i föregående avsnitt.
Miljövariabler environment-variables
Följande miljövariabler skickas till din Docker-bild vid körning, beroende på ditt ramverk.
SELENIUM_BASE_URL
http://my-ip:4444
SELENIUM_BROWSER
chrome
AEM_AUTHOR_URL
http://my-ip:4502/context-path
AEM_AUTHOR_USERNAME
admin
AEM_AUTHOR_PASSWORD
admin
AEM_PUBLISH_URL
http://my-ip:4503/context-path
AEM_PUBLISH_USERNAME
admin
AEM_PUBLISH_PASSWORD
admin
REPORTS_PATH
/usr/src/app/reports
UPLOAD_URL
http://upload-host:9090/upload
Provexemplen från Adobe ger hjälpfunktioner för att komma åt konfigurationsparametrarna:
- Cypress: använd standardfunktionen
Cypress.env('VARIABLE_NAME')
- JavaScript: Se lib/config.js modul
- Java: Se Konfig class
Generera testrapporter generate-test-reports
Docker-bilden måste generera testrapporter i JUnit XML-format och spara dem i den sökväg som anges av systemvariabeln REPORTS_PATH
. JUnit XML-formatet är ett format som ofta används för att rapportera testresultat. Om Docker-bilden använder Java och Maven, standardtestmoduler som Maven Surefire Plugin och Maven Failsafe Plugin kan generera sådana rapporter direkt.
Om Docker-bilden implementeras med andra programmeringsspråk eller testkörare bör du kontrollera i dokumentationen vilka verktyg som har valts för att skapa JUnit XML-rapporter.
Förutsättningar prerequisites
- Testerna i Cloud Manager körs med en teknisk administratörsanvändare.
- Den inneslutna infrastruktur som omfattar funktionstestning begränsas av följande gränser:
Selenumspecifik information
Väntar på att Selenium ska vara klart waiting-for-selenium
Innan testerna börjar är det dockningsbildens ansvar att säkerställa att Selenium-servern är igång. Att vänta på Selenium-tjänsten är en tvåstegsprocess.
- Läs URL:en för Selenium-tjänsten på
SELENIUM_BASE_URL
miljövariabel. - Avsökning med regelbundna mellanrum till statusslutpunkt exponeras av Selenium API.
När Seleniums statusendpoint svarar med ett positivt svar kan testerna börja.
Adobe UI-testexemplen hanterar detta med skriptet wait-for-grid.sh
, som körs när Docker startar och startar den faktiska testkörningen först när rutnätet är klart.
Hämta skärmbilder och video capture-screenshots
Docker-bilden kan generera ytterligare testutdata (till exempel skärmbilder eller videoklipp) och spara dem i den sökväg som anges av systemvariabeln REPORTS_PATH
. Alla filer som finns under REPORTS_PATH
ingår i testresultatarkivet.
Testexemplen från Adobe skapar som standard skärmbilder för misslyckade tester.
Du kan använda hjälpfunktionerna för att skapa skärmbilder genom testerna.
- JavaScript: kommandot takeScreenshot
- Java: Kommandon
Om ett testresultatarkiv skapas under en UI-testkörning kan du hämta det från Cloud Manager med Download Details
knappen under Anpassade gränssnittstestningar steg.
Överför filer upload-files
Testerna ibland måste överföra filer till det program som testas. För att driftsättningen av Selenium ska vara flexibel i förhållande till dina tester går det inte att överföra en resurs direkt till Selenium. Om du vill överföra en fil måste du i stället utföra följande steg.
-
Överför filen på den URL som anges av
UPLOAD_URL
miljövariabel.-
Överföringen måste utföras i en POST med ett multipart-formulär.
-
Multipart-formuläret måste ha ett enda filfält.
-
Detta motsvarar
curl -X POST ${UPLOAD_URL} -F "data=@file.txt"
. -
Läs dokumentationen och biblioteken för programmeringsspråket som används i Docker-bilden för att få reda på hur en sådan HTTP-begäran ska utföras.
-
Testexemplen från Adobe innehåller hjälpfunktioner för att överföra filer:
- JavaScript: Se getFileHandleForUpload -kommando.
- Java: Se FileHandler klassen.
-
-
Om överföringen lyckas returnerar begäran en
200 OK
typsvartext/plain
.- Svarets innehåll är ett ogenomskinligt filhandtag.
- Du kan använda det här handtaget i stället för en filsökväg i en
<input>
-element för att testa filöverföringar i programmet.
Köra gränssnittstester lokalt run-ui-tests-locally
Innan gränssnittstester aktiveras i en Cloud Manager-pipeline bör gränssnittstester köras lokalt mot AEM as a Cloud Service SDK eller mot en faktisk AEM as a Cloud Service instans.
Cypress-testexempel cypress-sample
-
Öppna ett skal och navigera till
ui.tests/test-module
mapp i din databas -
Installera Cypress och andra krav
code language-shell npm install
-
Ange de systemvariabler som krävs för testkörning
code language-shell export AEM_AUTHOR_URL=https://author-<program-id>-<environment-id>.adobeaemcloud.com export AEM_AUTHOR_USERNAME=<user> export AEM_AUTHOR_PASSWORD=<password> export AEM_PUBLISH_URL=https://publish-<program-id>-<environment-id>.adobeaemcloud.com export AEM_PUBLISH_USERNAME=<user> export AEM_PUBLISH_PASSWORD=<password> export REPORTS_PATH=target/
-
Köra tester med något av följande kommandon
code language-shell npm test # Using default Cypress browser npm run test-chrome # Using Google Chrome browser npm run test-firefox # Using Firefox browser
JavaScript WebdriverIO-testexempel javascript-sample
-
Öppna ett skal och navigera till
ui.tests
mapp i din databas -
Kör nedanstående kommando för att starta testerna med Maven
code language-shell mvn verify -Pui-tests-local-execution \ -DAEM_AUTHOR_URL=https://author-<program-id>-<environment-id>.adobeaemcloud.com \ -DAEM_AUTHOR_USERNAME=<user> \ -DAEM_AUTHOR_PASSWORD=<password> \ -DAEM_PUBLISH_URL=https://publish-<program-id>-<environment-id>.adobeaemcloud.com \ -DAEM_PUBLISH_USERNAME=<user> \ -DAEM_PUBLISH_PASSWORD=<password>
- Detta startar en fristående seleninstans och kör testerna mot den.
- Loggfilerna lagras i
target/reports
mapp i din databas - Du måste se till att datorn kör den senaste Chrome-versionen när testet hämtar den senaste versionen av ChromeDriver automatiskt för testning.
Java Selenium WebDriver Test Sample java-sample
-
Öppna ett skal och navigera till
ui.tests/test-module
mapp i din databas -
Kör nedanstående kommandon för att starta testerna med Maven
code language-shell # Start selenium docker image (for x64 CPUs) docker run --platform linux/amd64 -d -p 4444:4444 selenium/standalone-chrome-debug:latest # Start selenium docker image (for ARM CPUs) docker run -d -p 4444:4444 seleniarm/standalone-chromium # Run the tests using the previously started Selenium instance mvn verify -Pui-tests-local-execution -DSELENIUM_BASE_URL=http://<server>:4444
target/reports
-mapp i din databas.