[开发测试]UI自动化 Appium常用的方法汇总（java版）

Appium

常用接口

定位一个元素

• 通过id定位

  driver.find_element_by_id()
  

• 通过className

  driver.find_element_class_name()
  

• 通过xpath

  driver.find_element_by_xpath()
  

定位一组元素

• 通过id定位

  driver.find_elements_by_id()
  

• 通过className

  driver.find_elements_class_name()
  

• 通过xpath

  driver.find_elements_by_xpath()
  

等待

• 隐式等待

  所有的find操作都会等待

  driver.implicitly_wait(10) # 10秒
  

• 显示等待

  针对当前绑定的用户的等待,在5s内，每0.5s调用一次查找元素

  wait = WebDriverWait(driver, 5) # 5s
  button = wait.until(lambda xx.find_element_by_xpath(""))
  

对比

• 作用域

  显示等待单个元素，隐式等待全局元素

• 方法

  显示等待在WebDriverWait类中,而隐式等待则直接通过driver实例化对象调用

• sleep

  固定写死时间，不推荐

• 报错

  显示等待未找到报错TimeOutException，隐式等待报错NoSuchElementException

元素操作

• 点击

  element.click()
  

• 清空文本框元素

  element.clear()
  

• 输入内容

  element.send_keys()
  

• 获取文本内容

  element.text()
  

• 位置&大小

  element.location #{'x':12, 'y': 12}
  element.size # {'height':192, 'width': 192}
  

• 获取元素属性值

  key=“text” 返回text属性值

  key="name"返回content-desc/text属性值

  key="className"返回class属性，只有API>=18支持

  key="resourceId"返回resource-id属性值，只有API>=18支持

  element.get_attribute("key")
  

滑动与拖拽事件

• swipe滑动事件

  有距离误差，时间越短惯性越小

  driver.swipe(start_x, start_y, end_x, end_y, duration) #持续时间 默认为0 ms
  

• scroll滑动

  从一个元素滑动到另一个元素，直到页面自动停止，有惯性

  driver.scroll(element1, element2)
  

• drag_and_drop拖拽事件

  从一个元素滑动到另一个元素，第二个元素代替第一个元素原本屏幕上的位置，没有惯性

  driver.drag_and_drop(element1, element2)
  

高级手势TouchAction

轻敲

要么传element，要么传X,Y坐标，count是执行次数，单击(1)，双击(2)

TouchAction(driver).tap(element=None, x=None, y=None, count=1).perform() 

按下和抬起

• 按下

  pressure是ios的强制按下

  TouchAction(driver)
  .press(el=None, x=None, y=None, pressure=float)
  .wait(2000)
  .perform() 
  
  

• 抬起

  TouchAction(driver)
  .release()
  .perform() 
  
  

• 长按

  TouchAction(driver)
  .long_press(el=None, x=None, y=None, duration=1000)
  .perform() 
  
  

长按

TouchAction(driver)
.move_to(el=None, x=None, y=None)
.perform() 

获取手机分辨率

driver.get_window_size() #{'height':2560, 'width':1440}

截图

dirver.get_screenshot_as_file("fileName.png")

获取&设置手机网络

• 获取网络

  driver.network_connection
  
  

• 设置网络

  value	Data	WIFI	Airplane Mode
  0	0	0	0
  1	0	0	1
  2	0	1	0
  4	1	0	0
  6	1	1	0

  driver.set_network_connection()
  
  

  按键操作

driver.press_keycode()

通知栏

只有开，没有关

要关闭的方法

1. 滑动操作
2. 按返回键 key=4

driver.open_notifications()