Appium Maven-beroende: Konfigurera med Eclipse Projektexempel

Vad är Apache Maven?

Apache Maven är en Java-baserat projektlednings- och automationsverktyg. Det tillhandahåller ett multitasking-ramverk för utvecklare att förenkla hela bygglivscykeln för Java applikationer. Maven är fördefinierat och deklarerat i ett XML-format som kallas POM (Project Object Model) och kallas "pom.xml". Den kan också användas för andra språk som C#, Scala, Ruby, etc.

Med hjälp av Maven-ramverket kan du enkelt hantera följande uppgifter i vilket projekt som helst:

• Bygg cykel
• Projektdokumentation
• Rapportera kontroller
• Scrumshantering
• Släpp information

Grundläggande användningsområden för Maven är:

• Genomför en standardkatalogstruktur.
• Ge en återanvändbar och lättskött projektstruktur.
• Lös paketberoenden.
• Tillhandahåll ett ramverk för konfigurationshantering.

Den förmågan att lösa beroenden är precis vad en Appium projektets behov, eftersom Java klienten drar in en kedja av Selenium burkar som ingen vill ladda ner för hand.

Ladda ner Appium Maven beroenden

Innan du börjar skriva en Appium beroendetest med Maven, du behöver ladda ner Appium Maven-beroendet — Appium JAR-nedladdningsfil — från Mavens centrala arkivwebbplatsSkärmdumpen nedan visar listan över java-client-artefakter på Maven Central, där varje publicerad version och dess färdiga kodavsnitt är tillgängliga.

Eller lägg direkt till POM.xml-artefakten som nämns nedan:

<dependency>
  <groupId>io.appium</groupId>
  <artifactId>java-client</artifactId>
  <version>3.4.1</version>
</dependency>

⚠️ Versionsnotering: d 3.4.1 Koordinaten ovan är originalexemplet och visar fortfarande blockets korrekta form. Den är äldre än W3C WebDriver-protokollet, så ett nytt projekt bör uppdatera versionen. I skrivande stund är den nuvarande utgåvan på Maven Central 10.1.1, vilket kräver Selenium 4.42.0 eller senare.

<dependency>
  <groupId>io.appium</groupId>
  <artifactId>java-client</artifactId>
  <version>10.1.1</version>
</dependency>

Gå gärna igenom vår Maven handledning för att lära dig hur du konfigurerar Maven med Eclipse.

Appium Maven-projektstruktur och nödvändiga beroenden

Maven använder en fast layout, och att veta den förhindrar det mesta av den förvirring som följer senare i den här genomgången. Ett genererat projekt innehåller fyra viktiga platser:

• pom.xml — Projektobjektmodellen vid projektroten, där varje beroende och plugin deklareras.
• src / main / java — applikations- och hjälpklasser.
• src/test/java — testklasser och den enda katalogen som Surefire-pluginet skannar när du kör en build.
• mål — sammanställda utdata och testrapporter, regenererade för varje version.

Ocuco-landskapet Appium java-client är det enda obligatoriska beroendet, eftersom det deklarerar Selenium API, fjärrdrivrutiner och supportartefakter transitiverar. Många team fäster fortfarande Selenium explicit så att versionen är synlig på ett ställe, och lägg till en testkörare:

<dependencies>
  <dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>10.1.1</version>
  </dependency>
  <dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.42.0</version>
  </dependency>
</dependencies>

Håll de två versionerna kompatibla. En Java-klient-utgåva anger att Selenium det stöder, och blandar en gammal klient med en mycket nyare Selenium är den vanligaste orsaken till ett NoSuchMethodError vid körning. java-klient-arkiv dokumenterar parningen för varje utgåva.

Testapplikation med Appium och Maven

Med beroendet på plats, den Eclipse arbetsflödet nedan bygger ett körbart projekt från grunden. Efter att ha konfigurerat Appium Java Maven-plugin Eclipse, arbetsytan är redo att testa alla Android .apk ansökan med Appium och Maven, som visas i Appium Maven-projektexempel nedan.

Steg 1) I detta steg

1. Gå till NYTT >> välj Maven-projekt
2. Klicka på knappen 'nästa'

Guiden för nytt projekt öppnas med Maven Project markerat, som visas här.

Steg 2) Skriv sedan in ' i fönstret 'Nytt Maven-projekt'Appium Test' i kolumnerna Grupp-ID och Artefakt-ID. I det här steget måste du ange:

1. Grupp-ID
2. Artefakt-ID
3. Version
4. Förpackning
5. Namn och Description
6. Finish

Det ifyllda formuläret för New Maven Project ser ut som på skärmdumpen nedan.

Om du klickar på knappen Slutför öppnas en ny klass under det definierade grupp-ID:t (AppiumTest) namn.

Steg 3) Till att börja med Appium skriptet, högerklicka på 'src/main/java' i Utforskarfönstret till vänster. Välj sedan Ny >> klass. Skriv Appium kod i den valda klassen.

Kontextmenyn som används för att skapa den klassen visas nedan.

Steg 4) I samma projekt klickar du på pom.xml i den vänstra menyn i utforskaren. Alla beroenden kommer som standard att synas på fliken 'pom.xml'. Se bilden nedan.

Om standardfilen pom.xml inte finns, lägg bara till alla Maven-filer. Appium beroenden, t.ex.tracfrån Mavens centrala arkivs webbplats:

https://central.sonatype.com/artifact/io.appium/java-client

Den redigerade pom.xml-filen med Appium beroenden som lagts till visas nedan.

Steg 5) Högerklicka nu på 'pom.xml' i vänstra utforskaren, eller på XML-koden för 'AppiumTest-projektet. Klicka sedan på alternativet 'Kör som >> Maven Clean', som visas nedan.

Medan du kör kan du se alla Maven-relaterade jar-filer och ett lyckat meddelande, som i konsolutdata nedan. Så här kör du en Appium Java klient Maven-beroendetest i en Maven-konfigurerad miljö.

Hur man kör Appium Tester med Maven-kommandon

Ocuco-landskapet Eclipse Menyn är praktisk, men samma bygg måste köras obevakad på en byggserver, och där är kommandoraden det enda alternativet. Öppna en terminal i mappen som innehåller pom.xml och använd dessa kommandon.

mvn clean
mvn clean test
mvn clean install
mvn test -Dtest=LoginTest

Var och en har ett specifikt jobb:

• mvn clean tar bort target katalogen så att inget gammalt överlever i nästa version. Detta är kommandot som Eclipse genomgång ovanstående triggers.
• mvn clean test kompilerar projektet och kör testklasserna. Maven Surefire-pluginet hämtar dem automatiskt från src/test/java, med standardinkluderingsmönster Test*.java, *Test.java, *Tests.java och *TestCase.java.
• ren installation av mvn kör testerna och placerar sedan den paketerade artefakten i ditt lokala arkiv, så att ett annat projekt kan förlita sig på den.
• mvn test -Dtest=Inloggningstest begränsar körningen till en enda klass medan du felsöker.

Två punkter fångar folk. För det första Appium Servern måste redan vara igång och en enhet eller emulator måste vara ansluten innan bygget startar, eftersom Maven inte startar någon av dem — verifiera enheten med en adb kontrollera först. Sedan skrivs resultaten till target/surefire-reports, vilket är mappen som ett CI-jobb ska arkivera. Surefire användarguide täcker konfigurationsalternativen i detalj, och samma kommandon driver en Appium svit från Jenkins.

Gemensam Appium Maven-fel och hur man åtgärdar dem

De flesta misslyckanden i en Appium Maven-inställningarna beror snarare på en handfull repeterbara orsaker än på själva testkoden. Tabellen nedan mappar varje symptom till dess vanliga lösning.

När en build misslyckas, läs det första felet som Maven skriver ut snarare än det sista. De senare raderna är vanligtvis konsekvenser av den första saknade artefakten.

Vanliga frågor