appium，元素定位和元素操作，使用uiautomatorviewer
###
定位方式
定位说三种定位：id，class，xpath
###
操作说3种，点击，输入，获取元素值，
###
代码示例：
from appium import webdriver import time import unittest class Test_Demo(unittest.TestCase): def setUp(self): desired_caps={} desired_caps['platformName']='Android' desired_caps['platformVersion']='6.0' desired_caps['deviceName']='emulator-5554' desired_caps['noReset']='true' # 使用这个，就会记住上一次你的点击记录， desired_caps['appPackage']='com.tencent.news' desired_caps['appActivity']='com.tencent.news.activity.SplashActivity' desired_caps['dontStopAppOnReset']='true' self.driver=webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps) time.sleep(8) def tearDown(self): pass # driver.quit() #退出app def test_search_demo(self): self.driver.find_element_by_id("com.tencent.news:id/home_channel_search_box").click() self.driver.find_element_by_class_name("android.widget.EditText").send_keys("股票期权") self.driver.find_element_by_xpath("//*[@resource-id='com.tencent.news:id/search_history_title']").click() self.driver.implicitly_wait(5) text_ele = self.driver.find_elements_by_id("com.tencent.news:id/title_text") for item in text_ele: print(item.text) # print("text", text_ele) if __name__ == '__main__': unittest.main()
###
代码解释：
注意1，desired_caps['noReset']='true' # 使用这个，就会记住上一次你的点击记录，比如同意协议，不进行更新，这样的弹框选择
注意2，desired_caps['dontStopAppOnReset']='true'，加上这个，就不用每次都重新启动app了，这样会大大的提高调试代码的效率，很重要，
注意3，self.driver.implicitly_wait(5)，隐式等待，这个很重要，有很多时候你明明是定位对了，但是就是报错找不到元素，那就试试等待，一般会是这个问题，
注意4，元素的定位，定位方法有很多，到时候你再学学，
注意5，元素的操作，操作的方法有很多，到时候你再学学，
###
如何使用uiautomatorviewer进行元素定位？？？
准备工作
一.jdk 1.8 (请勿使用JDK 1.9 将造成兼容性错误,导致)
注意UiAutomatorViewer安装失败，要考虑是不是这个java版本的问题，我之前就遇到了java版本的问题，
二.Android-SDK 3.0.0(UiAutomatorViewer 启动依赖)
三.ADB工具(链接安卓与PC)
四.UiAutomatorViewer JAR(帮助我们获取屏幕中的控件,并使用脚本操作)
五. 打开 Android-SDK 目录下的 uiautomatorviewer.bat 进行编辑
###
我的mac的这个sdk是在我的MyProject--sdk--tools--bin--uiautomatorviewer
因为我没有设置环境变量，所以我不能直接输入这个命令就行，启动，所以要进入这个目录，然后执行这个命令，
或者是双击这个uiautomatorviewer文件，
####
uiautomatorviewer启动之后，
点击左上角的按钮，可以把手机的屏幕放到这个uiautomatorviewer来，
####
然后就可以开始进行元素的定位了，
可以通过id或者class定位
使用id或者class定位可能会有多个，可以用index选择，
如果还定位不到，就使用xpath，也可以通过xpath定位，
操作就是可以点击或者输入内容，注意下面这些元素的属性
###
AndroidElement el = driver.findElement(By.id(io.***.vodi:id/message_list_item_chat_id));
AndroidElement el2 = (AndroidElement) el.findElementByClassName("android.view.View");
el2.getText(); //result is blank
el2.getAttribute("text") //result is blank
可以通过获取text属性来获取文本
###
Appium之xpath定位元素
前面也说过appium也是以webdriver为基的，对于元素的定位也基本一致，只是增加一些更适合移动平台的独特方式，下面将着重介绍xpath方法，这应该是UI层元素定位最强大的方法啦！
以淘宝app为例，定位左上角扫一扫按钮
1.如果元素text是唯一的，可以通过text文本定位
//*[@text=’text文本属性’]
# 定位text
driver.find_element_by_xpath("//*[@text='扫一扫']").click()
2.如果元素id是唯一的，也可以id属性定位
//*[@resource-id=’id属性’]
# 定位 resource-id
driver.find_element_by_xpath("//*[@resource-id='com.taobao.taobao:id/tv_scan_text']").click()
同样可以联合上面两种方式定位，如下
# 也可以联合@resource-id属性和@text文本属性来下定位
driver.find_element_by_xpth("//*[@resource-id='com.taobao.taobao:id/tv_scan_text'][@text='扫一扫']").click()
3.class属性唯一的话，同样可以通过class属性定位，有两种方法
第一种： //class属性
# 定位搜索框 //class属性
driver.find_element_by_xpath("//android.widget.EditText").click()
第二种： //*[@class=’class属性’]
# 定位搜索框 //*[@class='class属性']
driver.find_element_by_xpath("//*[@class='android.widget.EditText']").click()
4.通过content-desc属性定位
//*[@content-desc=’desc的文本’]
#点登录/注册
driver.find_element_by_xpath("//*[@text='注册/登录']").click()
time.sleep(3)
#content-desc定位
driver.find_element_by_xpath("//*[@content-desc='帮助']").click()
contains模糊定位
1）、contains是模糊匹配的定位方法，对于一个元素的id或者text不是固定的，但有一部分是固定的，这种就可以模糊匹配。
//[contains(@content-desc, ‘帮助’)]
# contains匹配text
driver.find_element_by_xpath('//*[contains(@text, "注册/登录")]').click()
time.sleep(3)
# contains匹配textcontent-desc
driver.find_element_by_xpath("//*[contains(@content-desc, '帮助')]").click()
2）、contains也能模糊匹配id和class属性
//[contains(@resource-id, ‘id属性’)]
//[contains(@clsss, ‘class属性’)]
#定位搜索框class
driver.find_element_by_xpath("//*[contains(@class, 'EditText')]").click()
time.sleep(3)
driver.back()
#定位id
driver.find_element_by_xpath("//*[contains(@resource-id, 'id/home_searchedit')]").click()
组合定位
1）、如果一个元素有2个属性，通过xpath也可以同时匹配2个属性,text, resource-id,class ,index,content-desc这些属性都能任意组合定位
# id和class属性 定位搜索框
id_class = '//android.widget.EditText[@resource-id="com.taobao.taobao:id/home_searchedit"]'
driver.find_element_by_xpath(id_class).click()
time.sleep(3)
driver.back()
# text和index属性 定位登录/注册
desc_class = '//*[@text="注册/登录" and @index="1"]'
driver.find_element_by_xpath(desc_class).click()
time.sleep(3)
# class和text属性 定位输入手机号
class_text = '//android.widget.EditText[@text="请输入手机号码"]'
driver.find_element_by_xpath(class_text).send_keys("512200893")
time.sleep(3)
# class和desc 定位帮助
id_desc = '//*[contains(@resource-id, "aliuser_menu_item_help") and @content-desc="帮助"]'
driver.find_element_by_xpath(id_desc).click()
层级定位
1）、如果一个元素,它除了class属性（class属性肯定会有），其它属性啥都没有，这种情况用上面方法就不适用了，这个时候可以找他父元素，通过父亲定位儿子
#通过父亲定位儿子 搜索输入框 fa_sun = '//*[@resoure-id="com.taobao.taobao:id/home_searchbar"]/android.widget.EditText' t = driver.find_element_by_xpath(fa_sun).text print(t)
如果一个父元素下，有多个相同class的儿子时候，可以通过xpath的索引去取对应第几个，xpath是从1开始数的
# 父元素下第2个儿子 微淘 fu_sun2 = '//*[@resource-id="com.taobao.taobao:id/ll_navigation_tab_layout"]/android.widget.FrameLayout[2]' driver.find_element_by_xpath(fu_sun2).click()
2）、相反的，可以通过儿子定位父亲
# 通过子元素定位父元素 # 方法一： .. sun_fa1 = '//*[@resource-id="com.taobao.taobao:id/tv_scan_text"]/..' c = driver.find_element_by_xpath(sun_fa1).tag_name print(c) # 方法二 parent::* sun_fa2 = '//*[@resource-id="com.taobao.taobao:id/tv_scan_text"]/parent::*' d = driver.find_element_by_xpath(sun_fa1).tag_name print(d) # 方法三 parent::android.widget.LinearLayout sun_fa3 = '//*[@resource-id="com.taobao.taobao:id/tv_scan_text"]/parent::android.widget.LinearLayout' e = driver.find_element_by_xpath(sun_fa1).tag_name print(e)
3）、通过子元素，先找到父元素，再找父元素下的子元素，同样可以进行兄弟元素定位
# 兄弟元素 xiongdi = '//*[@resource-id="com.taobao.taobao:id/bar_search"]/../android.widget.RelativeLayout' x = driver.find_element_by_xpath(xiongdi).tag_name print(x)
4）、通过层级关系，一层一层的往下找，同样可以通过爷爷元素，定位到孙子元素
#爷爷元素FrameLayout---第一个FrameLayout儿子---孙子TextView x = '//android.widget.FrameLayout/android.widget.LinearLayout[1]/android.widget.TextView' t = driver.find_elements_by_xpath(x) print(len(t)) # 打印文本信息 print(t[0].text
一、常用识别元素的工具
uiautomatorviewer：Android SDK自带的一个工具，在tools目录下
二、元素定位
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_keys(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)
* 释放 (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非必填项，默认滑动时间5ms
（滑动的坐标不能超过屏幕的宽高）
可以通过【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)
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)
键名 描述 键值
KEYCODE_CALL 拨号键 5
KEYCODE_ENDCALL 挂机键 6
KEYCODE_HOME 按键Home 3
KEYCODE_MENU 菜单键 82
KEYCODE_BACK 返回键 4
KEYCODE_SEARCH 搜索键 84
KEYCODE_CAMERA 拍照键 27
KEYCODE_FOCUS 拍照对焦键 80
KEYCODE_POWER 电源键 26
KEYCODE_NOTIFICATION 通知键 83
KEYCODE_MUTE 话筒静音键 91
KEYCODE_VOLUME_MUTE 扬声器静音键 164
KEYCODE_VOLUME_UP 音量增加键 24
KEYCODE_VOLUME_DOWN 音量减小键 25更多KeyCode可以查看下面的博客：
六、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
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
这种启动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掩码如下：
| 值 (别名) | 数据连接 | Wifi 连接 | 飞行模式 |
| ------------------ | ---- | ---- | ------------- |
| 0 (什么都没有) | 0 | 0 | 0 |
| 1 (飞行模式) | 0 | 0 | 1 |
| 2 (只有Wifi) | 0 | 1 | 0 |
| 4 (只有数据连接) | 1 | 0 | 0 |
| 6 (开启所有网络) | 1 | 1 | 0 |
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
######
技术改变命运
