基于Appium的自动化case开发及case分层结构设计

首先为每条case创建一个公共的基类AppiumTestBase，内含setup和teardown两个方法，以后每条case继承该基类即可。代码如下：

public class AppiumTestBase {    
  public WebDriverWait webwait;    
private AndroidDriver driver;    
@Before    
public void setUp() throws Exception {        
File classpathRoot = new File(System.getProperty("user.dir"));        
File appDir = new File(classpathRoot, "apps");        
File app = new File(appDir, Config.CURRENT_BANK);        
DesiredCapabilities capabilities = new DesiredCapabilities();        capabilities.setCapability("deviceName",Config.DEVICE_NAME);        capabilities.setCapability(CapabilityType.BROWSER_NAME, "");        capabilities.setCapability(CapabilityType.VERSION, "5.0.1");        capabilities.setCapability("platformName", "android");        
capabilities.setCapability("app", app.getAbsolutePath());        
capabilities.setCapability("udid", Config.DEVICE_NAME);//adb devices获得的值        
driver = new AndroidDriver(new URL("http://127.0.0.1:"+Config.APPIUM_PORT+"/wd/hub"), capabilities);        
webwait = new WebDriverWait(driver,10);        
DriverManager.init(driver);        
DriverManager.initWebWait(webwait);        
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);    
}    
@After    
public void tearDown() throws Exception {        
driver.quit();    
}

setup操作包含导入待测应用apk包，设置与Appium Server连接所需参数，并初始化AndroidDriver对象。以标版登录case为例，其需要继承AppiumTestBase，代码如下：

package com.incito.appiumdemo;
import org.junit.After;
import org.junit.Before;
import org.openqa.selenium.remote.CapabilityType;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.support.ui.WebDriverWait;
import java.io.File;
import java.net.URL;
import java.util.concurrent.TimeUnit;
import io.appium.java_client.android.AndroidDriver;
public class AccountLogin extends AppiumTestBase{    
/**     
* case 编号 AccountLogin_001     
* ****@throws ****Exception     
*/    
@Test    
public void testAccountLogin() throws Exception {        
Account.*getInstance*().gotoLoginPage();        
Account.*getInstance*().doLogin();    
}
/**     
* case 编号 AccountLogin_002     
* ****@throws ****Exception     
*/   
@Test    
public void testLoginout() throws Exception {        
Account.*getInstance*().gotoGestureLoginPage();        
Account.*getInstance*().doGestureLogin(Config.*CURRENT_USERNAME*);        
Personal.*getInstance*().doLogout();    
}

testAccountLogin Case中，执行了两步操作：进入登录页面；执行登录操作。这两步操作都封装在Account类里面。由此引入自动化case的分层设计框架，如下图：

Paste_Image.png

自动化开发过程中，经常遇到的一个问题是，随着产品的不断更新迭代，APP的UI会不断发生变化，自动化如何去应对这样的变化，如何降低其维护代价。case分层设计主要是基于自动化可维护性的考虑，可维护性是功能自动化最重要的评价指标之一，其直接决定了自动化是否能开展下去。试想case数量达到一定程度时，若没有采用封装、分层的设计思路，极有可能出现“牵一发而动全身”的问题。下图是标版自动化case的分层目录图。

Paste_Image.png

下面以登录case为例，详细了解其分层调用关系。登录case在cases层的AccountLogin类中，其代码上面已经展示，回到testAccountLogin Case的操作，第二步操作为Account.getInstance().doLogin();即在登录页面执行登录操作，其封装在business层的Account类中，代码片段如下：

public void doLogin(){    
LoginUiAction.*getInstance*().enterUsername(Config.*CURRENT_USERNAME*);    LoginUiAction.*getInstance*().enterPassword(Config.*CURRENT_PASSWORD*);    LoginUiAction.*getInstance*().clickLogin();    
HomeUiAction.*getInstance*().clickOnCancelGesture();    
Assert.*assertTrue*(LoginUiAction.*getInstance*().isLogin());
}

doLogin()方法中执行了“输入用户名；输入密码；点击登录按钮；判断登录是否成功”操作，显然这几步操作都在UI层LoginUiAction类中。我们再查LoginUiAction.getInstance().
enterUsername()方法中做了什么，代码片段如下：

//输入用户名
public void enterUsername(String username){    
WebElement wl = DriverManager.*getInstance*().findElementById(packagename +    
      ":id/login_input_account");    
 wl.clear();   
 wl.sendKeys(username);
}

enterUsername()方法中，先根据id定位用户名输入框，然后清空输入框，再输入用户名，这些操作都是Appium Client中提供的API。至此演示了登录case的分层调用过程：cases—>business—>ui—>api。按照分层结构，只要业务逻辑不变，case维护任务主要放在ui层，上层无需改动，如此可极大减少case的维护代价。
在doLogin()方法中有一个“判断登录是否成功”的操作，断言操作是自动化测试用例中必不可少的一部分，下面就开始介绍自动化测试用例的书写规范。

自动化测试用例书写规范及注意事项

一条case一般需要包括如下几个要素：

数据准备
具体操作
验证点
清楚操作结果

数据准备指提前准备测试账号，假数据等；具体操作得按照业务测试同学提供的文本case来转化；验证点指自动化操作后，UI前后的变化点，比如登录后，首页会出现用户名、总资产、财富分等控件，这些都是验证点；清楚操作结果主要是基于case独立性的考虑，尽可能做到每条case是独立的，这样某条case fail了，也不会对其他case造成影响，当然这样会增加case的粒度，case稳定性会受影响，两者之间可自行平衡。
下面介绍case开发的注意事项：

元素定位
- ID(首选)
- 文本
- 控件类型
- 坐标
UI操作需要合理的sleep
case独立性
封装常用操作
注释及case前写明操作步骤

元素定位有ID/文本/控件类型/坐标四种方式，推荐使用ID,因为只要某个控件还存在，其ID变化的可能性很小，若其位置发生了变动，case都无需维护。
下面给出查找元素ID的几种方法：uiautomatorviewer/hierarchyviewer/源码。uiautomatorviewer和hierarchyviewer工具在Android SDK中，配置好环境变量后，直接在命令行输入命令即可打开图形化工具，hierarchyviewer需要手机root，推荐使用uiautomatorviewer。如果有待测应用的源码，也可以通过源码来找ID，当然这种方式比较痛苦，但对熟悉业务及个人成长是有好处的，我最开始就是通过源码来找ID的。
对于一些奇葩的情况，元素ID/文本/控件类型都无法定位时，使用坐标定位绝对好使，但不到万不得已，尽量不用，因为用坐标定位就失去了兼容性，换个手机，case可能会执行失败。
UI操作需要合理的sleep，经常由于网络原因，UI加载需要一定时间，自动化操作过程中需要合理的sleep，sleep时间短了，case会失败，长了又浪费时间。Appium框架中引入了隐式sleep方案，在初始化代码中添加driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);即可，表示每步操作最多等待10s。
case独立性前面已介绍，封装及注释容易理解，不做过多解释。

文／平安云测试平台（简书作者）
原文链接：http://www.jianshu.com/p/497f9ed26189
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。