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 Filesapache-maven-3.3.9，在PATH中添加bin的路径：D:Program Filesapache-maven-3.3.9in，

三、配置settings.xml文件，打开maven conf目录下的settings.xml文件，配置maven本地仓库地址，我配置的是F: epository

 

我还配置了镜像的地址，因为从默认的中央仓库下载依赖包太慢了，在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: epository

四、安装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报告样式是可以自定义的，我的报告中还有乱码，以后会慢慢研究。