从一个简单的脚本看Appium——2018-03-28

环境搭建和Appium的运行原理什么的，我这里就不写了，网上一搜一大堆，我们透过从创建一个简单的Appium脚本来分析Appium脚本的组成。
创建项目后，我们先写一个基本的脚本，选择创建JUnit Test Case

新建.png

脚本如下

import java.io.File;
import java.net.URL;
import java.util.concurrent.TimeUnit;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.AndroidKeyCode;

public class ContactsTest
{

    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, "RandomContant.apk");
        DesiredCapabilities capabilities = new DesiredCapabilities();
        capabilities.setCapability("deviceName", "Android Devices");
        capabilities.setCapability("udid", "emulator-5554");
        capabilities.setCapability("platformName", "Android");
        capabilities.setCapability("platformVersion", "6.0"); 
        capabilities.setCapability("NoReset", true);   
        capabilities.setCapability("app", app.getAbsolutePath());
        driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
        
        System.out.println("App is launched!");
    }
    
    @Test
    public void test() throws InterruptedException
    {
        WebElement el = driver.findElement(By.name("生成"));
        el.click();
        
        System.out.println("App is done!");
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        el= driver.findElementByName("Contacts");
        el.click();
    }

    @After
    public void tearDown()
        throws Exception
    {
        driver.quit();
    }
    

    
}

脚本需要使用到的资源，已上传链接：https://pan.baidu.com/s/1rh0hdA2Zbnehi2x8aYj1eQ 密码：acix

如上以上脚本所示，Appium的java脚本，是建立在JUnit框架基础之上，所以，我创建的时候选择了创建JUnit Test Case，其中脚本类的主体部分，包括三部分，setUp()、test()、tearDown()三个方法部分，其中setUp()为初始启动部分，tearDown()为脚本执行结束后执行部分，而test()为真正的执行部分，如用例的执行动作，均写在test()方法内。

脚本里用到3个注解，均为使用JUnit4的注解：
@Before：初始化方法 对于每一个测试方法都要执行一次（注意与BeforeClass区别，后者是对于所有方法执行一次）
@After：释放资源 对于每一个测试方法都要执行一次（注意与AfterClass区别，后者是对于所有方法执行一次）
@Test：测试方法，在这里可以测试期望异常和超时时间，每执行一次@Test方法，都要执行一次@Before和@After方法

每一个测试方法的调用顺序为：
@Before -> @Test -> @After
这里脚本对应的方法为：
setUp() -> test() -> tearDown()
这三个方法的作用，为@Before、@Test、@After这三个注解的作用一致

然后我们看回脚本，脚本的类下面，有下面一个语句

private AndroidDriver driver;

那么问题来了，AndroidDriver是啥？
有心人可能注意到了脚本最前面导入包的部分有以下语句：

import io.appium.java_client.android.AndroidDriver;

我们从导入的类库里面找到AndroidDriver

image.png

从以上可以知道，AndroidDriver是java-client的jar文件包含的类库里面的一个类，而这个java-client文件是官方提供的，简而言之，AndroidDriver是官方提供的用于appium测试的一个接口类。
那么问题来了，这个AndroidDriver这个接口类，是用来做啥的？与之类似的另外一个接口类AppiumDriver又是做啥的？
我们回到脚本，可以看到关于AndroidDriver的语句

private AndroidDriver driver;
...
driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
...
WebElement el = driver.findElement(By.name("生成"));
...
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        el= driver.findElementByName("Contacts");
...
driver.quit();

其中

driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);

用来初始化AndroidDriver的对象driver，传递两个值，分别为RUL对象new URL("http://127.0.0.1:4723/wd/hub")和DesiredCapabilities的实例化对象capabilities，第一个参数用来传递Appium Server的IP和端口，而第二个参数capabilities用来传递启动脚本时的基本参数，如deviceName、platformName、platformVersion等。

WebElement el = driver.findElement(By.name("生成"));
...
        driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        driver.pressKeyCode(AndroidKeyCode.BACK);
        el= driver.findElementByName("Contacts");
...
driver.quit();

这几个语句的作用是模拟人工的基本操作，如

driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);

是等待时间操作

driver.pressKeyCode(AndroidKeyCode.BACK);

是模拟点击BACK键操作

el= driver.findElementByName("Contacts");

是一个定位元素操作，UI自动化在对一个元素进行操作前，需要先对元素进行定位，才能对特定元素进行操作。
简而言之，AndroidDriver是对UI元素基本操作的接口，如可以通过对AndroidDriver实例化后对象进行滑动、点击、拖拽等操作。

那么AndroidDriver和AppiumDriver之间有什么区别呢？
于是，我们查找到源码

public class AndroidDriver<RequiredElementType extends WebElement> extends AppiumDriver<RequiredElementType> implements
        AndroidDeviceActionShortcuts, HasNetworkConnection, PushesFiles,
        StartsActivity, FindsByAndroidUIAutomator<RequiredElementType>

public abstract class AppiumDriver<RequiredElementType extends WebElement> extends DefaultGenericMobileDriver<RequiredElementType>

查找源码的时候发现上面问题出现的原因，AppiumDriver接口和AndroidDriver接口比较相似，但感觉是作者为了兼容以前版本还有使用AndroidDriver这个类，就直接继承了AppiumDriver，在AppiumDriver基本上再封装一些基本功能。

至此，文章完。