Page Object 模式编写UiAutomator脚本

在我们学习Page Object Model之前，我们先了解一下Page Object Model（以下简称POM）.

为什么要POM

用UiAutomator启动UI自动化测试不是一件困难的任务。你只需要查找元素，对元素操作就可以了。来看一个登录APP的简单的脚本。

package com.gqou.testdemo;

import android.support.test.InstrumentationRegistry;
import android.support.test.runner.AndroidJUnit4;
import android.support.test.uiautomator.UiDevice;
import android.support.test.uiautomator.UiObject;
import android.support.test.uiautomator.UiSelector;

import org.junit.Test;
import org.junit.runner.RunWith;

import static junit.framework.TestCase.assertEquals;

/**
 * Created by guangqian on 2016/4/22.
 */
@RunWith(AndroidJUnit4.class)
public class SimpleTest {

@Test
    public void 测试登录成功() throws Exception{
//        查找图标并点击启动app
        UiDevice uiDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation());
        uiDevice.findObject(new UiSelector().text("TestDemo")).clickAndWaitForNewWindow();
//        输入用户名，密码并点击Login
       UiObject usernameObj = uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/name_txt"));
        UiObject pwdObj = uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/pwd_txt"));
        UiObject loginBtn = uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/login_btn"));
        UiObject welcomeTip = uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/welcome_tip"));

        usernameObj.click();
        usernameObj.setText("username");
        pwdObj.click();
        pwdObj.setText("password");

        loginBtn.clickAndWaitForNewWindow();

//        校验登录成功信息
        assertEquals("congratulations", welcomeTip.getText());
    }
}

你可以看到，我们所做的就是查找元素并为那些元素填值，点击等操作。

这是一个比较简单的脚本，脚本维护看起来也很容易。但是随着时间增长，你会编写更多的脚本代码，维护也会变得越来越困难。

脚本维护的主要面临的问题就是：比如有10份脚本使用同一个界面元素，一旦界面元素发生了变化，你需要更改10份脚本。这不仅浪费时间而且还很容易出错。

本文介绍的脚本维护比较好的方法就是针对元素的查找，操作等操作来创建一个独立的类文件。这个类文件可以被使用那些元素的所有脚本重用。将来如果界面元素发生变化，只需要修改一份类文件就可以了，不需要再去修改10份脚本文件。

这个方法就叫做Page Object Model。它可以让我们的代码更加易于阅读，维护和重用。

   

什么是POM

1. Page Object Model是一种设计模式，为界面对象创建一个对象库

2. 在这个模式下，应用的每一个界面都应该有一个相应的界面类

3. 界面类会查找界面的元素也包含对元素操作的方法

4. 方法的命名应该根据它的行为来命名，例如：如果程序等待支付网关出现在界面上，方法应该被命名类似waitForPaymentScreenDisplay().

 

POM的优点

1. POM意味着对界面上的元素的操作从原来的测试用例代码中分离出来，这样使我们的代码清晰并且易于理解。

2. 第二个好处是对象库是独立的。因此我们可以通过不同的工具使用相同的对象库来达到不同的目的。比如：我们可以集成TestNG/JUnit来做功能测试，同时也可以使用JBehave/Cucumber做验收测试。

3. 由于方法的可重用，我们的代码会变得更少，有效性更高。

4. 方法能真实的映射出用户在界面上的操作行为，比如：点击过按钮之后并跳到主界面，方法名就会类似"gotoHomePage".

 

怎么实现POM

POM的基本结构是应用的所有元素和元素的操作方法都被封装在一个类文件中，测试用例代码只需要调用这个类文件中的方法即可。

 

完整的例子：

 

第一步：打开应用app

第二步：输入用户名，密码，点击Login

第三步： 验证登录成功

 

有两个界面：登录界面，欢迎界面，所以我们要创建两个界面的类文件LoginActivity，WelcomeActivity

 

LoginActivity.java

package com.gqou.testdemo.pages;

import android.support.test.uiautomator.UiDevice;
import android.support.test.uiautomator.UiObject;
import android.support.test.uiautomator.UiSelector;

/**
 * Created by guangqian on 2016/4/22.
 */
public class LoginActivity {

    UiDevice uiDevice;
    UiObject mUserName;
    UiObject mPasswd;
    UiObject mLogin;

    public LoginActivity(UiDevice uiDevice){
        this.uiDevice = uiDevice;
        mUserName = this.uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/name_txt"));
        mPasswd = this.uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/pwd_txt"));
        mLogin = this.uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/login_btn"));
    }

    /**
     * 输入用户名
     * @param userName
     * @throws Exception
     */
    private void setmUserName(String userName) throws Exception{
        mUserName.click();
        mUserName.setText(userName);
    }

    /**
     * 输入密码
     * @param pwd
     * @throws Exception
     */
    private void setmPasswd(String pwd) throws Exception{
        mPasswd.click();
        mPasswd.setText(pwd);
    }

    /**
     * 点击登录按钮
     * @throws Exception
     */
    private void clickLogin()throws Exception{
        mLogin.clickAndWaitForNewWindow();
    }

    /**
     * 封装登录App操作
     * @param username
     * @param pwd
     * @throws Exception
     */
    public void loginApp(String username, String pwd) throws Exception{
        this.setmUserName(username);
        this.setmPasswd(pwd);
        this.clickLogin();
    }
}

WelcomeActivity.java

package com.gqou.testdemo.pages;

import android.support.test.uiautomator.UiDevice;
import android.support.test.uiautomator.UiObject;
import android.support.test.uiautomator.UiSelector;

/**
 * Created by guangqian on 2016/4/22.
 */
public class WelcomeActivity {
    UiDevice uiDevice;
    UiObject welcomeTip;

    public WelcomeActivity(UiDevice uiDevice){
        this.uiDevice = uiDevice;
        welcomeTip = this.uiDevice.findObject(new UiSelector().resourceId("com.gqou.testdemo:id/welcome_tip"));
    }

    /**
     * 获取欢迎提示语内容
     * @return
     * @throws Exception
     */
    public String getWelcomeTip() throws Exception{
        return welcomeTip.getText();
    }

}

POMForLoginTest.java

package com.gqou.testdemo.testcases;

import android.support.test.InstrumentationRegistry;
import android.support.test.runner.AndroidJUnit4;
import android.support.test.uiautomator.UiDevice;
import android.support.test.uiautomator.UiSelector;

import com.gqou.testdemo.pages.LoginActivity;
import com.gqou.testdemo.pages.WelcomeActivity;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

import static junit.framework.TestCase.assertEquals;
/**
 * Created by guangqian on 2016/4/22.
 */
@RunWith(AndroidJUnit4.class)
public class POMForLoginTest {

    public static UiDevice uiDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation());
    private static LoginActivity objLogin;
    private static WelcomeActivity objWelcome;


    @Before
    public void setUp() throws Exception {
//        打开应用
        uiDevice.findObject(new UiSelector().text("TestDemo")).clickAndWaitForNewWindow();
//        创建界面实例对象
        objLogin = new LoginActivity(uiDevice);
        objWelcome = new WelcomeActivity(uiDevice);

    }



    @Test
    public void 测试App登录成功() throws Exception {
//        登录app
        objLogin.loginApp("Tom", "123456");
//        获取主界面提示语
        String tips = objWelcome.getWelcomeTip();
//        判断提示语是否为预期
        assertEquals("congratulations", tips);
    }
}

 Good Luck!

水平有限，欢迎各位大牛点评，多谢支持！