Skip to content

Latest commit

 

History

History
156 lines (111 loc) · 4.16 KB

uitrace.md

File metadata and controls

156 lines (111 loc) · 4.16 KB

Uitrace本地化部署

WeAutomator底层框架uitrace现已开源，使用者可以在本机python环境中安装uitrace相关wheel包， 编写相关脚本，实现对设备进行本地测试。

安装

可从uitrace官方仓库的release或者相关微盘中下载paddleocronnx、uitrace和advanced的wheel包，或者联系相关人员获取。

安装命令如下

python3 -m pip install paddleocronnx-2.5.0.3-py3-none-any.whl
python3 -m pip install uitrace-x.x.x-py3-none-any.whl
python3 -m pip install advanced-x.x.x-py3-none-any.whl

运行以下命令验证是否安装成功

pip show paddleocronnx
pip show uitrace
pip show advanced

使用者需要根据具体的版本号来调整安装命令。

Uitrace本地化使用指引

本地测试脚本编写

提供简单样例如下

from uitrace.api import *

def test():
    init_driver(os.path.dirname(__file__))
    pos = find('obj_1663242961.jpg', by=DriverType.CV)
    click(pos, by=DriverType.POS)
    stop_driver()

if __name__ == '__main__':
    test()

其他api的使用方式可参考API文档

本地指定运行设备

uitrace本地化部署后支持本机连接多台设备，用户可以在执行python脚本时指定设备运行，完成对特定设备或多台设备的测试，同时脚本中也能从当前设备信息中获取设备的信息。

init_driver()时指定设备

def init_driver(
        os_type: OSType = None,
        udid: str = None,
        max_size: int = 800,
        bundle_id: str = "com.facebook.WebDriverAgentRunner.xctrunner",
        screen_port: int = None,
        ctrl_port: int = None,
        mode: RunMode = RunMode.SINGLE,
        driver_lib: DriverLib = None,
        adb_path: str = "", **kwargs):
    """初始化设备驱动及环境.

    Args:
        os_type (OSType): 设备系统，安卓为OSType.ANDROID，iOS为OSType.IOS
        udid (str): 设备ID
        max_size (int): 传输画面的最大边长
        bundle_id (str): 设备为iOS时，WDA的bundle id
        screen_port (int): 获取画面服务的端口，不指定则使用闲置端口
        ctrl_port (int): 操作服务的端口，不指定则使用闲置端口
        mode (RunMode): 运行模式，一般使用默认即可
        driver_lib (DriverLib): 底层驱动使用的框架
        adb_path (str): adb路径，用户可进行配置以避免adb冲突；为None时则使用工具中自带的adb文件
        **kwargs: 脚本执行产出路径的修改等

    """

通过设置udid参数来指定设备，如：

# 指定设备cef0a3
init_driver(udid='cef0a3')

命令行传入设备id

用户可以指定单台或者多台设备，运行同一脚本。

# test.py
from uitrace.api import *


init_driver(workspace=os.path.dirname(__file__))
click('日历', by=DriverType.OCR, offset=None, timeout=30)
stop_driver()
# 命令行
# 指定一台设备
python3 test.py --udid=3debcc18

# 指定多台设备
python3 test.py --udid=3debcc18 & python3 test.py --udid=cea0a3ff

用户可以指定单台或者多台设备，运行同一pytest组织的用例

# main.py
from uitrace.api import *

pytest_main([os.path.join(os.path.dirname(__file__), 'test_case1.py')])
# test_case1.py
from uitrace.api import *

def test_1():
    init_driver(workspace=os.path.dirname(__file__))
    start_app("com.tencent.mobileqq")
    click([0.1, 0.1], by=DriverType.CV, offset=None, timeout=30, duration=0.05)
    stop_driver()
# 命令行
# 指定单台设备
python3 main.py --udid=3debcc18

# 指定多台设备
python3 main.py --udid=3debcc18 & python3 main.py --udid=cea0a3ff

脚本中获取设备id等信息

用户可参考uitrace/utils/toolkit.py中的parse_args()函数，里面列举了可以获取到的信息，如想在脚本中获取设备id，可按以下方式：

from uitrace.utils.toolkit import parse_args() as args

udid = args.udid

用户可以根据不同的设备id，在脚本里指定不同的测试场景

安装使用过程中遇到问题可联系相关人员或者在Github issues区提问。