AndroidPageObjectTest_Chained.java

以下代码使用ApiDemos-debug.apk进行测试

//这个脚本用于演示PageFactory的功能：链式注解@AndroidFindBys、@IOSFindBys。具体用法参考页面类的代码。

package com.saucelabs.appium;

import io.appium.java_client.MobileElement;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.pagefactory.AppiumFieldDecorator;
import io.appium.java_client.remote.MobileCapabilityType;

import java.io.File;
import java.net.URL;
import java.util.concurrent.TimeUnit;

import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.support.PageFactory;

import com.saucelabs.appium.page_object.android.ApiDemosListViewScreenByAllPossible;
import com.saucelabs.appium.page_object.android.ApiDemosListViewScreenChaided;
import com.saucelabs.appium.page_object.android.ApiDemosListViewScreenSimple;
import com.saucelabs.appium.page_object.ios.TestAppScreenSimple;

/**
 * Please read about Page Object design pattern here:
 *  https://code.google.com/p/selenium/wiki/PageObjects
 *  
 *  Please look at:
 *  {@link ApiDemosListViewScreenSimple}
 *  {@link ApiDemosListViewScreenChaided}
 *  {@link ApiDemosListViewScreenByAllPossible}
 *  {@link TestAppScreenSimple}
 *
 */
public class AndroidPageObjectTest_Chained {

    private WebDriver driver;
    private ApiDemosListViewScreenChaided apiDemosPageObject;
    
    @Before
    public void setUp() throws Exception {
        //File classpathRoot = new File(System.getProperty("user.dir"));
        File appDir = new File("E:/package");
        File app = new File(appDir, "ApiDemos-debug.apk");
        DesiredCapabilities capabilities = new DesiredCapabilities();
        capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "Android Emulator");
        capabilities.setCapability(MobileCapabilityType.APP, app.getAbsolutePath());
        driver = new AndroidDriver<MobileElement>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
        
        apiDemosPageObject = new ApiDemosListViewScreenChaided();
        PageFactory.initElements(new AppiumFieldDecorator(driver, 5, TimeUnit.SECONDS), 
                apiDemosPageObject);
    }
    
    @After
    public void tearDown() throws Exception {
        driver.quit();
    }
    
    /**
     * Page Object best practice is to describe interactions with target 
     * elements by methods. These methods describe business logic of the page/screen.
     * Here test interacts with lazy instantiated elements directly.
     * It was done so just for obviousness
     */
    
    @Test
    public void androidChainSearchElementsTest(){
        Assert.assertNotEquals(0, apiDemosPageObject.chainElementViews.size());
    }

    @Test
    public void androidChainSearchElementTest(){
        Assert.assertNotEquals(null, apiDemosPageObject.chainElementView.getAttribute("text"));
    }

    @Test
    public void androidOrIOSFindByElementsTest_ChainSearches(){
        Assert.assertNotEquals(0, apiDemosPageObject.chainAndroidOrIOSUIAutomatorViews.size());
    }

    @Test
    public void androidOrIOSFindByElementTest_ChainSearches(){
        Assert.assertNotEquals(null, apiDemosPageObject.chainAndroidOrIOSUIAutomatorView.getAttribute("text"));
    }    
    
    @Test
    public void isAndroidElementTest(){
        Assert.assertNotEquals(null, apiDemosPageObject.androidElementView.getAttribute("text"));
    }    
    
    @Test
    public void areAndroidElementsTest(){
        Assert.assertNotEquals(0, apiDemosPageObject.androidElementViews.size());
    }    
}

页面类的代码如下：

package com.saucelabs.appium.page_object.android;

import io.appium.java_client.android.AndroidElement;

import java.util.List;

import org.openqa.selenium.WebElement;

import io.appium.java_client.pagefactory.AndroidFindBy;
import io.appium.java_client.pagefactory.AndroidFindBys;
import io.appium.java_client.pagefactory.iOSFindBy;
import io.appium.java_client.pagefactory.iOSFindBys;

/**
 * 
 * Here is the common sample shows how to use
 * {@link AndroidFindBys} annotation to describe the chain of the 
 * searching for the target element of a native Android app content.
 * 
 * It demonstrates how to declare screen elements using Appium
 * page objects facilities.
 * 
 * About Page Object design pattern read here:
 * https://code.google.com/p/selenium/wiki/PageObjects
 *
 */
public class ApiDemosListViewScreenChaided {
    
    /**
     * Page Object best practice is to describe interactions with target 
     * elements by methods. This methods describe business logic of the page/screen.
     * Here lazy instantiated elements are public.
     * It was done so just for obviousness
     */

    @AndroidFindBys({//用多个定位方法描述一组元素。
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/list\")"), //the searching
        //starts here
        @AndroidFindBy(className = "android.widget.TextView") //this element is nested
        //and so on
        })
    public List<WebElement> chainElementViews;

    @AndroidFindBys({
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/content\")"),
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/list\")"),
        @AndroidFindBy(id = "android:id/text1")
        })
    @iOSFindBys({@iOSFindBy(uiAutomator = ".elements()[0]"),
        @iOSFindBy(xpath = "//someElement")})
    public List<WebElement> chainAndroidOrIOSUIAutomatorViews;


    @AndroidFindBys({
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/list\")"),
        @AndroidFindBy(className = "android.widget.TextView")
        })
    public WebElement chainElementView;


    @AndroidFindBys({
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/content\")"),
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/list\")"),
        @AndroidFindBy(id = "android:id/text1")
        })
    @iOSFindBys({@iOSFindBy(uiAutomator = ".elements()[0]"),
        @iOSFindBy(xpath = "//someElement")})
    public WebElement chainAndroidOrIOSUIAutomatorView;
    
    @AndroidFindBys({
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/content\")"),
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/list\")"),
        @AndroidFindBy(id = "android:id/text1")
        })
    public AndroidElement androidElementView;
    
    @AndroidFindBys({
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/content\")"),
        @AndroidFindBy(uiAutomator = "new UiSelector().resourceId(\"android:id/list\")"),
        @AndroidFindBy(id = "android:id/text1")
        })
    public List<AndroidElement> androidElementViews;
}