【appium】APP元素操作Api、androidDriver操作Api

一、元素操作Api

主要是做断言 text

1、click()——触发当前元素的点击事件

2、sendKeys(...)——输入数据

3、clear()——清空内容

4、getAttribute() ——获取属性值

字符串类型属性：

• content-desc（返回content-desc属性值）

• text(返回 text)

• className(返回 class)

• resourceId(返回 resource-id)

布尔类型属性同UiautomatorViewer里面保持一致

5、getText() =====等同于：getAttribute("text")

获取当前元素的文本值（文本属性值）

6、getTagName()

二、androidDriver操作Api

1、currentActivity()

当前正在前台运行的界面名，我们可以用此API在某些场景进行断言：是否当前activity符合我们的预期等。

//得到当前正在运行的activity
String activity = androidDriver.currentActivity();

2、getPageSource()

可以用于判断当前页面是否有某个元素，或者判断当前页面有没有产生变化：

如：上下滚动判断是否已经到了底端/顶端；

获取app代码源码 用来做断言 根据源码看页面有没有什么变化

⚠️注意是当前页面，当前看到的页面，不是全部页面

//得到当前页面的结构图
androidDriver.getPageSource();

3、其他信息获取类API

• 获取设备时间信息

  androidDriver.getDeviceTime();
  

• 获取设备DPI，注意不是分辨率，屏幕密度 (Density)

  androidDriver.getDisplayDensity();
  

• 获取automation name，默认为null，

  如果有指定automation name为uiautomator2就为对应的值

  androidDriver.getAutomationName();
  

• 获取设备横竖屏状态，有PORTRAIT(竖屏)与LANDSCAPE(横屏)

  androidDriver.getOrientation();
  

4、pressKey()：KeyEvent 按键——app特有api—— pressKey()

输入android对应的key 激活对应的功能 包括：声音大小、相机、开关机、返回键等等

安卓对应的键：Android KeyCode 安卓键码对照表-CSDN博客

KeyEvent key = new KeyEvent();
key.withKey(AndroidKey.BACK);
driver.pressKey(key);

5、getScreenshotAs() 截图

//手机截图文件
//file对象存在一个临时目录，srcFile
File srcFile = driver.getScreenshotAs(OutputType.FILE);
FileUtils.copyFile(srcFile,new File("/.../android.png"));

6、坐标点击 TouchAction

选择设置中关于手机->连续点击五次版本号->进入开发者选项->指针位置进行勾选

注意：坐标点击受设备屏幕尺寸/分辨率/DPI影响，万不得已不要使用此种方式

缺点：兼容性差 更换设备后一般不能用

实现方式：（类似于web的拖动：press——release——perform）

TouchAction action = new TouchAction(driver);
//创建坐标点击对象PointOption
//创建点 x y  ⚠️左上角是原点
PointOption point = PointOption.point(493,837);
//点击
action.press(point).release().perform();