Appium+Maven+TestNG(ReportNG)環境搭建（詳細過程）

    最近群里經常有人會問到關於maven構建Appium測試項目以及使用testNG生成測試報告的問題，試着搭建了一下，下面是過程：

jdk安裝過程我這里就不說了

一、下載eclipse，推薦下載Eclipse Luna java EE版本，自帶maven插件，比較穩定。Eclipse Luna java EE版64位下載地址：http://ftp.yz.yamagata-u.ac.jp/pub/eclipse//technology/epp/downloads/release/luna/SR2/eclipse-jee-luna-SR2-win32-x86_64.zip

二、下載Maven並配置環境變量

從maven官網下載maven程序包：http://apache.opencas.org/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.zip，下載后解壓，例如我的目錄結構是：

 

配置環境變量MAVEN_HOME，變量值為maven的根目錄：D:\Program Files\apache-maven-3.3.9，在PATH中添加bin的路徑：D:\Program Files\apache-maven-3.3.9\bin，

三、配置settings.xml文件，打開maven conf目錄下的settings.xml文件，配置maven本地倉庫地址，我配置的是F:\repository

 

我還配置了鏡像的地址，因為從默認的中央倉庫下載依賴包太慢了，在settings.xml中加入下面的代碼：

<mirrors>
    <!-- mirror | Specifies a repository mirror site to use instead of a given
        repository. The repository that | this mirror serves has an ID that matches
        the mirrorOf element of this mirror. IDs are used | for inheritance and direct
        lookup purposes, and must be unique across the set of mirrors. | -->
    <mirror>
        <id>nexus-osc</id>
        <mirrorOf>central</mirrorOf>
        <name>Nexus osc</name>
        <url>http://maven.oschina.net/content/groups/public/</url>
    </mirror>
    <mirror>
        <id>nexus-osc-thirdparty</id>
        <mirrorOf>thirdparty</mirrorOf>
        <name>Nexus osc thirdparty</name>
        <url>http://maven.oschina.net/content/repositories/thirdparty/</url>
    </mirror>
</mirrors>

 

推薦幾個國內的鏡像地址：

http://maven.oschina.net/content/groups/public/

http://maven.oschina.net/content/repositories/thirdparty/

http://repo2.maven.org/maven2/

如果在下載的時候還是覺得慢的話，請自行百度其他地址。

打開Eclipse，在菜單選擇：windows->Preference->Maven->User Settings，在右側User Settings選擇剛才的settings.xml文件：

 

配置后，下面步驟在pom.xml配置的依賴包就會從遠程倉庫下載到本地配置的倉庫：F:\repository

四、安裝Eclipse testNG插件，在菜單欄選擇help->Eclipse Maketplace,搜索testng，安裝，重啟Eclipse

 

五、開始創建Maven工程，選擇Archetype，輸入Group Id、Artifact Id，finish創建完成，如下圖：

 

 

創建完成后是這樣的：

 

 

六、配置依賴包，Appium需要三個包：appium client、selenium client、selenium server，如果我們不用maven構建工程，那么我們需要去下載這三個包，然后添加到我們的工程中，而maven不需要了，只需要配置依賴關系就可以了，我們可以在maven倉庫中搜索我們需要的包，把他們的依賴關系寫到pom.xml文件中：

maven倉庫地址：http://mvnrepository.com/，例如搜索appium，就可以搜索到appium java client的包，選擇最新的包，把依賴關系粘貼打pom.xml中，selenium client和selenium server只需要配置一個selenium依賴就行了，配置后的pom.xml文件如下：

 

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.zdx.appium</groupId>
  <artifactId>num1</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>num1</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>3.4.0</version>
</dependency>
<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>6.9.10</version>
</dependency>
    
  </dependencies>
</project>

配置后保存，會自動更新依賴包，如果沒有更新也可以在右鍵選中工程，選擇Maven-Update Project，進行更新。更新完成后，你就發現你的Maven Dependencies多了很多jar包

七、創建TestNG測試類，因為是Appium項目，所以我把源代碼放在了src/test/java目錄下，選中目錄，右鍵選擇New->Other->TestNG->TestNG Class

創建完成后的目錄結構：

八、下面就開始寫Appium代碼吧，下面是我寫的一個demo，app是我自己寫的一個測試demo

APP截圖：

          

 

測試代碼：

package com.zdx.appium.num1;

import org.testng.Assert;
import org.testng.annotations.Test;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.AfterTest;

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.AndroidElement;

import java.io.File;
import java.io.UnsupportedEncodingException;
import java.net.URL;
import java.sql.Driver;
import java.sql.Time;
import java.util.List;
import java.util.Random;

import mx4j.log.Log;

import org.apache.bcel.generic.RETURN;
import org.junit.After;
import org.junit.Before;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.logging.LogEntry;
import org.openqa.selenium.logging.LoggingHandler;
import org.openqa.selenium.logging.LoggingPreferences;
import org.openqa.selenium.logging.Logs;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.remote.RemoteWebDriver;
import org.openqa.selenium.remote.server.log.LoggingManager;
import org.openqa.selenium.remote.server.log.LoggingOptions;
import org.testng.asserts.LoggingAssert;
    

public class NumFirst {
    private AndroidDriver<AndroidElement> driver;
  @BeforeTest
  public void setUp() throws Exception{
      /* File classpathRoot = new File(System.getProperty("user.dir"));
      System.out.println(classpathRoot);
      File appDir = new File(classpathRoot, "/apps");
      File app = new File(appDir, "");*/
      DesiredCapabilities capabilities = new DesiredCapabilities();
      
      capabilities.setCapability("deviceName","udid");
      capabilities.setCapability("platformVersion", "4.4");
      capabilities.setCapability("udid","YT91050HXZ");
      //capabilities.setCapability("app", app.getAbsolutePath());
      capabilities.setCapability("appPackage", "com.example.yadudemo");
      capabilities.setCapability("appActivity", ".MainActivity");
      //capabilities.setCapability("appActivity", ".ui.activity.UPlusMainActivity");
  driver = new AndroidDriver<>(new URL("http://127.0.0.1:4726/wd/hub"), capabilities);
  }
  @Test
  public void test() throws UnsupportedEncodingException {
      //驗證APP啟動成功，並且MainActivity打開
      if(activityVerify(8000, driver, ".MainActivity")==true)
      {
          System.out.println(driver.currentActivity().toString());
          Assert.assertEquals(driver.currentActivity().toString(), ".MainActivity");
          AndroidElement bt_config = driver.findElementByName("配置");
          bt_config.click();
          //驗證ConfigActivity打開
          if(activityVerify(3000, driver, ".ConfigActivity")==true)
          {
              Assert.assertEquals(driver.currentActivity().toString(), ".ConfigActivity");
              List<AndroidElement> et_List = driver.findElementsByClassName("android.widget.EditText");
              //輸入密碼
              et_List.get(1).clear();
              et_List.get(1).sendKeys("12345678");
              //驗證輸入密碼正確
              Assert.assertEquals(et_List.get(1).getText(), "12345678");
              //輸入超時時間
              et_List.get(2).clear();
              et_List.get(2).sendKeys("12");
              //驗證超時時間輸入正確
              Assert.assertEquals(et_List.get(2).getText(), "12");
              //如果button被鍵盤遮擋，關閉鍵盤
              if(driver.findElementsByName("開始配置").isEmpty())
              {
                  driver.pressKeyCode(4);
              }
              //點擊開始配置
              AndroidElement bt_start_config = driver.findElementByName("開始配置");
              bt_start_config.click();
          }
      }
      //關閉APP
      closeApp();
      //驗證APP已經關閉
      Assert.assertNotEquals(driver.currentActivity().toString(), ".ConfigActivity");
      Assert.assertNotEquals(driver.currentActivity().toString(), ".MainActivity");       
  }

  @AfterTest
  public void tearDown() {
      driver.quit();
  }
  //線程等待方法
  public void appWait(long time)
  {
      try {
          Thread.sleep(time);
      } catch (InterruptedException e) {
          // TODO Auto-generated catch block
          e.printStackTrace();
      }
  }
  //關閉APP方法
  public void closeApp()
  {
      for(int h=0;h<6;h++)
      {
          driver.pressKeyCode(4);
      }
  }
  //驗證activity方法
 public Boolean activityVerify(long time,AndroidDriver<AndroidElement> tdriver,String activity)
 {
         for(int i=1;i<time/1000;i++){
             appWait(1000);
             if(tdriver.currentActivity().equals(activity))
             {
                 return true;
             }    
         }
         System.out.println("can not find "+activity);
         return false;
     
 }
}

啟動Appium Server，連接手機（我手機已經安裝了測試demo APP），右鍵選中num1工程，選擇Run As->TestNG Test，運行后，會在工程目錄下創建一個test-output的文件夾，打開文件夾下的index.html可以查看測試結果，也可以在Eclipse的Console中查看結果，如下圖：

這個報告很簡陋，下面開始用ReportNG替換TestNG的報告

 

九、使用ReportNG生成報告

1、添加依賴，在pom.xml文件中添加下列依賴關系：

        <dependency>
            <groupId>org.uncommons</groupId>
            <artifactId>reportng</artifactId>
            <version>1.1.4</version>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.testng</groupId>
                    <artifactId>testng</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>com.google.inject</groupId>
            <artifactId>guice</artifactId>
            <version>4.0</version>
            <scope>test</scope>
        </dependency>        

 

2、配置maven-surefire-plugin並加入reportNG listenser

    <build>
        <plugins>
        <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.17</version>
                <configuration>
                    <suiteXmlFiles>
                        <suiteXmlFile>xmlfile/testng.xml</suiteXmlFile>
                    </suiteXmlFiles>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.19.1</version>
                <configuration>
                    <properties>
                        <property>
                            <name>usedefaultlisteners</name>
                            <value>false</value>
                        </property>
                        <property>
                            <name>listener</name>
                            <value>org.uncommons.reportng.HTMLReporter, org.uncommons.reportng.JUnitXMLReporter</value>
                        </property>
                    </properties>
                    <workingDirectory>target/</workingDirectory>
                </configuration>
            </plugin>
        </plugins>
    </build>

 

注意這句：<suiteXmlFile>xmlfile/testng.xml</suiteXmlFile>，我在工程目錄下新建了一個文件夾，把testng的xml文件都放在這個目錄下，如果有多個testng.xml文件的話，這樣更直觀，如果只有一個的話，不建文件夾也可以。

如果看不懂的話，請百度maven-surefire-plugin參數說明

3、更新一下Maven Project，然后右鍵選中Maven工程，選擇Run As->Maven Test，運行成功后，在target目錄下創建了一個surefire-reports目錄，打開它下面的html文件夾，打開indel.xml，就可以看到相對美觀的報告形式了：

reportNG報告樣式是可以自定義的，我的報告中還有亂碼，以后會慢慢研究。