『与善仁』Appium基础 — 26、常用手机操作的API说明

目录

• 1、获取当前手机的时间
• 2、获取手机屏幕的宽和高
• 3、获取手机当前网络
• 4、设置手机网络模式
• 5、操作手机通知栏
• 6、综合练习
• 7、发送键到设备（掌握）
• 8、手机截图（掌握）

是针对手机一些常用设置功能进行操作的API。

这些API都非常的简单，用的时候直接查询调用就可以了，下面介绍几个非常常用的API。

1、获取当前手机的时间

使用方法：device_time

# 调用方式：
driver.device_time

# 输出结果：
2020-12-04T00:02:50+08:00

2、获取手机屏幕的宽和高

获取手机的宽高，可以根据宽高做一些坐标的操作。

使用方法：get_window_size()

# 调用方式：
driver.get_window_size()

# 输出结果：
{'width': 720, 'height': 1280}

3、获取手机当前网络

获取手机当前连接的网络信息。

使用方法：network_connection

# 调用方式
driver.network_connection

# 输出结果：数字代表网络模式
6

4、设置手机网络模式

更改手机的网络模式。

使用方法：set_network_connection(connectionType)

# 调用方式
driver.set_network_connection(connectionType)

# 参数：connectionType

# 需要被设置成为的网络类型
"""Sets the network connection type. Android only.
    设置网络连接类型。 仅适用于Android。
Possible values:

    +--------------------+------+------+---------------+
    | 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             |
    +--------------------+------+------+---------------+

These are available through the enumeration `appium.webdriver.ConnectionType`
这些可以通过枚举“ appium.webdriver.ConnectionType”获得。
Args:
    connection_type: a member of the enum `appium.webdriver.ConnectionType`

Return:
    int: Set network connection type
返回值是int类型：设置网络连接类型
"""

None：没有选择模式
Airplane Mode：飞行模式
Wifi only：仅Wifi
Data only：仅数据
All network on：所有网络均已开启

5、操作手机通知栏

打开手机的通知栏，可以获取通知栏的相关信息和元素操作。

使用方法：open_notifications()

# 调用方式
driver.open_notifications()

6、综合练习

"""
1.学习目标
    掌握手机操作中的常用API
2.操作步骤
    2.1 获取当前手机的时间
    2.2 获取手机屏幕的宽和高
    2.3 获取手机当前网络
    2.4 设置手机网络模式
    2.5 打开手机系统通知栏
3.需求
    实现以上功能
"""

# 1.导入appium和TouchAction
import time
from appium import webdriver

# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
    "platformName": "Android",  # 系统名称
    "platformVersion": "7.1.2",  # 系统版本
    "deviceName": "127.0.0.1:21503",  # 设备名称
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP启动名
}

# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.操作APP
# 4.1 获取当前手机的时间
date = driver.device_time
# 输出结果：2020-12-04T00:00:22+08:00
print(date)

# 4.2 获取手机屏幕的宽和高
size = driver.get_window_size()
# 输出结果：{'width': 720, 'height': 1280}
print(size)

# 4.3 获取手机当前网络
network = driver.network_connection
# 输出结果：6
print(network)

# 4.4 设置手机网络模式
# 开启飞行模式，
# driver.set_network_connection(1)
# 或者使用枚举类也行
# 引入from appium.webdriver.connectiontype import ConnectionType包
# driver.set_network_connection(ConnectionType.AIRPLANE_MODE)
# 打印手机当前网络模式
# print(driver.network_connection)

# 注意：切换网络模式操作会导致电脑与模拟器的链接断开。

# 4.5 打开手机系统通知栏
driver.open_notifications()

# 5.关闭APP
time.sleep(3)
driver.quit()

7、发送键到设备（掌握）

模拟系统键值的操作，比如操作home键，音量键，返回键等。

使用方法：keyevent(keycode, metastate=None):

# 调用方式
driver.keyevent(keycode)

参数：
    keycode：发送给设备的关键代码。
    metastate：关于被发送的关键代码的元信息，一般为默认值。

说明：Android常用keycode键列表如下：

键名	描述	键值
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_ENTER	回车键	66
KEYCODE_ESCAPE	ESC键	111
KEYCODE_DPAD_CENTER	导航键_确定键	23
KEYCODE_DPAD_UP	导航键_向上	19
KEYCODE_DPAD_DOWN	导航键_向下	20
KEYCODE_DPAD_LEFT	导航键_向左	21
KEYCODE_DPAD_RIGHT	导航键_向右	22
KEYCODE_MOVE_HOME	光标移动到开始键	122
KEYCODE_MOVE_END	光标移动到末尾键	123
KEYCODE_PAGE_UP	向上翻页	92
KEYCODE_PAGE_DOWN	向下翻页	93
KEYCODE_DEL	退格键	67
KEYCODE_FORWARD_DEL	删除键	112
KEYCODE_INSERT	插入建	124
KEYCODE_TAB	Tab键	61
KEYCODE_NUM_LOCK	小键盘锁	143
KEYCODE_CAPS_LOCK	大写锁定键	115
KEYCODE_BREAK	暂停键	121
KEYCODE_SCROLL_LOCK	滚动锁定键	116
KEYCODE_ZOOM_IN	放大键	168
KEYCODE_ZOOM_OUT	缩小键	169

业务场景:

1. 打开设置。
2. 按多次音量增加键。

代码实现：

"""
1.学习目标
    掌握发送键到设备
2.操作步骤
    发送键到设备：driver.keyevent（keycode）
        例如：
        音量增大 keycode = 24
        音量减小 keycode = 25
3.需求
    使用keyevent控制手机音量大小
"""

# 1.导入appium和TouchAction
import time
from appium import webdriver

# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
    "platformName": "Android",  # 系统名称
    "platformVersion": "7.1.2",  # 系统版本
    "deviceName": "127.0.0.1:21503",  # 设备名称
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP启动名
}

# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.操作APP
# 4.1 发送键到设备,实现手机音量调节
# 音量增大
for i in range(4):
    driver.keyevent(24)
    time.sleep(1)

# 音量减小
for i in range(2):
    driver.keyevent(25)
    time.sleep(1)

# 5.关闭APP
time.sleep(3)
driver.quit()

8、手机截图（掌握）

截取手机当前屏幕，保存指定格式图片到设定位置。

使用方法：get_screenshot_as_file(filename)

# 调用方式
driver.get_screenshot_as_file(filename)

参数：
	filename：指定路径下，指定格式的图片。

业务场景：

1. 打开设置界面。
2. 截图当前界面保存到当前目录，命名为screen.png。

代码实现：

"""
1.学习目标
    掌握appium中手机截图
2.操作步骤
    手机截图
        driver.get_screenshot_as_file（存储文件的路径+文件名）
        图片格式仅支持png格式。
3.需求
    实现手机截图功能
"""

# 1.导入appium和TouchAction
import time
from appium import webdriver

# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
    "platformName": "Android",  # 系统名称
    "platformVersion": "7.1.2",  # 系统版本
    "deviceName": "127.0.0.1:21503",  # 设备名称
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP启动名
}

# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.操作APP
# 手机截图，截图保存当前目录（脚本文件所在的同级目录）
# driver.get_screenshot_as_file("test.jpg") # 写jpg格式日志中会有警告
driver.get_screenshot_as_file("test1.png")

# 5.关闭APP
time.sleep(3)
driver.quit()