appium的API

使用的语言是java，appium的版本是1.3.4，java-client的版本是java-client-2.1.0，建议多参考java-client-2.1.0-javadoc。

1.使用AndroidDriver，其已经继承了AppiumDriver

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

private AndroidDriver driver; @Before public void setUp() throws Exception {     DesiredCapabilities capabilities = new DesiredCapabilities();     capabilities.setCapability("deviceName", "Android Emulator");     capabilities.setCapability("platformVersion", "4.4");     capabilities.setCapability("platformName", "Android");     capabilities.setCapability("appPackage", "com.android.settings");     capabilities.setCapability("appActivity", ".Settings");     driver = new AndroidDriver(new URL("http://127.0.0.1:4723/wd/hub"),             capabilities); } @After public void tearDown() throws Exception {     driver.quit(); }

2.截屏并保存至本地

?

1 2 3 4 5 6 7 8

//截屏并保存至本地 File screen = driver.getScreenshotAs(OutputType.FILE); File screenFile = new File("d:\\screen.png"); try {     FileUtils.copyFile(screen, screenFile); //commons-io-2.0.1.jar中的api } catch (IOException e) {     e.printStackTrace(); }

3.push文件、pull文件

?

1 2 3 4 5 6 7 8 9 10 11 12 13

File file = new File("d:\\test.txt"); //test.txt内容为"test" String content = null; try {     content = FileUtils.readFileToString(file); } catch (IOException e) {     e.printStackTrace(); } byte[] data = Base64.encodeBase64(content.getBytes()); driver.pushFile("sdcard/test.txt", data); byte[] resultDate = driver.pullFile("sdcard/test.txt"); System.out.println(new String(Base64.decodeBase64(resultDate))); //打印结果为"test"

4.

?

1 2	//获取当前界面的activity,可用于断言是否跳转到预期的activity driver.currentActivity();

5.

?

1 2	//打开通知栏界面 driver.openNotifications();

6.

?

1 2 3 4 5 6 7 8

//获取网络状态 int status = driver.getNetworkConnection().value; System.out.println(status); //设置网络状态 driver.setNetworkConnection(new NetworkConnectionSetting(status)); //或者 driver.setNetworkConnection(new NetworkConnectionSetting(false, true, false));

7.

?

1 2	//启动其他应用，跨APP driver.startActivity("com.android.camera", ".CameraLauncher");

8.

?

1 2 3 4

//自动滑动列表 driver.scrollTo("text"); //或者 driver.scrollToExact("text");

9.

?

1 2 3 4 5

//安装APP driver.installApp(appPath); //判断应用是否已安装 driver.isAppInstalled("package name");

10.

?

1 2 3

//拖动相机图标至日历图标位置 new TouchAction(driver).longPress(driver.findElementByName("相机")) .moveTo(driver.findElementByName("日历")).release().perform();

11.

?

1 2 3 4 5

//锁屏 driver.lockScreen(2); //判断是否锁屏 driver.isLocked();

12.

?

1 2	//发送按键事件 driver.sendKeyEvent(AndroidKeyCode.HOME);

13.

?

1 2 3 4 5 6 7 8 9

<span style="color:#ff0000;"> </span>                 //通过uiautomator定位clickable属性为true的元素并点击         driver.findElementByAndroidUIAutomator("new UiSelector().clickable(true)").click();                  //相同属性的元素使用List存放         List<webelement> elements = driver.findElementsByClassName("class name");         elements.get(0).click(); //点击List中的第一个元素         //tap,点击元素位置         driver.tap(1, driver.findElementByName("日期和时间"), 0);</webel

getAppStrings() 默认系统语言对应的Strings.xml文件内的数据。 driver.getAppStrings(String language) 查找某一个语言环境对应的字符串文件Strings.xml内数据 sendKeyEvent(int key) 按下某个键，具体哪个键由key值决定，key值定义在AndroidKeyCode类中 sendKeyEvent(int key, Integer metastate) 按下某个键的同时按下附加键（Ctrl/Alt/Shift等），具体是哪些键，由key值（AndroidKeyCode类中定义）和metastate（AndroidKeyMetastate类中定义）决定。 currentActivity() 获取当前activity,比如（.ApiDemos） isAppInstalled(String bundleId) 根据bundleId来判断该应用是否已经安装 installApp(String appPath) 安装app，appPath为应用的本地路径 removeApp(String bundleId) 卸载app.bundleId在android中代表的是报名，而在ios中有专门的bundleId号。 closeApp() 关闭应用，其实就是按home键把应用置于后台 launchApp() 启动应用 resetApp() 先closeApp然后在launchAPP pushFile(String remotePath, byte[] base64Data) 将字符数组用64位格式写到远程目录的某个文件中。也可以理解为把本地文件push到设备上。 pullFile(String remotePath) 将设备上的文件pull到本地硬盘上 pullFolder(String remotePath) 将设备上的文件夹pull到本地硬盘上，一般远程文件为/data/local/tmp下的文件。 setNetworkConnection(NetworkConnectionSetting connection) 设置手机的网络连接状态，可以开关蓝牙、wifi、数据流量。通过NetworkConnectionSetting中的属性来设置各个网络连接的状态。 getNetworkConnection() 得到当前网络的状态 openNotifications() 打开通知栏 runAppInBackground(int seconds) 与resetApp类似，区别是resetApp关闭后立即启动，而这个方法是关闭后等待seconds秒后再启动。 hideKeyboard() ios隐藏键盘 hideKeyboard(String strategy, String keyName) 隐藏键盘，只能用于ios上。 performTouchAction(TouchAction touchAction) 执行一个touch动作，该touch动作是由TouchAction封装的。 performMultiTouchAction(MultiTouchAction multiAction) 执行多步touch动作，由MultiTouchAction封装的多步操作。 tap(int fingers, WebElement element, int duration) 点击element控件中心点按下，duration*5毫秒秒后松开，如此重复fingers次。 tap(int fingers, int x, int y, int duration) 点击(x,y)点按下，duration*5毫秒后松开，如此重复fingers次。 swipe(int startx, int starty, int endx, int endy, int duration) 从(startx,starty)滑到（endx,endy），分duration步滑，每一步用时是5毫秒。 pinch(WebElement el) 2个手指操作控件，从对角线向中心点滑动。 pinch(int x, int y) 以（x,y）为基准，计算得出（x,y-100）,(x,y+100)两个点，然后2个手指按住这两个点同时滑到（x,y） zoom(WebElement el) 与pinch(el)的动作刚好相反。两个手指由控件的中心点慢慢向控件的左顶点后右底点滑动。 zoom(int x, int y) 和pinch(x,y)相反。两个手指从（x,y）点开始向（x,y-100）和（x,y+100）滑动。 getNamedTextField(String name) 一般用在ios中。根据accessibility id获得控件对象。 endTestCoverage(String intent, String path) 结束测试覆盖率的检测。（没用过，不太了解）path为.ec文件的路径。 lockScreen(int seconds) 锁屏多少秒后解锁（使用的时候提示还没实现该方法） shake() 模拟摇晃手机（目前还没实现） scrollTo(String text) 滚动到某个text属性为指定的字符串的控件 scrollToExact(String text) 滚动到某个text属性包含传入的字符串的控件 context(String name) 设置上下文 getContextHandles() 可用上下文 getContext() 当前上下文 rotate(ScreenOrientation orientation) 设置屏幕横屏或者竖屏 getOrientation() 获取当前屏幕的方向 findElementByIosUIAutomation(String using) 利用ios中的uiautomation中的属性来获取控件 findElementsByIosUIAutomation(String using) 和上面一样，不过获得的是多个控件 findElementByAndroidUIAutomator(String using) 利用android的uiautoamtor中的属性来获取单个控件。 findElementsByAndroidUIAutomator(String using) 和上面一样，但是该方法获得是多个控件 findElementByAccessibilityId(String using) 利用accessibility id来获取单个控件 findElementsByAccessibilityId(String using) 利用accessibility id来获得多个控件