基于APPIUM测试微信公众号的UI自动化测试框架(结合Allure2测试报告框架)

框架初衷

前两周组内的小伙伴跟我说她现在测试的微信公众号项目(保险)每次上新产品时测试起来很费时,存在大量的重复操作(点点点),手工测试每个产品可能需要半天到一天的时间,复杂的产品需要两天。
由于保险下单的过程中字段比较多,输入费劲的同时测试用例也很多(不同年龄段、工种、有无社保等),且!每个产品的页面都有部分差异!
问我能否基于UI自动化提高她测试新产品的测试速度,同时用于上线时生产的验证。
因为我写过微信公众号页面的UI监控脚本,也尝试过基于appium的多机并发测试,于是我就想,能否搭建一个框架,让小伙伴每次测试新产品的时候只要输入测试数据+修改产品差异部分代码,然后框架分发给不同的手机去执行,最后展示测试报告?

最终效果

一个case大约3-5分钟,三台手机执行测话三个新产品半天就能测完。
下面是放到jenkins上运行demo的测试报告。



下面是用例运行失败时的界面,提供截图、重试、case日志以及appium的日志。


框架介绍

1.主要工具

JAVA 版本1.8
appium-server 版本1.6.3
appium java-client 版本5.0.0-BETA8
testNG 用例组织
Allure2 测试报告
Jenkins 持续集成
Git 代码管理

2.工程目录及主要代码


pages:没有采用PO模式,页面以接口的形式定义,页面元素即为变量。
pageoptions:页面功能封装在pageoptions包中,封装成静态方法。
testcase:继承BaseDriver,driver初始化后即可执行测试。
util:appiumserver启动工具类、失败自动截图等

下面是每个package内的代码。

2.1 POM.XML

<?xml version="1.0" encoding="UTF-8"?>

<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.cpeoc</groupId>
    <artifactId>jyx</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <name>jyx</name>

    <properties>
        <java.version>1.7</java.version>
        <aspectj.version>1.8.10</aspectj.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.testng</groupId>
            <artifactId>testng</artifactId>
            <version>6.11</version>
        </dependency>
        <dependency>
            <groupId>io.appium</groupId>
            <artifactId>java-client</artifactId>
            <version>5.0.0-BETA8</version>
        </dependency>

        <dependency>
            <groupId>io.qameta.allure</groupId>
            <artifactId>allure-testng</artifactId>
            <version>2.0-BETA14</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.hamcrest</groupId>
            <artifactId>hamcrest-all</artifactId>
            <version>1.3</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>1.7.21</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>dom4j</groupId>
            <artifactId>dom4j</artifactId>
            <version>1.6.1</version>
        </dependency>
        <dependency>
            <groupId>com.belerweb</groupId>
            <artifactId>pinyin4j</artifactId>
            <version>2.5.1</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.3</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.18.1</version>
                <configuration>
                    <testFailureIgnore>true</testFailureIgnore>
                    <argLine>
                        -javaagent:"${settings.localRepository}/org/aspectj/aspectjweaver/${aspectj.version}/aspectjweaver-${aspectj.version}.jar"
                    </argLine>
                    <suiteXmlFiles>
                        <suiteXmlFile>testng-OnePhone.xml</suiteXmlFile>
                    </suiteXmlFiles>
                    <!-- <workingDirectory>target\</workingDirectory> -->
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>org.aspectj</groupId>
                        <artifactId>aspectjweaver</artifactId>
                        <version>${aspectj.version}</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>

</project>

2.2pageoptions包

package com.cpeoc.jyx.pageoptions;

import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.ui.WebDriverWait;
import org.testng.Assert;

import com.cpeoc.jyx.pages.Index;
import com.cpeoc.jyx.util.PinYinUtil;
import com.cpeoc.jyx.util.WaitUtil;

import io.appium.java_client.AppiumDriver;

/**
 * 首页通用功能实现类
 * @author ken
 * @date 2018年6月15日
 */
public class IndexOp {
    /**
     * 切换到指定城市
     * @param driver
     * @param wait
     * @param cityName 城市名
     */
    public static void switchCity(AppiumDriver<WebElement> driver,WebDriverWait wait,String cityName){
        
        String firstWordtOfCity = PinYinUtil.getFirstWordFromChinese(cityName);
        String cityNameXpath = "//*[contains(text(),'"+cityName+"')]";
        String cityPinYinXpath = "//*[contains(text(),'"+firstWordtOfCity+"')]";
        WaitUtil.waitElementByXpath(wait, Index.LOCATE).click();
        WaitUtil.waitElementByXpath(wait, cityPinYinXpath).click();
        WaitUtil.waitElementByXpath(wait, cityNameXpath).click();
        WebElement locate = WaitUtil.waitElementByXpath(wait, Index.LOCATE);
        Assert.assertEquals(locate.getText(), cityName, "城市切换有bug!");
        
    }
    
}

2.3pages包

package com.cpeoc.jyx.pages;
/**
 * 简易险首页
 * @author ken
 * @date 2018年6月8日
 * @see 
 *  首页用到的元素全部定义在这里,用xpath保存
 */
public interface Index {
    
    /**
     * 全国站切换确认窗口
     */
    String ALERT_BTN = "//*[@class='alert-btn']";
    
    /**
     * 定位城市
     */
    String LOCATE = "//*[contains(@class,'locate')]";
    
    /**
     * 意外险
     */
    String  ACCIDENT ="//a[contains(@href,'categoryCode=1000')]";
    
    /**
     * 健康险
     */
    String  HEALTH ="//a[contains(@href,'categoryCode=1300')]";
    
    /**
     * 财产险
     */
    String  PROPERTY ="//a[contains(@href,'categoryCode=1200')]";
    
    /**
     * 旅游险
     */
    String  TOURISM ="//a[contains(@href,'categoryCode=1100')]";
    
    /**
     * 航空险
     */
    String  AVIATION ="//a[contains(@href,'categoryCode=1103')]";

}

2.4testcase包

一个简单case。

package com.cpeoc.jyx.testcases.index;

import io.qameta.allure.Description;
import io.qameta.allure.Epic;

import org.testng.annotations.Test;

import com.cpeoc.jyx.pageoptions.IndexOp;
import com.cpeoc.jyx.util.BaseDriver;

/**
 * 城市定位 -- 切换
 * 
 * @author ken
 * @date 2018年6月12日
 * @see 测试微信号:王九 东莞切换到重庆 分组:wangjiu
 */
@Epic("城市定位")
public class TestCitySelect extends BaseDriver {

    @Test(groups = { "wangjiu" })
    @Description("测试城市切换")
    public void testCitySelect() {
        System.out.println("运行测试用例------------------TestCitySelect");
        // 1.点击城市进入城市选择页。点击C-重庆市
        IndexOp.switchCity(driver, wait, "重庆市");

    }

}

产品下单case。

package com.cpeoc.jyx.testcases.insbuy;


import io.qameta.allure.Description;
import io.qameta.allure.Epic;
import io.qameta.allure.Story;

import org.openqa.selenium.WebElement;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;

import com.cpeoc.jyx.pageoptions.CommonPageOp;
import com.cpeoc.jyx.pageoptions.IndexOp;
import com.cpeoc.jyx.pages.BaiWanAnXinLiao;
import com.cpeoc.jyx.pages.Common;
import com.cpeoc.jyx.util.BaseDriver;
import com.cpeoc.jyx.util.WaitUtil;

/**
 * 百万安心疗-重庆
 * @author ken
 * @date 2018年6月14日
 */
@Epic("产品后买")
@Story("百万安心疗-重庆")
public class TestBaiWanAnXinLiao extends BaseDriver{
    
    @Test(dataProvider = "data",groups={"wangjiu"})
    @Description("百万安心疗-重庆-购买流程")
    public void testBaiWanAnXinLiao(String cityName,String disctName,
            String insStartDate,String apltName,String apltCretNo,String apltCellPhone,
            String email,String isrdRelation,String hasSocialSecurity,String province,String expect) {
        
        
        System.out.println("运行测试用例------------------TestBaiWanAnXinLiao");
        
        // 1.点击城市进入城市选择页。点击C-重庆市
        IndexOp.switchCity(driver, wait,cityName);
        
        // 2.点击百万安心医疗,选择基础版,点击购买
        //WaitUtil.waitElementByXpath(wait, BaiWanAnXinLiao.name).click();
        WebElement bwaxl = WaitUtil.waitElementByXpath(wait, BaiWanAnXinLiao.NAME);
        while(true){
            if(bwaxl.isEnabled()){
                break;
            }   
        }
        bwaxl.click();
        
        WaitUtil.waitElementByXpath(wait, Common.BUG).click();
        
        // 3.选择日期控件直接输入起保日期
        WaitUtil.waitElementByXpath(wait, Common.INS_START_DATE).click();
        CommonPageOp.datePicker(driver, wait, insStartDate);
        
        // 4.选择投保地区
        WaitUtil.waitElementByXpath(wait, Common.AREA_FULL_NAME).click();
        String disctXpath = "//*[contains(text(),'"+disctName+"')]";
        WaitUtil.waitElementByXpath(wait, disctXpath).click();
        
        // 5.输入投保人信息
        WebElement elApltName = WaitUtil.waitElementByXpath(wait, Common.APLT_NAME);
        elApltName.click();
        elApltName.sendKeys(apltName);
        WebElement elApltCretNo = WaitUtil.waitElementByXpath(wait, Common.APLT_CRETNO);
        elApltCretNo.click();
        elApltCretNo.sendKeys(apltCretNo);
        WebElement elApltCellPhone = WaitUtil.waitElementByXpath(wait, Common.APLT_CELLPHONE);
        elApltCellPhone.click();
        elApltCellPhone.sendKeys(apltCellPhone);
        //上滑
        CommonPageOp.swipeUpOnWebview(driver, wait);
        
        WebElement elEmail = WaitUtil.waitElementByXpath(wait, Common.APLT_EMAIL);
        elEmail.click();
        elEmail.sendKeys(email);
        WaitUtil.waitElementByXpath(wait, Common.IS_RELATION).click();
        CommonPageOp.selectRelation(driver, wait, isrdRelation);
        //被保人信息     
        String socialSecurityXpath = "//*[text()='"+hasSocialSecurity+"']";
        WaitUtil.waitElementByXpath(wait, socialSecurityXpath).click();
        WaitUtil.waitElementByXpath(wait, Common.PROVINCE).click();
        CommonPageOp.chooseProvince(driver, wait, province);
    
        //点击确定
        WaitUtil.waitElementByXpath(wait, Common.CONFIRM).click();
        
        System.out.println("离开测试用例------------------TestBaiWanAnXinLiao");
    }

    @AfterMethod
    public void backToIndex(){
        System.out.println("AfterMethod-----------------------------------");
        //点击左上角关闭按钮,点击公众号菜单,进入简易险
        CommonPageOp.backToIndex(driver, wait);
        
    }
    
    @DataProvider(name = "data")
    public Object[][] data() {
        return new Object[][] {
                { "重庆市" /**城市*/,"彭水苗族土家族自治县"/**城区*/,"2018-7-10"/**起保日期*/,"陆xx"/**投保人姓名*/,
                "450121199010******"/**投保人身份证号*/,"1589990***2"/**投保人手机号*/,"1054057***@qq.com"/**邮箱*/,
                "本人"/**与被保人关系*/,"无"/**有无社保"*/,"重庆市-万盛区"/**省市*/,"期望结果"},

                };
    }
}

2.5util包

失败自动截图。

package com.cpeoc.jyx.util;

import io.appium.java_client.AppiumDriver;
import io.qameta.allure.Attachment;

import org.openqa.selenium.OutputType;
import org.openqa.selenium.WebElement;
import org.testng.IHookCallBack;
import org.testng.IHookable;
import org.testng.ITestResult;
/**
 * 失败自动截图监听类
 * @author ken
 * @date 2018年6月21日
 * @see
 *  继承testng的接口
 *  使用Allure附件注解
 */
public class AllureReporterListener implements IHookable {

    @Override
    public void run(IHookCallBack callBack, ITestResult testResult) {
        callBack.runTestMethod(testResult);
        if (testResult.getThrowable() != null) {
            try {
                //takeScreenShot(testResult.getMethod().getMethodName());
                takeScreenShotA(testResult);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

    @Attachment(value = "失败截图", type = "image/png")
    private byte[] takeScreenShotA( ITestResult testResult) throws Exception {
        System.out.println("-----------监听到用例运行失败,截图------------");
        BaseDriver b = (BaseDriver) testResult.getInstance();
        AppiumDriver<WebElement> driver = b.getDriver();
        driver.context(Config.NATIVE_CONTEXT);
        System.out.println("-----------切换context到NATIVE_APP---------");
        return driver.getScreenshotAs(OutputType.BYTES);
    }

}

2.6testng.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">

<suite name="简易险测试用例集" parallel="tests">
    <listeners>
        <listener class-name="com.cpeoc.jyx.util.AllureReporterListener"/>
    </listeners>
    
    <test name="wangjiu">
        <!-- 这里是手机信息 -->
        <parameter name="deviceName" value="28a38e6f" />
        <parameter name="platformVersion" value="5.1" />
        <!-- 这里是要调试的测试类  -->
        <classes>
            <class name="com.cpeoc.jyx.testcases.index.TestCitySelect" />
            <class name="com.cpeoc.jyx.testcases.index.TestCityDG" />
            <class name="com.cpeoc.jyx.testcases.insBuy.TestBaiWanAnXinLiao"/>
        </classes>  
    </test>
    <test name="miaomiao">
        <!-- 这里是手机信息 -->
        <parameter name="deviceName" value="fe3123d2" />
        <parameter name="platformVersion" value="7.0" />
        <!-- 这里是要调试的测试类 --> 
        <classes>
            <class name="com.cpeoc.jyx.testcases.index.TestCityQG" />
            <class name="com.cpeoc.jyx.testcases.insBuy.TestBaiWanAnXinLiao"/>      
        </classes>  
    </test>
</suite>

最后

当然,里边还有很多具体的业务和代码实现没有介绍,只是给有需要的同学一点借鉴,欢迎交流。