airtest.core.android.android module

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

基类: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)[源代码]

将应用安装到手机上

参数:
  • filepathapk 文件在PC上的完整路径
  • replace – 如果应用已存在,是否替换
  • install_options – install命令的额外选项,默认是[]
返回:

安装进程的输出内容

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

Install multiple the application on the device

参数:
  • filepathapk 文件在PC上的完整路径
  • replace – 如果应用已存在,是否替换
返回:

安装进程的输出内容

uninstall_app(package)[源代码]

从设备中卸载应用

参数:package – package name
返回:卸载进程中的输出内容
snapshot(filename=None, ensure_orientation=True)[源代码]

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

参数:
  • filename – 保存截图的文件名,默认为None的话将会发送到stdout
  • ensure_orientation – 截图方向是否要与当前显示情况一致,默认为True
返回:

截图输出

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