（二）Appium常见元素定位方法

柔光的暖阳◎ 2022-03-31 13:11 279阅读 0赞

**目录**

前言

分类

控件定位

手势操作

获取设备及控件相关信息

其他操作

结语

--------------------

## 前言 ##

appium的核心其实就是一个web服务器，它提供了一套REST的接口。首先它收到客户端的连接、监控命令，之后在移动设备上执行这些命令，最后把执行结果放在HTTP响应中返回给客户端。基于上述原理，appium框架提供了一系列的API供调用。以下简单介绍常见的API

## 分类 ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2N4MjQzNjk4_size_16_color_FFFFFF_t_70][]

## 控件定位 ##

**根据Id定位**

*  find\_element\_by\_id（self, id\_）  
    通过元素的id定位，返回含有该属性的元素，在android上 app上即resource id
 *  find\_elements\_by\_id（self, id\_）  
    通过元素的id定位,返回含有该属性的所有元素

**根据名称name定位**

*  find\_element\_by\_name(self, name)  
    通过元素Name定位，返回含有该属性的元素，对于android，即text属性
 *  find\_elements\_by\_name(self, name)  
    通过元素Name定位（元素的名称属性text），含有该属性的所有元素

**根据xpath**

*  find\_element\_by\_xpath（self, xpath）  
    通过Xpath定位，返回含有该属性的元素
 *  find\_elements\_by\_xpath（self, xpath）  
    通过Xpath定位，返回含有该属性的所有元素

**根据class\_name**

*  find\_element\_by\_class\_name（self,class\_name）  
    通过元素class name属性定位,返回包含该属性的元素
 *  find\_elements\_by\_class\_name(self,class\_name)  
    通过元素class name属性定位,返回包含该属性的所有元素

**根据accessibility\_id**

*  find\_element\_by\_accessibility\_id(self,accessibility\_id)
 *  find\_elements\_by\_accessibility\_id(self,accessibility\_id)  
    通过accessibility id定位，在android app上相当于content-description字段，而在ios app 上accessibility identifier字段

## 手势操作 ##

*  click（self） 点击
 *  send\_keys(self, \*value）在元素中模拟输入（开启appium自带的输入法并配置了appium输入法后，即unicodeKeyboard、resetKeyboard，可以输入中英文
 *  clear(self) 清除输入的内容
 *  swipe(self, start\_x, start\_y, end\_x, end\_y, duration=None) 滑动，主要用于缓慢滑动，从（start\_x, start\_y）点滑动到（end\_x, end\_y）点，可以自定义duration【毫秒】滑动时间
 *  flick(self, start\_x, start\_y, end\_x, end\_y) 快速滑动，主要用于快速滑动,无duration，如View切换，按住（start\_x, start\_y）点后快速滑动至（end\_x, end\_y）点
 *  shake(self) 摇一摇 
 *  lock(self, seconds) 锁屏一段时间 IOS专有
 *  scroll(self, origin\_el, destination\_el) 滚动从元素origin\_el滚动至元素destination\_el，只有iOS可以使用
 *  drag\_and\_drop(self, origin\_el, destination\_el) 拖放将元素origin\_el拖到目标元素destination\_el
 *  zoom(self, element=None, percent=200, steps=50) 放大在元素上执行放大
 *  pinch(self, element=None, percent=200, steps=50) 缩小在元素上执行缩
 *  tap(self, positions, duration=None) 点击模拟手指点击（最多五个手指），可设置按住时间长度（单位毫秒），positions参数为单位为元组的列表，如\[(x1,y1),(x2,y2)\]
 *  keyevent(self, keycode, metastate=None) 发送按键码发送按键码（安卓仅有），常见的有:
    
     *  KEYCODE\_HOME (按键Home) : 3
     *  KEYCODE\_MENU (菜单键) : 82
     *  KEYCODE\_BACK (返回键) : 4

#用法
    
    element.click()
    
    element.send_keys("测试")
    
    element.clear()
    
    driver.swipe(100,100,100,400)
    
    driver.flick(100,100,100,400)
    
    driver.shake()
    
    driver.lock()
    
    driver.scroll(el1,el2)
    
    driver.drag_and_drop(el1,el2)
    
    driver.zoom(element)#默认分成50步完成,放大量为200%
    
    driver. pinch (element)
    
    driver.tap([(300,500)],10)
    
    driver.keyevent(4)

## 获取设备及控件相关信息 ##

*  get\_window\_size (self, windowHandle='current') 获取当前设备的宽、高
 *  location 获取元素的左上角坐标
 *  size 获取元素的宽、高
 *  current\_activity 获取设备当前的activity值
 *  context 获取当前会话的当前上下文
 *  app\_strings(self, language=None, string\_file=None)对于Android，获取app的strings.xml文件内容

#用法
    width = driver.get_window_size()['width']
    height = driver.get_window_size()['height']
    
    x = element.location['x']
    y = element.location['y']
    
    width = element.size['width']
    height = element.size['height']
    
    driver.current_activity
    
    driver.context
    
    driver.app_strings

## 其他操作 ##

*  wait\_activity（self, activity, timeout, interval=1） 等待指定activity的出现等待指定activity的出现，返回true or false，默认是轮询间隔是1s，需要值得注意的是这里的参数是current\_activity打印出来的值，即不包含包名
 *  quit(self) 退出退出脚本运行，并关闭每个相关的窗口连接
 *  background\_app(self, seconds) 后台运行，把app放置于后台运行，设置时间seconds，单位s，相当于一段时间后重启app，而不是home将app放置后台
 *  save\_screenshot(self, filename) 截图截图，filename参数为路径，包含文件名称

#用法
    
    driver.wait_activity(activity,timeout,interval)
    
    driver.quit()
    
    driver.background_app(3)
    
    driver.save_screenshot('/Screenshots/inchlifc.png')

## 结语 ##

以上是我们在测试中常使用到的一些API，实际上appium提供的API还有很多。本文中可能有一些没有提及，建议大家可以参考appium的API中文文档。

--------------------

> 不忘初心，如果您认为这篇文章有价值，认同作者的付出，可以微信二维码打赏任意金额给作者（微信号：cx18375319923）哦，Thanks♪(･ω･)ﾉ
> 
> ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2N4MjQzNjk4_size_16_color_FFFFFF_t_70 1][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2N4MjQzNjk4_size_16_color_FFFFFF_t_70]: /images/20220331/9fac5d91ca2149449bfdbee32ec1a775.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2N4MjQzNjk4_size_16_color_FFFFFF_t_70 1]: /images/20220331/fb7f4a4492aa435aa550a24cac097378.png