python-自动化Airtest-2代码篇 Airtest包

代码篇 Airtest包

• 一: connect_device 代码
• • 1> auto_setup
  • 2> Template
  • 3> other airtest.core.api
  • • 1. init_device
    • 2. device&connect_device&set_current
    • • A: device
      • B: connect_device(uri)
      • C: set_current
      • D: auto_setup
• 二：Other commands
• • 1> shell(cmd)
  • 2> app operation
  • • 1. start_app(package, activity=None)
    • 2. stop_app(package)
    • 3. clear_app(package)
    • 4. install(filepath, **kwargs)
    • 5. uninstall(package)
  • 3> snapshot(filename=None, msg=”, quality=None, max_size=None)
  • 4> wake()
  • 5> home()
  • 6> find_all(v)
  • 7> 其他命令keyevent、text、wait、wait、assert_exists、assert_not_exists、assert_equal、assert_not_equal、sleep
• 三： screen operation
• • 1> touch(v, times=1, **kwargs)
  • 2> click(v, times=1, **kwargs)
  • 3> double_click(v)
  • 4> swipe(v1, v2=None, vector=None, **kwargs)
  • 5> pinch(in_or_out=’in’, center=None, percent=0.5)
• 四：airtest poco

一: connect_device 代码

更完备的 airtest.core.api
https://airtest.readthedocs.io/en/latest/all_module/airtest.core.api.html

1> auto_setup

platform: Android/iOS/Windows…
host: Android平台是adb host，iOS下是iproxy host，其他平台请留空
port: Android下是adb port，iOS下填写iproxy port，其他平台请留空
uuid: 目标设备的uuid，例如Android下是序列 ，windows下是窗口句柄，iOS是uuid
param: 设备初始化的配置字段，例如cap_method/ori_method/…
value: 设备初始化字段的值。

2> Template

把图片转为代码

参数分别为：截取的图片名， record_pos记录坐标， resolution 分辨率，threshold阈值，target_pos图像点击位置
截取的图片名：可添绝对路径、相对路径
record_pos:记录坐标
resolution :分辨率
threshold:浮点型
target_pos：图像点击位置，向上节IDE介绍1-9 个位置；默认都为5

3> other airtest.core.api

1. init_device

如果还没有初始化设备，则设置为当前设备

参数：
platform ：平台– Android, IOS or Windows
uuid ：设备
kwargs ：可选的平台其他特定关键字参数

例如：
init_device(platform=“Android”,uuid=“SJE5T17B17”, cap_method=“JAVACAP”)

2. device&connect_device&set_current

A: device

B: connect_device(uri)

链接设备，URI即是链接设备参数；同样返回设备实例，用法同上

C: set_current

set_current(idx)

Parameters:idx:初始化设备实例的Uuid或索引;即链接当前设备第0个设备，或者设备 为27QGL208280000641 设备

Raises: 如果传参正确，不 错，未找到设备，则 错

Returns:
Platforms: 适平台Android, iOS, Windows

D: auto_setup

如上已做讲解，需要注意是其中都有参数参数，可做传参选择性访问执行，例如：设备-27QGL20828000064，传输对于操作更加灵活；

二：Other commands

1> shell(cmd)

Parameters: cmd – command to be run on device, e.g. “ls /data/local/tmp”
Platforms: 适用平台 Android

2> app operation

1. start_app(package, activity=None)

启动apk
package：启动的包的名称，而非activity 名
activity ：启动的活动，默认为None，这意味着主活动
Platforms: 支持平台 Android, iOS

2. stop_app(package)

参数同start_app

3. clear_app(package)

Parameters: 包的名称，参见start app
Platforms: 适用平台 Android

4. install(filepath, **kwargs)

安装apk
filepath： 文件安装在目标设备上的路径
Platforms: 适用平台Android

5. uninstall(package)

卸载设备上apk
Parameters: 包的名称，参见start app
Platforms: 适用平台Android

3> snapshot(filename=None, msg=‘’, quality=None, max_size=None)

获取目标设备的截图并将其保存到文件中
Parameters: Filename -保存截图的文件名。 如果提供了相对路径，则默认位置为ST.LOG_DIR
msg： 对截图的简短描述，它将被记录在 告中
quality ：图像质量，范围为[1,99]的整数，默认为10
Max_size：图片的最大大小，例如1200
Platforms: 适用平台Android, iOS, Windows

4> wake()

唤醒或解锁当前设备
Platforms: 适用平台Android

5> home()

返回目标设备主界面。
Platforms: 适用平台 Android, iOS

6> find_all(v)

在设备屏幕上找到所有出现的目标，并返回它们的坐标
Parameters: v-目标图标
Returns:
Platforms: 适用平台 Android, Windows, iOS

7> 其他命令keyevent、text、wait、wait、assert_exists、assert_not_exists、assert_equal、assert_not_equal、sleep

此处和上节ide 界面操作介绍相对应
python-自动化Airtest-1Airtest IDE篇
https://blog.csdn.net/weixin_42914706/article/details/125084340
主要是图片操作对代码间的转换，本质都是一样的命令，这里不做重复讲解

三： screen operation

1> touch(v, times=1, **kwargs)

v – 可为坐标或者图片
Times -要执行多少次触摸
Platforms: 适用平台 Android, Windows, iOS
Returns:返回坐标最终点击
android 平台

Windows 平台

2> click(v, times=1, **kwargs)

和touch 用法一致

3> double_click(v)

双击
v ： 要触摸的目标，可以是模板实例，也可以是绝对坐标(x, y)
Returns: 最终返回坐标并点击

4> swipe(v1, v2=None, vector=None, **kwargs)

手机左上角坐标为（0,0），右下角坐标为（1,1）
v1 to v2： 可为(x, y)，(x, y) 坐标，可为矢量：滑动动作的矢量坐标，也可以是屏幕百分比，例如(0.5,0.5)
Raises： 当没有提供足够的参数来执行交换操作时，一般的异常
Returns： 原点位置和目标位置
Platforms: 适用平台 Android, Windows, iOS

5> pinch(in_or_out=‘in’, center=None, percent=0.5)

设备屏幕上捏动作
Parameters:in_or_out, [“in”, “out”]
center : 缩放动作的中心，默认为None，即屏幕的中心
percent: 屏幕上缩放动作的百分比，默认为0.5
Returns: None
Platforms: 适用平台Android

四：airtest poco

python-自动化Airtest-3IDE poco介绍
https://blog.csdn.net/weixin_42914706/article/details/125350806

文章知识点与官方知识档案匹配，可进一步学习相关知识Python入门技能树首页概览211158 人正在系统学习中