Airtest

接口：

- 新增了接口`airtest.__version__`用来查看airtest当前版本号，也可以运行命令行`airtest version`查看
- log()接口目前可以更好地将报错或信息显示到报告中了
- 在报告中显示信息，`log(string_msg)`
- 在报告中显示报错，`log(Exception)`, `log(title, string_error)`

报告：

- 修复了一些新版本报告的BUG
- 显示log.txt、步骤绝对时间，截图点击后可放大显示
- 可自定义截图压缩精度，有以下使用方式:
- 使用命令行启动，`airtest run ... --compress quality`
- 在脚本中自定义，优先级高于命令行，取值范围是1-99的正整数，airtest默认取10，如果希望获得更高精度的图片可以改为75

import airtest.core.api import *
ST.SNAPSHOT_QUALITY = xxx [1, 99]

- 设置某张图片的压缩精度，`snapshot(quality=my_quality)`
- 简化了生成报告的代码，去掉了一些无需额外传入的参数，现在只需要这样写就可以了：

rpt = LogToHtml("test_bj.air", "log", export_dir="export", plugins=["poco.utils.airtest.report"])
rpt.report()


windows:

- 修正了touch直接设置光标位置导致的部分ui未识别到光标位移的问题
- 修正了swipe在双屏模式下会多位移一倍距离的问题
- 修正了在某些版本的Python和pywin32下会报dll缺失的问题


Android:

- 更新了minicap.so，对部分Android10手机进行了兼容，但是并不完全，Android10的更好兼容请参考下一个版本1.1.3
- 更新了Yosemite.apk，修复了横屏截屏的bug，更新了录屏接口和录屏的方式，对部分手机有更好的兼容
- 修复了部分模拟器初始化时的失败问题，现在无需勾选`use ADB orientation`也能连接模拟器了
- adb的cmd操作增加了timeout参数，可以指定指令运行的超时时间了
- 去掉了在windows下运行cmd时如果出现异常，将导致弹出"adb.exe停止响应"的弹窗，避免脚本被卡住

-----------

Interface:

- Added interface `airtest .__ version__` to view the current version of airtest. You can also run the command line` airtest version` to view it.
- The `log()` interface can now better display errors or information in reports
- Display information in the report, `log (string_msg)`
- Show errors in the report, `log (Exception)`, `log (title, string_error)`

Report:

- Fixed some bugs reported by the new version
- Display log.txt, step absolute time, click the screenshot to zoom in
- You can customize the compression precision of screenshots, which can be used in the following ways:
- Start from the command line, `airtest run ... --compress quality`
- Customize in the script, the priority is higher than the command line, the value range is a positive integer from 1 to 99, the default value of airtest is 10, if you want to obtain a more accurate picture, you can change it to 75

import airtest.core.api import *
ST.SNAPSHOT_QUALITY = xxx [1, 99]

- Set the compression precision of a picture, `snapshot (quality = my_quality)`
- Simplified the code for generating reports, removing some parameters that do not need to be passed in, now it is only necessary to write like this:

rpt = LogToHtml("test_bj.air", "log", export_dir="export", plugins=["poco.utils.airtest.report"])
rpt.report()


Windows:

- Fixed the problem that some UIs did not recognize the cursor displacement caused by touch directly setting the cursor position
- Fixed an issue where swipe would double the distance in dual screen mode
- Fixed the problem of missing dlls under certain versions of Python and pywin32


Android:

- Updated minicap.so, compatible with some Android10 phones, but not completely. For better compatibility of Android10, please refer to the next version 1.1.3
- Updated Yosemite.apk, fixed the bug of horizontal screen capture, updated the screen recording interface and the screen recording method, better compatibility with some mobile phones
- Fixed the failure of some simulators during initialization, now you can connect to the simulator without checking the `use ADB orientation`
- Added a timeout parameter to the cmd operation of adb, which can specify the timeout period for the instruction to run
- Removed the "adb.exe stopped responding" pop-up window if an exception occurs when running cmd under windows, avoiding the script being stuck

>>> print(TIDevice.list_app(udid, "system"))

>>> print(TIDevice.list_wda(udid))
['com.test.WebDriverAgentRunner.xctrunner']

>>> print(TIDevice.device_info(udid))
{'productVersion': '12.4.8', 'productType': 'iPhone7,2', 'modelNumber': 'MG472', 'serialNumber': 'DNPNW6EJG5MN', 'timeZone': 'Asia/Shanghai', 'uniqueDeviceID': '10da21b9091f799891557004e4105ebab3416cb9', 'marketName': 'iPhone 6'}

>>> TIDevice.start_app(udid, "com.apple.mobilesafari")

>>> TIDevice.stop_app(udid, "com.apple.mobilesafari")

>>> print(TIDevice.ps(udid))
[ {'pid': 215, 'name': 'MobileMail', 'bundle_id': 'com.apple.mobilemail', 'display_name': 'MobileMail'}]

>>> print(TIDevice.ps_wda(udid))
['com.test.WebDriverAgentRunner.xctrunner']



The execution example of the `TIDevice.xctest` interface is as follows:

import threading
wda_bundle_id = TIDevice.list_wda(udid)[0]
Create a thread to execute xctest
t = threading.Thread(target=TIDevice.xctest, args=(udid, wda_bundle_id), daemon=True)
t. start()
time. sleep(5)
ps_wda = TIDevice.ps_wda(udid)
print(ps_wda)
time. sleep(5)
Terminate thread
t.join(timeout=3)



Changes to the using interface

The function of the `using` interface is to support another script to be referenced in the script, and at the same time, it can also allow airtest to correctly read the image path in other scripts.

Suppose the directory structure is as follows:


demo/
foo/
bar.air
baz.air
main.py


If we want to reference `foo/bar.air` and `baz.air` in main.py, we can set the project root path to `ST.PROJECT_ROOT`, or make sure the project root path is the current working directory:


main.py
from airtest.core.api import *
ST.PROJECT_ROOT = r"D:\demo" This line can be ignored if it is the current working directory
using("foo/bar. air")
using("baz. air")


If we wanted to reference `baz.air` in `foo/bar.air`, we could write:


foo/bar.air
from airtest.core.api import *
using("../baz.air")


New error type NoDeviceError

If no device is currently connected, but some interfaces that need to be connected to the device are called, an exception will be thrown: `NoDeviceError("No devices added.")`

Other changes

1. When the airtest script raises an assert exception, the exit code is 20 to distinguish it from other errors
2. Updated Yosemite.apk and fixed some stability issues
3. The new interface `set_focus` on the windows platform has the same function as the original `set_foreground`