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

目录

是针对手机一些常用设置功能进行操作的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()
posted @ 2021-12-25 14:02  繁华似锦Fighting  阅读(435)  评论(0)  编辑  收藏  举报