APP自动化框架LazyAndroid使用手册（3）--核心API介绍

作者：黄书力

概述

      在前一篇博文中，简要介绍了一款安卓UI自动化测试框架LazyAndroid

（http://blog.csdn.net/kaka1121/article/details/53204150）。本文将在此基础上，对框架的核心的API进行说明。

核心API介绍

•LazyDriver 的3个构造函数。

      可以分别针对不同的应用场景选择使用不同的构造函数。使用场景及各参数的意义，代码注释中写得比较清楚了。

    /**     * app测试默认driver     *      * @param AppName     *            (for exapmle: "SimpleApp.apk")     * @param packageName     *            (for exapmle: "simple.app")     * @param activityName     *            (activityName must begin with ".", for exapmle:     *            ".SimpleAppActivity")     * @param platformVersion     *            (for exapmle: "4.2.2")     * @return an AppiumDriver object     * @throws MalformedURLException     */    public LazyDriver(String AppName, String packageName, String activityName,            String platformVersion) throws MalformedURLException {        DesiredCapabilities capabilities = new DesiredCapabilities();        setBasicCapabilities(AppName, packageName, activityName,                platformVersion, capabilities);        driver = new AppiumDriver(new URL("http://127.0.0.1:4723/wd/hub"),                capabilities);    }    /**     * 可以选择测试开始前是否卸载app重新安装，是否清理app中的缓存数据     *      * @param AppName     *            (for exapmle: "SimpleApp.apk")     * @param packageName     *            (for exapmle: "simple.app")     * @param activityName     *            (activityName must begin with ".", for exapmle:     *            ".SimpleAppActivity")     * @param platformVersion     *            (for exapmle: "4.2.2")     * @param bReset     * @return an AppiumDriver object     * @throws MalformedURLException     */    public LazyDriver(String AppName, String packageName, String activityName,            String platformVersion, Boolean bReset)            throws MalformedURLException {        DesiredCapabilities capabilities = new DesiredCapabilities();        setBasicCapabilities(AppName, packageName, activityName,                platformVersion, capabilities);        if (bReset)            capabilities.setCapability("fullReset", "True"); // 测试开始前，卸载app重新安装，清除app数据文件        else            capabilities.setCapability("noReset", "True");        driver = new AppiumDriver(new URL("http://127.0.0.1:4723/wd/hub"),                capabilities);    }    /**     * 浏览器测试使用的driver     *      * @param browseType     * @param platformVersion     * @throws MalformedURLException     */    public LazyDriver(String browseType, String platformVersion)            throws MalformedURLException {        DesiredCapabilities capabilities = new DesiredCapabilities();        setBasicCapabilities(browseType, platformVersion, capabilities);        driver = new AppiumDriver(new URL("http://127.0.0.1:4723/wd/hub"),                capabilities);    }

•手机基本操作

      LazyDriver中封装了安装/重置apk、截屏、获取/设置屏幕方向、按键、回退、滑动、触摸等手机基本操作。

    /* ###################### 手机基本操作 #####################*/    /**     * 安装 android apk     *      * @param appPath     */    public void installApp(String appPath);    /**     * 关闭 android apk     */    public void closeApp();    /**     * 重置 android apk     */    public void resetApp();    /**     * 截屏     *      * @param screenSavePath     */    public void doScreenshot(String screenSavePath);    /**     * 获取屏幕方向(水平，垂直)     *      * @return orientation:LANDSCAPE("landscape"),PORTRAIT("portrait")     */    public ScreenOrientation getOrientation();    /**     * 设置屏幕方向     *      * @param orientation     *            :LANDSCAPE("landscape"),PORTRAIT("portrait") )     */    public void setOrientation(ScreenOrientation orientation);    /**     * 按键操作     *      * @param key:     * AndroidKeyCode int BACK = 4; int BACKSPACE = 67;      * int DEL =67;     * int ENTER = 66; int HOME = 3; int MENU = 82; int     * SETTINGS = 176; int SPACE = 62;     *     public void sendKeyEvent(int key);    /**     * 回退到上一个页面     */    public void goBack();    /**     * 从(fromX, fromY)滑动到(toX, toY)     *      * @param during     */    public void swipeUp;    /**     * 向上滑     *      * @param during     */    public void swipeUp(int during);    /**     * 向上滑 default during = 500     */    public void swipeUp();    /**     * 向下滑     *      * @param during     */    public void swipeDown(int during);    /**     * 向下滑 default during = 500     */    public void swipeDown();    /**     * 向左滑     *      * @param during     */    public void swipeToLeft(int during);    /**     * 向左滑 default during = 500     */    public void swipeToLeft();    /**     * 向右滑     *      * @param during     */    public void swipeToRight(int during);    /**     * 向右滑 default during = 500     */    public void swipeToRight();    /**     * 触摸     *      * @param el     */    public void touch(WebElement el);    /**     * 触摸     *      * @param x     * @param y     */    public void touch(int x, int y);    /**     * 长按     *      * @param el     */    public void longTouch(WebElement el);    /**     * 长按     *      * @param x     * @param y     */    public void longTouch(int x, int y);    /**     * 点击element控件中心点按下，duration*5毫秒秒后松开，如此重复fingers次。     *      * @param fingers     * @param element     * @param duration     */    public void tap(int fingers, WebElement element, int duration);    /**     * 点击(x,y)点按下，duration*5毫秒后松开，如此重复fingers次。     *      * @param fingers     * @param x     * @param y     * @param duration     */    public void tap(int fingers, int x, int y, int duration);

•安卓常见控件的封装

    各个控件类位于lazy.android.controls中；控件的通用方法见基类AbstractControl。其余的没有封装的控件，均可以通过View或者直接使用WebElement来操作。

•带重试机制的元素查找
      使用如下API进行元素查找，如果查找失败，会在设置的时间范围和重试周期内重复查找，如果查找成功则直接返回，可以大大减少因为网络原因导致的元素查找失败，同时又能避免为了解决超时查找而针对所有元素查找都强制pause几秒钟导致的时间开销。

    /* #################### Find 系列操作 ###################### */    /**     * 带超时重试机制的元素查找     *      * @param aDriver     * @param xpath     * @return     */    public WebElement findElementByXpath(String xpath);    /**     * 带超时重试机制的元素查找     *      * @param aDriver     * @param xpath     * @param timeout     * @return     */    public WebElement findElementByXpath(String xpath, Long timeout);    /**     * 带超时重试机制的元素查找     *      * @param aDriver     * @param xpath     * @param timeout     * @param stepInterval     * @return     */    public WebElement findElementByXpath(String xpath, Long timeout,Long stepInterval);    /**     * 根据文字查找控件。遍历GlobalSettings.AndroidCtrType定义的安卓常用的6种控件类型，分别生成xpath进行查找，耗时较长     * ！     *      * @param aDriver     * @param text     * @param timeout     * @return     */    public WebElement findElementByText(String text);    /**     * 根据文字和控件类型查找控件。需要传入准确的安卓控件名称，耗时短，成功率高！     *      * @param aDriver     * @param text     * @param controlTypeName:     * "TextView", "Button", "CheckBox", "RadioButton",     * "ImageView", "ToggleButton", ...     * @return     */    public WebElement findElementByText(String text, String controlTypeName);    /**     * 带超时重试机制的文字捕获     *      * @param expectExist     * @param     * @param timeout     * @throws InterruptedException     * @throws NumberFormatException     */    public void expectTextExistOrNot(boolean expectExist, String text,            int timeout);    /**     * 带超时重试机制的文字捕获     *      * @param expectExist     * @param text     * @throws NumberFormatException     * @throws InterruptedException     */    public void expectTextExistOrNot(boolean expectExist, String text);    /**     * 带超时重试机制的控件查找——通过xpath     *      * @param aDriver     * @param xpath     * @param timeout     * @param stepInterval     * @return     */    private WebElement findElement(String xpath, Long timeout, Long stepInterval);    /**     * 带超时重试机制的控件查找——通过xpath list     *      * @param aDriver     * @param xpathArray2     *            ：xpath arrayList     * @return     */    private WebElement findElement(List<String> xpathArray2);    /**     * 判断控件是否存在，不带超时重试机制     * @return     */    public boolean isExists()；    /**     * 判断控件是否存在——不带超时重试机制     * @param xpath     * @return     */    public boolean isElementPresent(String xpath)；    /**     * 带超时重试机制的控件存在情况判断     * @param expectExist     * @param xpathArray     * @param timeout     */    public void expectElementExistOrNot(boolean expectExist, int timeout)；    /**     * 带超时重试机制的控件存在情况判断     * @param expectExist     * @param xpathArray     * @param timeout     */    public void expectElementExistOrNot(boolean expectExist)；    /**     * 将控件通过xpath蜕化为WebElement对象     * @return     */    public WebElement toWebElement();

总结

    LazyAndroid解决了安卓UI自动化测试实施过程中存在的测试工具学习成本高，控件定位耗时长、准确率低，安卓的具体控件操作方法生疏等诸多问题，简化了appiumDriver中Capabilities的繁琐设置、手机的滑动、按键等基本操作，增加了元素查找的重试机制、异常处理截屏等，能提高安卓自动化测试的实施效率。
    后续将会给出基于LazyAndroid的测试模板工程，并进行详细阐述。