Appium定位Android元素与操作

柔情只为你懂 2022-04-23 21:58 240阅读 0赞

##### 一、常用识别元素的工具 #####

**uiautomator**：Android SDK自带的一个工具，在tools目录下  
**monitor**：Android SDK自带的一个工具，在tools目录下  
**Appium Inspector**：Appium自带的一个功能，只有mac下可以使用该功能

*  下面是用monitor抓取到的页面元素

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NTMxNTQ5_size_16_color_FFFFFF_t_70]

##### 二、元素定位 #####

**1.格式：find\_element\_by\_定位方式(value)**

**通过id定位**  
（取resource-id的值）：  
driver.find\_element\_by\_id(“com.wuba.zhuanzhuan:id/azo”)  
也可以直接用id后面的内容driver.find\_element\_by\_id(“azo”)

**通过class\_name定位**  
（取class的内容）  
driver.find\_element\_by\_class\_name(“android.widget.RelativeLayout”)

**通过xpath定位**  
（取xpath得内容）  
driver.find\_element\_by\_xpath("//android.widget.LinearLayout\[1\]/android.widget.XXX")

**通过text定位**  
（需要使用uiautomator的定位方式，使用text的内容）  
driver.find\_elements\_by\_android\_uiautomator(“new UiSelector().text(”+关注")")

使用这里需要注意一下，通过text定位的结果是个list，不能直接click。所以如果要点击需要取数组的值，比如下面是点击找到的第一个元素  
driver.find\_elements\_by\_android\_uiautomator(“new UiSelector().text(”+关注")")\[0\].click()

**通过css\_selector定位（webview）**  
只适用于webview的html页面，继承自webdriver，与pc版本的UI测试一致  
driver.find\_element\_by\_css\_selector()

**通过link\_text定位（webview）**  
只适用于webview容器中的html页面，继承自webdriver，与pc版本的UI测试一致  
driver.find\_element\_by\_link\_text()

**通过name定位**  
web view容器中的html页面可以用name定位，native并没有name属性  
driver.find\_element\_by\_name()

**2.定位元素的另一种写法：find\_element(by,value)**  
find\_element\_by\_方式(value)实际调用的都是find\_element(by,value)  
需要导入这个包：from [selenium.webdriver.common.by][] import By

**例如：定位id为ag2的元素**  
方式一：driver.find\_element\_by\_id("ag2”)  
方式二：driver.find\_element([By.ID][],“ag2”)

这个操作的好处是可以直接把操作的by和value放到一个元组里，然后调用通用方法来传参获得元素结果  
cateid=([By.ID][],“ag2”)  
driver.find\_element(\*cateid).click()

by的操作可以是：  
[By.ID][] 相当于by\_id  
By.CLASS\_NAME 相当于by\_class\_name  
By.XPATH 相当于by\_xpath  
[By.NAME][] 相当于by\_name  
By.TAG\_NAME 相当于by\_tag\_name  
By.CSS\_SELECTOR 相当于by\_css\_selector  
By.LINK\_TEXT 相当于by\_link\_text

**3.find\_elements\_by\_定位方式(value)返回元素数组**  
用法与find\_element\_by\_方式(value)一致，但是返回一个数组。可以通过数组的索引来访问具体的某个结果

例如：通过class\_name定位到多个元素，我想点击第一个元素  
driver.find\_elements\_by\_class\_name("android.widget.RelativeLayout”)\[0\].click()

**4.返回元素数组的另一种写法：find\_elements(by,value)**  
用法与find\_element(by,value)一致，但是返回一个数组。可以通过数组的索引来访问具体的某个结果

例如：通过class\_name定位到多个元素，我想点击第一个元素  
driver.find\_elements(By.CLASS\_NAME,"android.widget.RelativeLayout”)\[0\].click()

**5.通过元素定位元素**  
可以先找到某个元素，然后再进一步定位元素  
find\_element\_by\_class\_xpath(“xxx”).find\_element\_by\_name(“yyy")

##### 三、元素操作 #####

找到元素后可以对元素进行的操作，例如上面讲的进一步定位元素

**1.click()**  
//点击操作  
也可以用tab实现点击操作  
driver.find\_element\_by\_id(“com.wuba.zhuanzhuan:id/ae8”).click()

**2.clear()**  
//清空输入框内容  
driver.find\_element\_by\_id(“com.wuba.zhuanzhuan:id/ij”).clear()

**3.send(xx)**  
//输入框内输入内容  
driver.find\_element\_by\_id(“com.wuba.zhuanzhuan:id/ij”).send\_keys(“test content”)

**4.text**  
//获得元素的text内容  
print(driver.find\_element\_by\_xpath(" //android.widget.LinearLayout\[1\]//xxx").text)

##### 四、触摸操作 #####

**1.driver.tap(\[坐标\]，持续点击时间)**  
除了定位到元素的点击外，也可以通过tab实现坐标的点击  
driver.tap(driver.tap(\[(216,1776)\],2))

**2.TouchAction(driver)**  
TouchAction对象包含（tab）、press（短按）、move\_to（滑动到某个坐标）等方法

通过TouchAction对象，添加tap、move\_to等操作，然后perform()执行，可以实现解锁屏幕等功能

**规范中的可用事件有：**

*  短按 (press)
 *  释放 (release)
 *  移动到 (moveTo)
 *  点击 (tap)
 *  等待 (wait)
 *  长按 (longPress)
 *  取消 (cancel)
 *  执行 (perform)

**例如：一个多次滑屏的例子：**  
action=TouchAction(driver)  
action.press(x=220,y=700).move\_to(x=840, y=700).move\_to(x=220, y=1530).move\_to(x=840, y=1530).release().perform()  
可以通过wait()等待操作

**3.MultiAction()//多点触控**  
通过MultiAction().add()添加多个TouchAction操作，最后调用perform()一起执行这些操作  
action0 = TouchAction().tap(el)  
action1 = TouchAction().tap(el)  
MultiAction().add(action0).add(action1).perform()

**4.driver.swipe(x1, y1, x2, y2,duration)**  
//从坐标(x1,x2)滑动到坐标(x2,y2)，duration非必填项，滑动时间  
（滑动的坐标不能超过屏幕的宽高）  
可以通过【driver.get\_window\_size()】命令获得窗口高和宽，结果为\{‘width’: 1080, ‘height’: 1776\}

**一个鼠标向上下左右活动的例子如下：**  
\#获得屏幕大小宽和高  
def getSize(driver):  
x = driver.get\_window\_size()\[‘width’\]  
y = driver.get\_window\_size()\[‘height’\]  
return (x, y)

**\#屏幕向上滑动**  
def swipeUp(driver,t=1000):  
l = getSize(driver)  
x1 = int(l\[0\] \* 0.5) \#x坐标  
y1 = int(l\[1\] \* 0.75) \#起始y坐标  
y2 = int(l\[1\] \* 0.25) \#终点y坐标  
driver.swipe(x1, y1, x1, y2,t)

**\#屏幕向下滑动**  
def swipeDown(driver,t=1000):  
l = getSize(driver)  
x1 = int(l\[0\] \* 0.5) \#x坐标  
y1 = int(l\[1\] \* 0.25) \#起始y坐标  
y2 = int(l\[1\] \* 0.75) \#终点y坐标  
driver.swipe(x1, y1, x1, y2,t)  
**\#屏幕向左滑动**  
def swipLeft(driver,t):  
l=getSize(driver)  
x1=int(l\[0\]\*0.75)  
y1=int(l\[1\]\*0.5)  
x2=int(l\[0\]\*0.05)  
driver.swipe(x1,y1,x2,y1,t)  
**\#屏幕向右滑动**  
def swipRight(driver,t=1000):  
l=getSize(driver)  
x1=int(l\[0\]\*0.05)  
y1=int(l\[1\]\*0.5)  
x2=int(l\[0\]\*0.75)  
driver.swipe(x1,y1,x2,y1,t)

**\#调用向下滑动的方法**  
swipeDown(driver)

##### 五、系统按键事件 #####

press\_keycode(AndroidKeyCode)//发送按键事件  
例如：点击home键，home键的KeyCode是3  
driver.press\_keycode(3)

<table> 
 <thead> 
  <tr> 
   <th>键名</th> 
   <th>描述</th> 
   <th>键值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>KEYCODE_CALL</td> 
   <td>拨号键</td> 
   <td>5</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_ENDCALL</td> 
   <td>挂机键</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_HOME</td> 
   <td>按键Home</td> 
   <td>3</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_MENU</td> 
   <td>菜单键</td> 
   <td>82</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_BACK</td> 
   <td>返回键</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_SEARCH</td> 
   <td>搜索键</td> 
   <td>84</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_CAMERA</td> 
   <td>拍照键</td> 
   <td>27</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_FOCUS</td> 
   <td>拍照对焦键</td> 
   <td>80</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_POWER</td> 
   <td>电源键</td> 
   <td>26</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_NOTIFICATION</td> 
   <td>通知键</td> 
   <td>83</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_MUTE</td> 
   <td>话筒静音键</td> 
   <td>91</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_VOLUME_MUTE</td> 
   <td>扬声器静音键</td> 
   <td>164</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_VOLUME_UP</td> 
   <td>音量增加键</td> 
   <td>24</td> 
  </tr> 
  <tr> 
   <td>KEYCODE_VOLUME_DOWN</td> 
   <td>音量减小键</td> 
   <td>25</td> 
  </tr> 
 </tbody> 
</table>

##### 六、driver的一些比较重要操作 #####

**1.reset()**  
//重置app  
这时候driver会重置，相当于卸载重装应用。所以本地缓存会失效  
driver.reset()

**2.start\_activity(包名,activity名)**  
//启动app的某一个activity  
例如：driver.start\_activity(“com.wuba.zhuanzhuan”,"./presentation.view.activity.LaunchActivity")

启动一个activity，这个activity必须是AndroidManifest.xml中有intent-filter的activity

这种启动activity和driver的reset()不同的是

**3.contexts**  
//获得所有contexts  
driver.contexts

结果如下：  
\[‘NATIVE\_APP’, ‘WEBVIEW\_com.android.browser’\]

NATIVE\_APP：native的context  
WEBVIEW\_com.android.browser：webview的context，存放html的容器

**4.current\_context**  
//查看当前的context  
driver.current\_context

**5.switch\_to.context(context名)**  
//切换context  
driver.switch\_to.context(“WEBVIEW\_com.wuba.zhuanzhuan”)

NATIVE时不能定位WEBVIEW的内容，在WEBVIEW的context时不能定位NATIVE的内容。  
所以需要切换到对应的context中去进行操作

**6.setNetworkConnection(bitmask掩码)**  
//设置网络类型  
例如：设置网络类型为只开wifi  
driver.set\_network\_connection(2)

网络的bitmask掩码如下：

<table> 
 <thead> 
  <tr> 
   <th>值 (别名)</th> 
   <th>数据连接</th> 
   <th>Wifi 连接</th> 
   <th>飞行模式</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0 (什么都没有)</td> 
   <td>0</td> 
   <td>0</td> 
   <td>0</td> 
  </tr> 
  <tr> 
   <td>1 (飞行模式)</td> 
   <td>0</td> 
   <td>0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>2 (只有Wifi)</td> 
   <td>0</td> 
   <td>1</td> 
   <td>0</td> 
  </tr> 
  <tr> 
   <td>4 (只有数据连接)</td> 
   <td>1</td> 
   <td>0</td> 
   <td>0</td> 
  </tr> 
  <tr> 
   <td>6 (开启所有网络)</td> 
   <td>1</td> 
   <td>1</td> 
   <td>0</td> 
  </tr> 
 </tbody> 
</table>

**7.scroll(起始元素，结束元素)**  
driver.scroll(origin\_el,destination\_el)

**8.获得当前页面的所有元素**  
driver.page\_source

这可以用来判断元素是否存在，例如（assert “发布成功” in driver.page\_source）

**9.补充一些driver启动时可能用到的项**  
其实这些在上一篇启动里都有介绍，但是有些可能大家没注意到的点再列一下。这些点也是我在测试中实际遇到的点

autoLaunch ：Appium是否要自动启动或安装app，默认true  
desired\_caps\[‘autoLaunch’\] = ‘false’  
有的时候我不想让appium每次都启动app，想自己去启动activity，那这个项这时就可以起作用了

noReset：在会话前是否重置app状态。默认是false  
desired\_caps\[‘noReset’\] = ‘true’

newCommandTimeout：设置未接收到新命令的超时时间，默认60s  
如果60s内没有接收到新命令，appium会自动断开连接，如果我需要很长时间做driver之外的操作，可能延长接收新命令的超时时间  
desired\_caps\[“newCommandTimeout”\]=1800

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NTMxNTQ5_size_16_color_FFFFFF_t_70]: /images/20220222/1a676a7f066641a5a89ec589421ceeff.png
[selenium.webdriver.common.by]: http://selenium.webdriver.common.by
[By.ID]: http://By.ID
[By.NAME]: http://By.NAME