设备交互Api
设备交互 Api
简介
设备交互是自动化测试工具与移动设备进行沟通和掌握的过程,它不仅限于基本的应用元素点击和输入等操作。
在移动端应用程序测试中,设备交互的范围扩展到模拟通信方面和模拟设备本身的功能和行为,会涉及到设备的通信行为,例如模拟电话呼叫和短信发送,以及控制设备的一些系统级别的功能,例如网络连接状态、屏幕方向等。
设备交互应用场景
- 模拟电话和短信:在测试通讯类应用程序时,模拟电话呼叫和接听、发送和接收短信等操作。
- 网络模式:模拟不同的网络条件,如良好、较差或无网络连接等,可以测试应用程序在不同网络环境下的性能和容错能力。
- 横竖屏切换:通过模拟设备从横屏到竖屏或从竖屏到横屏的切换,可以验证应用程序在不同屏幕方向下的布局和显示效果。
- App 处理:模拟应用程序被其他应用或系统中断(如来电、短信、通知等),然后再返回到应用程序中,可以测试应用程序在中断和恢复过程中的稳定性和用户体验。
- 录屏:录制设备屏幕上的操作过程。
常用基础操作
锁屏与解锁
通过 Capability 参数实现
- 解决
app
自动化执行时,操作设备时遇到需要解锁屏幕的问题 unlockType
可以设置为:pin
,password
,pattern
,fingerprint
其中一个,分别对应pin
,密码,手势解锁以及指纹解锁四种方式unlockKey
为具体值:对应不同的解锁方式存在不同的值
Python 示例:
desired_caps={}
desired_caps['unlockType']="password"
desired_caps['unlockKey']="111111"
Java 示例:
DesiredCapabilities caps = new DesiredCapabilities();
caps.setCapability("unlockType", "password");
caps.setCapability("unlockKey", "111111");
通过方法实现
- 锁屏: 锁屏操作,
seconds
设置锁屏时长- Python:
lock(self,seconds)
- Java:
lockDevice(Duration.ofSeconds(seconds))
- Python:
- 解锁:
- Python:
unlock()
- Java:
unlockDevice()
- Python:
- 判断是否锁屏: 如果是锁屏状态返回
True
- Python:
is_locked(self)
- Java:
isDeviceLocked();
- Python:
截图与录屏
-
截图有两个方式:
-
Python:
get_screenshot_as_file('./photos/img01.png')
save_screenshot('./photos/img02.png')
-
Java:
getScreenshotAs()
;
-
-
录屏:模拟器需要 androidAPI>27,华为不支持,只支持 8.0 以上的版本。
-
开始录制:
- Python:
start_recording_screen()
- Java:
startRecordingScreen();
- Python:
-
结束录制:
- Python:
stop_recording_screen()
- Java:
stopRecordingScreen();
- Python:
-
打开通知栏
- 打开通知栏:
- Python:
open_notifications()
- Java:
openNotifications()
- Python:
获取当前屏幕分辨率
- 获取当前屏幕分辨率:
- Python:
get_window_size()
- Java:
driver.manage().windows().getSize()
- Python:
模拟电话、短信
Appium 提供了模拟来电和短信的功能,这在测试中可用于验证应用在接收来电或短信时的响应。需要注意的是,这些模拟功能仅限于原生模拟器,不支持第三方的模拟器。
Python 示例:
## 向号码拨打电话
driver.make_gsm_call("13822233001", GsmCallActions.CALL);
## 接听来自当前号码的电话
driver.make_gsm_call("13822233001", GsmCallActions.ACCEPT);
## 电话保持
driver.make_gsm_call("13822233001", GsmCallActions.HOLD);
## 终止与号码的通话,可用于取消拨号或挂断通话
driver.make_gsm_call("13822233001", GsmCallActions.CANCEL);
## 接收到来自该号码的短信
driver.send_sms("555-123-4567", "hello Appium");
Java 示例:
// 向号码拨打电话
driver.makeGsmCall("13822233001", GsmCallActions.CALL);
// 接听来自当前号码的电话
driver.makeGsmCall("13822233001", GsmCallActions.ACCEPT);
// 电话保持
driver.makeGsmCall("13822233001", GsmCallActions.HOLD);
// 终止与号码的通话,可用于取消拨号或挂断通话
driver.makeGsmCall("13822233001", GsmCallActions.CANCEL);
// 接收到来自该号码的短信
driver.sendSMS("555-123-4567", "hello Appium");
网络设置
只有 Android
可以使用 Python: set_network_connection(self,connection_type)
、Java: setConnection(ConnectionState)
进行网络设置,使用数字或导入ConnectionType
类进行传参设置.
- 方式一:使用数字传参设置 0、1、2、4、6,
driver.set_network_connection(1)
- 方式二:导入ConnectionType类进行传参设置,
driver.set_network_connection(ConnectionType.ALL_NETWORK_ON)
Python 示例:
## 获取当前网络状态
print(driver.network_connection)
## 设置为飞行模式
driver.set_network_connection(1)
## 只开启Wifi
driver.set_network_connection(2)
## 设置为只有数据为开启状态
driver.set_network_connection(4)
## 数据与Wifi均打开
driver.set_network_connection(6)
Java 示例:
// 获取当前网络状态
System.out.println(driver.getConnection());
// 设置为飞行模式
driver.setConnection(new ConnectionState(1));
// 只开启Wifi
driver.setConnection(new ConnectionState(2));
// 设置为只有数据为开启状态
driver.setConnection(new ConnectionState(4));
// 数据与Wifi均打开
driver.setConnection(new ConnectionState(6));
横竖屏切换
实现横竖屏切换的功能可以通过设置 driver
的属性 orientation
来修改。
属性值的含义如下:
LANDSCAPE
:切换为横屏PORTRAIT
:切换为竖屏
Python 示例:
# 输出当前 driver 的属性
print(driver.orientation)
# 设置为横屏
driver.orientation == 'LANDSCAPE'
# 设置为竖屏
driver.orientation == 'PORTRAIT'
Java 示例:
// 输出当前 driver 的属性
System.out.println("Current Orientation: " + driver.getOrientation());
// 设置为横屏
driver.rotate(ScreenOrientation.LANDSCAPE);
// 设置为竖屏
driver.rotate(ScreenOrientation.PORTRAIT);
获取当前设备时间
Appium 提供了一个获取设备实际时间的方法,可通过调用 getDeviceTime
来获取。
- get_device_time(self,format=None):
- 获取设备当前时间,format
为日期时间格式设置,默认为'YYYY-MM-DDTHH:mm:ss`
Python 示例:
# 打印出设备的实际时间
print(driver.get_device_time())
Java 示例:
// 打印出设备的实际时间
System.out.println(driver.getDeviceTime());
总结
- 常见设备交互操作