Appium python client 网络连接相关 api 用法

原文 ：https://testerhome.com/topics/3428

前言

今天有人问到我这个问题，并且尝试过传入数字/字符串作为参数均不成功。于是看了下，发现要找到正确用法需要对 client 源码有一定了解，并且 google 和 github 上都没有找到对应的使用示例，所以在这里记录一下。

问题描述

appium 一直有一个设置和获取当前各项连接状态的 api ，官方文档中可用参数及使用方法如下：

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

// javascript
// set airplane mode
driver.setNetworkConnection(1)

// set wifi only
driver.setNetworkConnection(2)

// set data only
driver.setNetworkConnection(4)

// set wifi and data
driver.setNetworkConnection(6)

但在 python client 中使用这样的代码会报错：

self.driver.set_network_connection(1)

报错信息：

Error
Traceback (most recent call last):
File "/Users/NextGen/Documents/Framework/test.py", line 35, in test_search
self.driver.set_network_connection(1)
File "/Library/Python/2.7/site-packages/appium/webdriver/webdriver.py", line 623, in set_network_connection
'type': connectionType.value
AttributeError: 'int' object has no attribute 'value'

解决过程

参考资料：8.13. enum — Support for enumerations

首先，出现

AttributeError

这个很奇怪，这里传入的东西为啥会有
value 这个属性？难道传的不是基本数据类型，而是一个对象？于是看了下这个方法的源码：

def set_network_connection(self, connectionType):
"""Sets the network connection type. Android only.
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`

:Args:
- connectionType - a member of the enum appium.webdriver.ConnectionType
"""
data = {
'parameters': {
'type': connectionType.value
}
}
return self.execute(Command.SET_NETWORK_CONNECTION, data)['value']

关键字：

- connectionType - a member of the enum appium.webdriver.ConnectionType

翻译一下这个注释：

- connectionType - 枚举类型 appium.webdriver.ConnectionType 中的成员

然后看看

appium.webdriver.ConnectionType

...
class ConnectionType(Enum):
NO_CONNECTION = 0
AIRPLANE_MODE = 1
WIFI_ONLY = 2
DATA_ONLY = 4
ALL_NETWORK_ON = 6

ok，明白了。就是 connectionType 必须是 appium.webdriver.ConnectionType 里的其中一个成员。接下来就简单了。

问题解决

正确的使用方法：

# python
# set network
from appium.webdriver.connectiontype import ConnectionType
self.driver.set_network_connection(ConnectionType.AIRPLANE_MODE)

# get network
self.driver.network_connection # it would return int type, like 0, 1, 2, 4, 6
ConnectionType(self.driver.network_connection).name # it would return mode name, like AIRPLANE_MODE, WIFI_ONLY

总结

这个其实本来没什么问题的，只是官方文档缺失导致用的时候要稍微探究一下才会用。同时也简单学习了一下怎么在 python 中使用枚举。