手机操作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就会在手机上面自动运行脚本了。