Airtest自动化测试 Docs airtest.core.android package

airtest.core.android.android module

classAndroid(serialno=None, host=None, cap_method='MINICAP_STREAM', touch_method='MINITOUCH', ime_method='YOSEMITEIME', ori_method='MINICAPORI', display_id=None, input_event=None)[源代码]

基类：airtest.core.device.Device

Android Device Class

get_default_device()[源代码]

获取本地默认连接的设备，当没有传入设备序列号时

返回:	本地设备序列号serialno

uuid

list_app(third_only=False)[源代码]

返回packages列表

参数:	third_only – 如果为True，只返回所有第三方应用列表
返回:	应用列表

path_app(package)[源代码]

打印出package的完整路径

参数:	package – package name
返回:	package的完整路径

check_app(package)[源代码]

检查package在设备中是否存在

参数:	package – package name
返回:	如果存在，返回True
Raises:	AirtestError – 如果不存在，抛出异常

start_app(package, activity=None)[源代码]

启动应用

参数:	package – package name activity – activity name
返回:	None

start_app_timing(package, activity)[源代码]

启动应用，并且返回启动耗费时间

参数:	package – package name activity – activity name
返回:	app启动时间

stop_app(package)[源代码]

停止应用

参数:	package – package name
返回:	None

clear_app(package)[源代码]

清理应用数据

参数:	package – package name
返回:	None

install_app(filepath, replace=False, install_options=None)[源代码]

将应用安装到手机上

参数:	filepath – apk 文件在PC上的完整路径 replace – 如果应用已存在，是否替换 install_options – install命令的额外选项，默认是[]
返回:	安装进程的输出内容

install_multiple_app(filepath, replace=False)[源代码]

Install multiple the application on the device

参数:	filepath – apk 文件在PC上的完整路径 replace – 如果应用已存在，是否替换
返回:	安装进程的输出内容

uninstall_app(package)[源代码]

从设备中卸载应用

参数:	package – package name
返回:	卸载进程中的输出内容

snapshot(filename=None, ensure_orientation=True, quality=10)[源代码]

截取一张当前手机画面，默认会发送到stdout

参数:	filename – 保存截图的文件名，默认为None的话将会发送到stdout ensure_orientation – 截图方向是否要与当前显示情况一致，默认为True quality – The image quality, integer in range [1, 99]
返回:	截图输出

shell(*args, **kwargs)[源代码]

返回 adb shell 解释器

参数:	*args – optional shell commands **kwargs – optional shell commands
返回:	None

keyevent(keyname, **kwargs)[源代码]

在设备上执行keyevent

参数:	keyname – keyevent name **kwargs – optional arguments
返回:	None

wake()[源代码]

执行唤醒操作

返回:	None

home()[源代码]

按下HOME键

返回:	None

text(text, enter=True, **kwargs)[源代码]

向设备中输入字符串

参数:	text – 要输入的字符串 enter – 是否按下`Enter`键 search – 是否要按下输入法键盘中的search键
返回:	None

touch(pos, duration=0.01)[源代码]

在设备上执行点击

参数:	pos – coordinates (x, y) duration – 点击屏幕的时长
返回:	None

double_click(pos)[源代码]

swipe(p1, p2, duration=0.5, steps=5, fingers=1)[源代码]

在设备上执行滑动操作

参数:	p1 – 开始坐标 p2 – 结束坐标 duration – 在屏幕上滑动的时长，默认是0.5 steps – 滑动过程中的步数，默认为5 fingers – 滑动的手指数量，1或者2，默认为1
返回:	None

pinch(*args, **kwargs)[源代码]

在设备上执行pinch操作（放大缩小）

参数:	*args – optional arguments **kwargs – optional arguments
返回:	None

logcat(*args, **kwargs)[源代码]

执行 logcat

参数:	*args – optional arguments **kwargs – optional arguments
返回:	logcat 输出

getprop(key, strip=True)[源代码]

根据传入的key获取properties内容

参数:	key – key name strip – 是否对输出内容进行strip
返回:	property value(s)

get_ip_address()[源代码]

执行以下几种命令行来获取IP地址

• adb shell netcfg | grep wlan0
• adb shell ifconfig
• adb getprop dhcp.wlan0.ipaddress

返回:	如果获取IP失败，返回None，否则返回IP地址

get_top_activity()[源代码]

Get the top activity

返回:	package, activity and pid

get_top_activity_name_and_pid()[源代码]

get_top_activity_name()[源代码]

Get the top activity name

返回:	package, activity and pid

is_keyboard_shown()[源代码]

如果软键盘正在启用，返回True，否则False

Notes

不一定在所有设备上都可用

返回:	True or False

is_screenon()[源代码]

如果屏幕是亮着的，返回True，否则False

Notes

不一定在所有设备上都可用

返回:	True or False

is_locked()[源代码]

如果是锁定状态返回True，否则False

Notes

部分设备上可能不可用

返回:	True or False

unlock()[源代码]

解锁设备

Notes

不一定在所有设备上都可用

返回:	None

display_info

返回显示信息(width, height, orientation 和 max_x, max_y)

返回:	显示信息

get_display_info()[源代码]

返回显示信息(width, height, orientation 和 max_x, max_y)

返回:	显示信息

get_current_resolution()[源代码]

返回旋转后的当前分辨率

返回:	宽, 高

get_render_resolution(refresh=False)[源代码]

返回旋转后的渲染分辨率

参数:	refresh – 是否强制刷新渲染分辨率
返回:	offset_x, offset_y, offset_width and offset_height of the display

start_recording(*args, **kwargs)[源代码]

开始对设备画面进行录制

参数:	*args – optional arguments **kwargs – optional arguments
返回:	None

stop_recording(*args, **kwargs)[源代码]

停止对设备画面的录制。录制出的文件将会放在设备中。

参数:	*args – optional arguments **kwargs – optional arguments
返回:	None

adjust_all_screen()[源代码]

对全面屏设备进行渲染分辨率的调整。

返回:	None