# Liuma-agent

**Repository Path**: tiger.study/Liuma-agent

## Basic Information

- **Project Name**: Liuma-agent
- **Description**: 轻量级低代码自动化测试平台，一个平台解决API/WebUI/AppUI测试，本项目为设备代理端
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: http://www.liumatest.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 7
- **Created**: 2024-12-15
- **Last Updated**: 2024-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 流马-低代码测试平台
## 一、项目概述

流马是一款低代码自动化测试平台，旨在采用最简单的架构统一支持API/WebUI/AppUI的自动化测试。平台采用低代码设计模式，将传统测试脚本以配置化实现，从而让代码能力稍弱的用户快速上手自动化测试。同时平台也支持通过简单的代码编写实现自定义组件，使用户可以灵活实现自己的需求。

本项目分为平台端和引擎端，采用分布式执行设计，可以将测试执行的节点(即引擎)注册在任意环境的任意一台机器上，从而突破资源及网络限制。同时，通过将引擎启动在本地PC上，方便用户快速调试测试用例，实时查看执行过程，带来传统脚本编写一致的便捷。

在线体验: [演示平台](http://demo-ee.liumatest.cn)

官网地址: [流马官网](http://www.liumatest.cn)

社区地址: [流马社区](http://community.liumatest.cn)

配套开发教程: [B站课堂](https://www.bilibili.com/cheese/play/ss7009)

如果本项目对您有帮助，请给我们一个Star，您的支持是我们前进的动力。

如果您需要二次开发，请务必遵循AGPL开源协议，并保留版权信息。我们保留一切对于侵权行为追责的权利。

注明: 设备挂载项目主要参考ATX组织的atx-server2，在一些继承的代码文件中有标明，更多内容请参考: [openATX](https://github.com/openatx/atxserver2)

## 二、功能介绍

![system](https://user-images.githubusercontent.com/96771570/221833391-9d35308a-3f90-47c7-9e9d-e62fc1201f18.png)

1. API测试
```
(1) 支持单接口测试和链路测试。
(2) 支持接口统一管理，支持postman/swagger导入。
(3) 支持一键生成字段校验的接口健壮性用例。
(4) 支持全局变量、关联、断言、内置函数、自定义函数。
(5) 支持前后置脚本、失败继续、超时时间、等待/条件/循环等逻辑控制器。
(6) 支持环境与用例解耦，多种方式匹配域名，让一套用例可以在多个环境上执行。
```

2. WebUI测试
```
(1) 支持关键字驱动，零代码编写用例。
(2) 支持UI元素统一管理，Excel模板批量导入。
(3) 支持自定义关键字，封装公共的操作步骤，提升用例可读性。
(4) 支持本地引擎执行，实时查看执行过程。
(5) 支持与API用例在同一用例集合顺序执行。
```

3. AppUI测试
```
(1) 支持WebUI同等用例编写和执行能力
(2) 支持安卓和苹果系统
(3) 支持持真机管理、投屏和在线操作
(4) 支持控件元素在线获取，一键保存元素
(5) 支持实时查看执行过程
```

更多功能及详细请参考: [用户手册](http://www.liumatest.cn/productDoc)


## 三、开发环境

环境依赖: Python3.8

IDE推荐: python使用pyCharm

1. 项目启动
```
Step1: 安装python依赖包 pip3 install -r requirements.txt

Step2: 修改/config/config.ini文件中Platform->url为后端地址

Step3: 修改/config/config.ini文件中Provider->host为本机IP

Step4: 修改/config/config.ini文件中StartParam是否启用安卓/苹果设备挂载

Step5: 如挂载苹果设备 win电脑需要安装iTunes 且手机预安装WDA并填写wda-bundle-id

Step6: owner填写平台用户账号和project填写项目名 默认system为所有项目所有人共享设备

Step7: 电脑usb连接手机后 启动代理 python3 startup.py
```

2. 验证启动

平台设备管理查看自己的设备，显示在线，证明启动成功。
注意: 
```
① 本地挂载的设备仅限同一网络下的人或引擎可以在线操作执行测试, 其他网络的人或引擎无法使用
② 如同网络下无法使用，请检查挂载设备的电脑是否开启防火墙
③ 如需跨网段使用，可以设置网络反向代理或给主机添加公网IP，具体情况找自家IT解决
```

## 四、容器部署

设备代理项目暂不支持容器部署，秉持着服务于中小企业的原则，利用闲散设备即插即用进行app测试，而不是投入高成本搭载大型云真机集群。


## 五、关于我们

流马秉持着帮助中小企业的测试团队快速建立自动化体系的目标，将会不断迭代并吸取用户的建议，欢迎大家给我们提出宝贵的意见。

如需学习平台开发相关内容或在线交流，可关注个人微信公众号【流马测试】

![qr](https://user-images.githubusercontent.com/96771570/161195670-3868f409-ed49-431f-8650-185e3e179679.png)