Appium APP UI自动化测试——API介绍
0. 定位前的准备工作
在定位APP控件时，需要将APP页面dump到uiautomatorviewer中，然后通过uiautomatorviewer定位控件
能够将手机界面dump出来的前提：
1.打开appium并处于监听状态
2.电脑已开启模拟器或连接真机
3.adb已连接（cmd中输入adb devices，会显示已有设备连接）
- uiautomatorviewer打开方式
双击sdk\tools下的uiautomatorviewer.bat文件，等待出现第二个窗口
APP中的3种属性：text、resource-id、class，在APP中，id/class_name基本上都不是唯一的，xpath可以写成唯一的
1. 通过id定位
| 定位方式 | 说明 |
|---|---|
| find_element_by_id | 找到一个，如果当前界面有多个相同id的控件，则找到第一个 |
| find_elements_by_id | 找到一组，平行结构的ID可能是一样的，下标从0开始 |
ele1 = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/title")
print(ele1.text) #获取文本信息
ele1.click() #点击
ele2 = driver.find_elements_by_id("cn.xiaochuankeji.tieba:id/title") #找到一组，平行结构的ID可能是一样的
ele2[2].click() #通过下标区分
2. 通过class定位
- 通过class定位：在APP中，class代表控件类型，所有控件肯定都有class属性
- 与web端class属性定位有区别，在app中，class属性更像web中标签的概念
- android中大多数控件都放在android.widget下,
- TextView：文本类型 输入框：Edit.Text 图标：ImageView
- 安卓控件是根据从左到右，从上到下排布的，可根据数字来具体定位到某一控件
| 定位方式 | 说明 |
|---|---|
| find_element_by_class_name | 找到一个，如果当前界面有多个相同class的控件，则找到第一个 |
| find_elements_by_class_name | 找到一组，平行结构的class可能是一样的，下标从0开始 |
#当前界面只有一个相同的class属性控件，使用element
ele3 = driver.find_element_by_class_name("android.widget.TextView")
#当前界面有很多相同的class属性控件，使用elements
# 会把当前所有相同class的控件都找出来，再通过下标定位具体控件
ele4 = driver.find_elements_by_class_name("android.widget.TextView") #ele4此时是一个列表，表中放了很多控件
#对于文本控件，可加下面的日志，查看对应下标
for i in range(0,len(ele4)):
print("第"+str(i)+"个="+ele4[i].text) #将每个控件的文本信息及其下标打印出来（i是整型，无法与字符串直接连接，故转换成字符串）
ele4[3].click() #点击想要的控件
#对于图片控件，根据dom树来确定下标，将没展开的都展开，查看ImageView，下标是从0开始
3. 通过xpath定位
-使用xpath定位格式：//class属性[@resource-id=‘id属性’]
- APP一般使用xpath相对路径定位，不使用绝对路径，因为绝对路径会很长
| 通过xpath定位注意点 |
|---|
| xpath通过id查找单个元素（定位关注按钮），使用element |
| xpath通过text文本定位，如果文本是动态的（比如发的朋友圈动态），尽量不要@text属性 |
| xpath通过text文本定位，无控件属性时，可使用正则代替，如//[text=‘图文’] |
| xpath可通过class查找单个元素，class既能当一种控件类型，也能当一种属性 |
| 使用多个属性定位，使用and连接，如//*[@resource-id=‘cn.xiaochuankeji.tieba:id/title’ and @text=‘视频’] |
| 通过层级定位：父级找子级，先定位到父级，父级后跟/，然后后面跟子级的控件类型，xpath下标从1开始 |
| 子级定位到父级，可使用…实现 |
| 使用xpath定位肯定想要路径是唯一的，所以尽量不要使用find_elements这种方法 |
#xpath通过id查找单个元素（定位关注按钮），使用element
ele5 = driver.find_element_by_xpath("//android.widget.TextView[@resource-id='cn.xiaochuankeji.tieba:id/title']")
ele5.click()
#xpath通过text文本定位
#注意：如果文本是动态的（比如发的朋友圈动态），尽量不要@text属性
ele7 = driver.find_element_by_xpath("//android.widget.TextView[@text='关注']")
ele7.click()
#xpath通过text文本定位，无控件属性
ele8 = driver.find_element_by_xpath("//*[text='图文']")
ele8.click()
#xpath通过class查找单个元素（定位发布话题中的edittext）
driver.find_element_by_xpath("//android.widget.EditText").click()
#class既能当一种控件类型，也能当一种属性
driver.find_element_by_xpath("//*[@class='android.widget.EditText']").click()
#组合定位（定位视频，定位搜索）
#使用多个属性定位，使用and连接
driver.find_element_by_xpath("//*[@resource-id='cn.xiaochuankeji.tieba:id/title' and @text='视频']").click()
#通过层级定位：父级找子级，搜索按钮
#先定位到父级，父级后跟/，然后后面跟子级的控件类型，xpath下标从1开始
driver.find_element_by_xpath("//android.widget.FrameLayout[@resource-id='cn.xiaochuankeji.tieba:id/search_b']/android.widget.ImageView[1]")
#定位兄弟级控件1：从子级定位父级（我的按钮），再从父级定位到兄弟级
#我->爸爸->我哥
driver.find_element_by_xpath("//*[@text='我的']/../android.widget.ImageView").click()
#定位兄弟级控件2：先找到父级的父级，然后找到父级的兄弟级的子级（最右按钮上的文案信息）
#我->爸爸->爷爷->大伯->大伯的儿子
driver.find_element_by_xpath("//*[@text='最右']/../../android.view.View[3]/android.widget.TextView").text
使用xpath定位肯定想要路径是唯一的，所以尽量不要使用find_elements这种方法
#xpath通过id查找多个元素（定位发布话题按钮），使用elements，列表下标从0开始
#使用xpath定位肯定想要路径是唯一的，所以尽量不要使用find_elements这种方法
ele6 = driver.find_elements_by_xpath("//android.widget.TextView[@resource-id='cn.xiaochuankeji.tieba:id/title']")
ele6[2].click() #点击第3个
4. 操作类API
| 动作 | 代码实现 |
|---|---|
| 控件点击 | .click() |
| 文本输入 | send_keys() |
| 清空内容 | .clear() |
| 获取控件文本信息 | .text |
| 获取手机屏幕分辨率 | get_window_size() |
4.1 控件点击
#控件点击：.click() 适用于任何控件
ele = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b")
ele.click()
4.2 文本输入与清空
#控件输入：send_keys() 适用于输入框（属性为EditText）
#清空内容：.clear()
a = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/search_input")
a.send_keys('123') #输入内容
a.clear() #清空内容
4.3 获取文本信息
#获取控件文本信息：.text
ele = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b")
print(ele.text) #获取控件文本信息，经常在断言时使用，很重要！！！
4.4 获取手机屏幕分辨率
#获取手机屏幕分辨率：get_window_size()，返回的是一个字典类型
height = driver.get_window_size()['height'] #获取高，返回的是float类型
width = driver.get_window_size()['width'] #获取宽，返回的是float类型
print("此手机的分辨率是："+str(height)+'*'+str(width))
5. 属性获取方法
| 动作 | 代码实现 |
|---|---|
| 获取当前界面activity信息 | .current_activity |
| 获取控件的属性值 | get_attribute() |
| 判断控件是否显示 | is_displayed() |
| 判断控件是否可用 | is_enabled() |
5.1 获取当前界面的activity信息
#获取当前界面activity信息
cur_activity = driver.current_activity
print(cur_activity)
5.2 获取控件的属性值
#获取控件的属性值：get_attribute
ele = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b")
print(ele.get_attribute("className")) #获取控件的属性值
print(ele.get_attribute("resourceId"))
5.3 判断控件是否显示/可用
ele = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b")
print(ele.is_displayed()) #判断控件是否显示，返回布尔类型
print(ele.is_enabled()) #判断控件是否可用，返回布尔类型，可点击返回True，不可点击返回False
6. swipe方法-滑动/点击/长按
6.1 页面滑动的必须条件
#实现页面滑动：swipe
#要实现页面滑动，必须要数据加载出来才可以
driver.implicitly_wait(60) #先等待60秒，直到当前界面的某个控件出现
driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b").is_displayed()
time.sleep(5) #再休眠5秒（给加载数据提供时间）
6.2 上下左右滑动
#从上到下：y值变大
#x不变，y从小变大：下滑 x可以取屏幕分辨率宽的中间值，如720的屏幕，x可取360
#x不变，y从大变小：上滑
driver.swipe(500,1000,500,200,3000) #上滑
#500和1000分别是x/y的起始坐标，500和200是x/y的终止坐标，3000：持续时间3000毫秒
driver.swipe(500,200,500,1000,3000) #下滑
#从左到右：x值变大
#y不变，x从大变小：左滑
#y不变，x从小变大：右滑
driver.swipe(400,500,200,500,3000) #左滑
driver.swipe(200,500,400,500,3000) #右滑
6.3 点击/长按
driver.swipe(500,200,500,200,100) #点击：x和y不变，持续时间很短
driver.swipe(500,200,500,200,3000) #长按：x和y不变，持续时间较长
6.4 按屏幕相对位置滑动
#直接乘以坐标所占屏幕的比例，可实现不论手机屏幕分辨率是多少，代码都可以使用
height = driver.get_window_size()['height']
width = driver.get_window_size()['width']
driver.swipe(width*0.555,height*0.855,width*0.555,height*0.14,3000)
6.5 扩展
（1）查看控件的布局范围：
在Ui Automator Viewer中dump一下界面，然后点击该控件，找到bounds，后面对应的就是控件布局范围，如[17,1083][703,1108] ，x的布局范围是17到703，y的布局范围是1083到1108
（2）坐标的相对位置获取：可在一个正在调试的手机上，如分辨率为1280*720，找到想要想要实现的坐标移动点，如(400,1095,400,180)，x/屏宽，y/屏高，可以取比例获取坐标的相对位置，如计算方式：400/720=0.555 1095/1280=0.855 180/1280=0.14
7. TouchAction
使用TouchAction前需要先导入TouchAction类
from appium.webdriver.common.touch_action import TouchAction
7.1 tap
#点击控件
ele = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b")
TouchAction(driver).tap(ele).perform()
#点击坐标
TouchAction(driver).tap(x=100,y=160).perform()
#也可以使用相对比例的坐标
height = driver.get_window_size()['height']
width = driver.get_window_size()['width']
TouchAction(driver).tap(x=width*0.2, y=height*0.5).perform()
7.2 press
#press某个点
TouchAction(driver).press(x=500, y=308).release().perform()
#release：释放，按下去再释放-相当于点击
#长按某个点
TouchAction(driver).long_press(x=500, y=308,duration=5000).release().perform()
#duration=5000:持续时间5秒
#长按某个控件
ele = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/expand_content_view")
TouchAction(driver).long_press(ele).perform()
8. keyevent
安卓按键（Android keycode），可以到网上搜索每个按键对应的数值
https://blog.csdn.net/midux/article/details/80064054
常用按键：
- 返回键-4
- 菜单键-82
- 搜索键-84（在某个搜索框输入内容后直接调用这个按键即可搜索）
- 回车键-66
- 退格键-67
- 删除键-112
driver.keyevent(4) #直接传入对应的键值，传入4代表返回上一层
9. 截图方法
#截图：get_screenshot_as_file('路径/图片名称.png')
driver.implicitly_wait(60)
el = driver.find_element_by_id("cn.xiaochuankeji.tieba:id/ic_search_b")
driver.get_screenshot_as_file("E:/newCourse/test.png")
10. 中文输入法操作
- 在APP中直接send_keys一个中文是输入不进去的，需要在初始化时，desired_caps里面加2个参数，设置之后就可以send_keys(‘中文’)
- appium输入法是没有键盘的，如果自动化测试做完之后要继续做功能测试，需要去设置里面手动切换输入法
desired_caps['unicodeKeyboard'] = 'True' #给手机安装一个appium的输入法
desired_caps['resetKeyboard'] = 'True' #重置键盘，使appium输入法为默认输入法
11. 重置APP
在做APP自动化时，需要让每条用例都没有相互依赖关系，最简单粗暴的方法就是每次跑完一条用例时，将APP卸载掉，跑下一条用例时，再重新安装。
desired_caps['fullReset'] = 'True' #在初始化时添加这个参数后，每次跑完之后就会把APP卸载掉
desired_caps['app'] = 'E:/newCourse/zuiyou518.apk' #每次开始时会先安装APP
扩展：
-
APP卸载后，会清除用户操作产生的数据，而用户新建的数据来源于后端，不会被清除。比如收藏时会产生一个收藏标志，登录后会有一个登录记录，会被清除。
-
而用户自己新建的数据，如果是以用户区分：
-
登录抖音后收藏了某条视频，然后将APP卸载后，下次安装时收藏数据仍然存在（因为这个数据是记录在用户下的），而登录状态在卸载时是会被清除的，下次安装后需要重新登录。
-
如果新建了数据，又要使用这个数据，需要将这些放在一条用例中。
-
如果不想重置APP也可以，需要每次都查看一下登录状态，确认已经登录成功。在“我的”页面检查是否登录成功，如果是未登录状态，就要调用登录方法
-
是否重置APP需要视具体业务场景而定。 如果业务与本地数据清除没有太大关系，就可以不重置（使用noReset），如果数据依赖关系太强，则需要重置。
强交互的场景是不做自动化的。强交互一般是后端出问题，与UI自动化没有多大关系
12. toast处理
对于toast（发送信息后提示发送成功的黑色弹窗），需要加automationName参数，因为appium1.6.3以上版本才支持toast处理，之前装的是Uiautomator一代，所以需要加Uiautomator2对toast进行处理
#在初始化时加automationName参数
desired_caps['automationName'] = 'Uiautomator2'
#需要导入的库
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
#在定位控件、输入内容并点击发送后会弹出toast，toast定位：
toast_loc = ("xpath",'//*[contains(@text,"评论发送成功")]') #将要定位的控件通过元组罗列出来，再把元组传进去
ele = WebDriverWait(driver,20,0.1).until(EC.presence_of_element_located(toast_loc))
#最大等待时间20秒，每隔0.1秒检测1次，直到当前界面存在了评论发送成功弹窗
print(ele.text) #打印控件属性