八、APP元素事件操作API
8.1. 前置代码
from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
8.2. swip滑动事件
⚠️从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动
- 方法:swipe(start_x, start_y, end_x, end_y, duration=None)
- 参数:
1.start_x:起点X轴坐标
2.start_y:起点Y轴坐标
3.end_x: 终点X轴坐标
4.end_y,: 终点Y轴坐标
5.duration: 滑动这个操作一共持续的时间长度,单位:ms- 业务场景:
1.进入设置
2.从坐标(148,659)滑动到坐标(148,248)
- 业务场景:
- 代码实现:
# 滑动没有持续时间 driver.swipe(188,659,148,248) # 滑动持续5秒的时间 driver.swipe(188,659,148,248,5000)
8.3. scroll滑动事件
⚠️ 从一个元素滑动到另一个元素,直到页面自动停止
- 方法:scroll(origin_el, destination_el)
- 参数:
1.origin_el:滑动开始的元素
2.destination_el:滑动结束的元素 - 业务场景:
1.进入设置页
2.模拟手指从存储菜单位置 到 WLAN菜单位置的上滑操作 - 代码实现:
# 定位到存储菜单栏 el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]") # 定位到WLAN菜单栏 el2 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") # 执行滑动操作 driver.scroll(el1,el2)
8.4. drag拖拽事件
⚠️ 从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置
- 方法:drag_and_drop(origin_el, destination_el)
- 参数:
1.origin_el:滑动开始的元素
2.destination_el:滑动结束的元素 - 业务场景:
1.进入设置页
2.模拟手指将存储菜单 滑动到 WLAN菜单栏位置 - 代码实现:
# 定位到存储菜单栏 el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]") # 定位到WLAN菜单栏 el2 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") # 执行滑动操作 driver.drag_and_drop(el1,el2)
8.5. 应用置于后台事件
APP放置后台,模拟热启动
- 方法:background_app(seconds)
- 参数:
1.seconds:停留在后台的时间,单位:秒 - 业务场景:
1.进入设置页
2.将APP置于后台5s - 代码实现:
driver.background_app(5)
- 效果:
app置于后台5s后,再次展示当前页面
九、APP模拟手势高级操作
TouchAction是AppiumDriver的辅助类,主要针对手势操作,比如滑动、长按、拖动等,原理是将一系列的动作放在一个链条中发送到服务器,服务器接受到该链条后,解析各个动作,逐个执行。
9.1. 前置代码
from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
⚠️ 所有手势都要通过执行函数才会运行.
9.2. 手指轻敲操作
模拟手指轻敲一下屏幕操作
- 方法:tap(element=None, x=None, y=None)
- 方法:perform() # 发送命令到服务器执行操作
- 参数:
1.element:被定位到的元素
2.x:相对于元素左上角的坐标,通常会使用元素的X轴坐标
3.y:通常会使用元素的Y轴坐标 - 业务场景:
1.进入设置
2.点击WLAN选项 - 代码实现:
# 通过元素定位方式敲击屏幕 el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") TouchAction(driver).tap(el).perform() # 通过坐标方式敲击屏幕,WLAN坐标:x=155,y=250 # TouchAction(driver).tap(x=155,y=250).perform()
9.3. 手指按操作
模拟手指按下屏幕,按就要对应着离开.
- 方法:press(el=None, x=None, y=None)
- 方法:release() # 结束动作,手指离开屏幕
- 参数:
1.element:被定位到的元素
2.x:通常会使用元素的X轴坐标
3.y:通常会使用元素的Y轴坐标 - 业务场景:
1.进入设置
2.点击WLAN选项 - 代码实现:
# 通过元素定位方式按下屏幕 el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") TouchAction(driver).press(el).release().perform() # 通过坐标方式按下屏幕,WLAN坐标:x=155,y=250 # TouchAction(driver).press(x=155,y=250).release().perform()
9.4. 等待操作
- 方法:wait(ms=0)
- 参数:
ms:暂停的毫秒数 - 业务场景:
1.进入设置
2.点击WLAN选项
3.长按WiredSSID选项5秒 - 代码实现:
# 点击WLAN driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click() # 定位到WiredSSID el =driver.find_element_by_id("android:id/title") # 通过元素定位方式长按元素 TouchAction(driver).press(el).wait(5000).perform() # 通过坐标方式模拟长按元素 # 添加等待(有长按)/不添加等待(无长按效果) # TouchAction(driver).press(x=770,y=667).wait(5000).release().perform()
9.5. 手指长按操作
模拟手机按下屏幕一段时间,按就要对应着离开.
- 方法:long_press(el=None, x=None, y=None, duration=1000)
- 参数:
1.element:被定位到的元素
2.x:通常会使用元素的X轴坐标
3.y:通常会使用元素的Y轴坐标
4.duration:持续时间,默认为1000ms - 代码实现:
# 点击WLAN driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click() # 定位到WiredSSID el =driver.find_element_by_id("android:id/title") # 通过元素定位方式长按元素 TouchAction(driver).long_press(el,duration=5000).release().perform() # 通过坐标方式长按元素,WiredSSID坐标:x=770,y=667 # 添加等待(有长按)/不添加等待(无长按效果) # TouchAction(driver).long_press(x=770,y=667).perform()
9.6. 手指移动操作
模拟手机的滑动操作
- 方法:move_to(el=None, x=None, y=None)
- 参数:
1.el:定位的元素
2.x:相对于前一个元素的X轴偏移量
3.y:相对于前一个元素的Y轴偏移量 - 业务场景1:
1.进入设置
2.向上滑动屏幕 - 代码实现:
# 定位到存储 el = driver.find_element_by_xpath("//*[contains(@text,'存储')]") # 定位到更多 el1 = driver.find_element_by_xpath("//*[contains(@text,'更多')]") # 元素方式滑动 TouchAction(driver).press(el).move_to(el1).release().perform() # 坐标的方式滑动 # TouchAction(driver).press(x=240,y=600).wait(100).move_to(x=240,y=100).release().perform() # 注意press连接一个move_to实际调用的是swip方法,可在log中查询,不要给相对坐标。
- 业务场景2:
1.进入设置
2.向上滑动屏幕到可见"安全"选项
3.进入到安全
4.点击屏幕锁定方式
5.点击图案
6.绘制图案 - 代码实现:
# 定位到WLAN el1 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") # 定位到存储 el2 = driver.find_element_by_xpath("//*[contains(@text,'存储')]") # 存储上滑到WLAN driver.drag_and_drop(el2,el1) # 定位到用户 el3 = driver.find_element_by_xpath("//*[contains(@text,'用户')]") # 注意 这次使用drag_and_drop方法,传入的"存储定位"仍使用其原始在屏幕上的位置,所以是由存储滑动到用户才可以上滑,否则需要重新"定位存储" # 存储上滑倒用户位置 driver.drag_and_drop(el2,el3) # 点击安全按钮 driver.find_element_by_xpath("//*[contains(@text,'安全')]").click() # 点击屏幕锁定方式按钮 driver.find_element_by_xpath("//*[contains(@text,'屏幕锁定')]").click() # 点击图案按钮 driver.find_element_by_xpath("//*[contains(@text,'图案')]").click() # 绘制图案四个坐标 1:(244,967) 2:(723,967) 3:(723,1442) 4:(244,1916) TouchAction(driver).press(x=244,y=967).wait(100).move_to(x=479,y=0).wait(100)\ .move_to(x=0,y=475).wait(100).move_to(x=-479,y=474).release().perform()
十、手机操作API
针对手机的一些常用设置功能进行操作.
10.1. 前置代码
from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
10.2. 获取手机时间
- 方法:device_time
- 代码实现:
# 获取当前手机的时间 print(driver.device_time)
- 执行结果:
Wed Dec 27 08:52:45 EST 2017
10.3. 获取手机的宽高
获取手机的宽高,可以根据宽高做一些坐标的操作
- 方法:get_window_size()
- 代码实现:
print(driver.get_window_size())
- 执行结果:
{'height': 800, 'width': 480}
10.4. 发送键到设备
模拟系统键值的操作,比如操作home键,音量键,返回键等。
- 参数:
keycode:发送给设备的关键代码
metastate:关于被发送的关键代码的元信息,一般为默认值 - 业务场景:
1.打开设置
2.按多次音量增加键 - 代码实现:
for i in range(3): driver.keyevent(24)
Appium---Android的keycode键值
adb命令使用
adb shell input keyevent XX(EventCode) #输入对应的键值
adb shell input text "www.baidu.com" #向浏览器发送文本
EventCode | KeyEvent | EventName |
---|---|---|
0 | KEYCODE_UNKNOWN | 未知键 |
1 | KEYCODE_SOFT_LEFT | 左键 |
2 | KEYCODE_SOFT_RIGHT | 右键 |
3 | KEYCODE_HOME | Home键 |
4 | KEYCODE_BACK | 返回键 |
5 | KEYCODE_CALL | 拨号键 |
6 | KEYCODE_ENDCALL | 挂机键 |
7 | KEYCODE_0 | 按键“0” |
8 | KEYCODE_1 | 按键“1” |
9 | KEYCODE_2 | 按键“2” |
10 | KEYCODE_3 | 按键“3” |
11 | KEYCODE_4 | 按键“4” |
12 | KEYCODE_5 | 按键“5” |
13 | KEYCODE_6 | 按键“6” |
14 | KEYCODE_7 | 按键“7” |
15 | KEYCODE_8 | 按键“8” |
16 | KEYCODE_9 | 按键“9” |
17 | KEYCODE_STAR | 按键“*” |
18 | KEYCODE_POUND | 按键“#” |
19 | KEYCODE_DPAD_UP | 导航键 向上 |
20 | KEYCODE_DPAD_DOWN | 导航键 向下 |
21 | KEYCODE_DPAD_LEFT | 导航键 向左 |
22 | KEYCODE_DPAD_RIGHT | 导航键 向右 |
23 | KEYCODE_DPAD_CENTER | 导航键 确定 |
24 | KEYCODE_VOLUME_UP | 音量键加 |
25 | KEYCODE_VOLUME_DOWN | 音量键减 |
26 | KEYCODE_POWER | 电源键 |
27 | KEYCODE_CAMERA | 相机键 |
28 | KEYCODE_CLEAR | 清除键 |
29 | KEYCODE_A | 按键“A” |
30 | KEYCODE_B | 按键“B” |
31 | KEYCODE_C | 按键“C” |
32 | KEYCODE_D | 按键“D” |
33 | KEYCODE_E | 按键“E” |
34 | KEYCODE_F | 按键“F” |
35 | KEYCODE_G | 按键“G” |
36 | KEYCODE_H | 按键“H” |
37 | KEYCODE_I | 按键“I” |
38 | KEYCODE_J | 按键“J” |
39 | KEYCODE_K | 按键“K” |
40 | KEYCODE_L | 按键“L” |
41 | KEYCODE_M | 按键“M” |
42 | KEYCODE_N | 按键“N” |
43 | KEYCODE_O | 按键“O” |
44 | KEYCODE_P | 按键“P” |
45 | KEYCODE_Q | 按键“Q” |
46 | KEYCODE_R | 按键“R” |
47 | KEYCODE_S | 按键“S” |
48 | KEYCODE_T | 按键“T” |
49 | KEYCODE_U | 按键“U” |
50 | KEYCODE_V | 按键“V” |
51 | KEYCODE_W | 按键“W” |
52 | KEYCODE_X | 按键“X” |
53 | KEYCODE_Y | 按键“Y” |
54 | KEYCODE_Z | 按键“Z” |
55 | KEYCODE_COMMA | 按键“,” |
56 | KEYCODE_PERIOD | 按键‘.’ |
57 | KEYCODE_ALT_LEFT | 组合键 Alt+Left |
58 | KEYCODE_ALT_RIGHT | 组合键 Alt+Right |
59 | KEYCODE_SHIFT_LEFT | 组合键 Shift+Left |
60 | KEYCODE_SHIFT_RIGHT | 组合键 Shift+Left |
61 | KEYCODE_TAB | Tab键 |
62 | KEYCODE_SPACE | 空格键 |
63 | KEYCODE_SYM | 选择输入法 |
64 | KEYCODE_EXPLORER | 浏览器 |
65 | KEYCODE_ENVELOPE | 邮件 |
66 | KEYCODE_ENTER | 回车键 |
67 | KEYCODE_DEL | 退格键 |
68 | KEYCODE_GRAVE | 按键‘`’ |
69 | KEYCODE_MINUS | 按键‘-’ |
70 | KEYCODE_EQUALS | 按键‘=’ |
71 | KEYCODE_LEFT_BRACKET | 按键‘[’ |
72 | KEYCODE_RIGHT_BRACKET | 按键‘]’ |
73 | KEYCODE_BACKSLASH | 按键‘\’ |
74 | KEYCODE_SEMICOLON | 按键‘,’ |
75 | KEYCODE_APOSTROPHE | 按键‘'’(单引号) |
76 | KEYCODE_SLASH | 按键‘/’ |
77 | KEYCODE_AT | 按键‘@’ |
78 | KEYCODE_NUM | 按键Number modifier |
79 | KEYCODE_HEADSETHOOK | 按键Headset Hook |
80 | KEYCODE_FOCUS | 拍照对焦键 |
81 | KEYCODE_PLUS | 按键‘+’ |
82 | KEYCODE_MENU | 菜单键 |
83 | KEYCODE_NOTIFICATION | 通知键 |
84 | KEYCODE_SEARCH | 搜索键 |
85 | TAG_LAST_KEYCODE |
10.5. 操作手机通知栏
打开手机的通知栏,可以获取通知栏的相关信息和元素操作
- 方法:open_notifications()
- 业务场景:
1.启动设置
2.打开通知栏 - 代码实现:
driver.open_notifications()
10.6. 获取手机当前网络
获取手机当前连接的网络
- 方法:network_connection
- 业务场景:获取手机当前网络模式
- 代码实现:
print(driver.network_connection)
- 执行结果:
6
Value (Alias) | Data | Wifi | Airplane Mode |
---|---|---|---|
0 (None) | 0 | 0 | 0 |
1 (Airplane Mode) | 0 | 0 | 1 |
2 (Wifi only) | 0 | 1 | 0 |
4 (Data only) | 1 | 0 | 0 |
6 (All network on) | 1 | 1 | 0 |
10.7. 设置手机网络
更改手机的网络模式,模拟特殊网络情况下的测试用例
- 方法:set_network_connection(connectionType)
- 参数:
connectionType:需要被设置成为的网络类型 - 业务场景:
1.启动设置
2.设置手机网络为飞行模式 - 代码实现:
driver.set_network_connection(1)
10.8. 手机截图
截取手机当前屏幕,保存指定格式图片到设定位置
- 方法:get_screenshot_as_file(filename)
- 参数:
filename:指定路径下,指定格式的图片. - 业务场景:
1.打开设置页面
2.截图当前页面保存到当前目录,命名为screen.png - 代码实现:
import os driver.get_screenshot_as_file(os.getcwd() + os.sep + './screen.png')
- 执行结果:
当前目录下会生成screen.png文件
十一、脚本录制
11.1. 认识界面
11.2. 点击开始录制按键开始录制脚本
-
点击顶部导航栏左侧第一个“选择元素”按键选定搜索栏,然后点击右边点“点击”按键进行操作(录制过程就是先选择录制窗口左边的APP元素,然后录制窗口右边的操作方式)。
-
录制完成后点击“停止录制”按键,录制窗口右上角会同步显示操作代码,选择代码类型,将模板代码转换成正式代码,复制代码到Pycharm。
-
代码复制到pycharm后,最好是在每个操作或者页面切换处加上等待时间,否则会因为网速、APP设计问题或者其他原因,无法及时到达下一个页面,导致APPIUM无法获取页面元素而定位元素失败,在pycharm运行时报错。代码编辑好后点击pycharm的运行按键,APPium就会在手机上面自动运行脚本了。