# Airtest-Framework

**Repository Path**: yanzhengpan/airtest-framework

## Basic Information

- **Project Name**: Airtest-Framework
- **Description**: Airtest- Framework 是 基于 unittest、Flask、Airtest 搭建的 开源的 UI 自动化框架系统
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 1
- **Created**: 2024-01-12
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: testing

**Tags**: None

## README

# Airtest- Framework



## 平台简介

**Airtest- Framework 是 基于 unittest、Flask、Airtest 搭建的 开源的 UI 自动化框架系统**

- 提供 HTTP API 接口，实现自动解析包名并自动执行 `相应目录下的 Case`。

- 目前仅支持单台设备连接。
- 多个任务会自动排队处理。



## 系统要求

- Python >= 3.8



## 系统模块

```markdown
├── Base                  // 基础目录
├── Common         		  // 公共目录
├── Entrance              // Flask 服务入口
	└── run.py			  // 项目启动文件
├── Test              	  // 测试目录
├── TestCase              // 测试用例目录
├── TestData              // 测试用数据目录
├── TestSuite             // 测试用套件目录
├── requirements.txt      // 项目依赖文件
```



## 架构图





## 安装

### 1、下载项目：

```bash
git clone https://gitee.com/panlsp/airtest-framework.git
```

### 2、进入项目目录：

```bash
cd Airtest-Framework
```

### 3、安装依赖项

```bash
pip install -r requirements.txt

# 指定清华源下载
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```



## 修改配置

手机连接到电脑，使用 ADB 命令查看当前设备列表

```bash
> adb devices
List of devices attached
RKKDU17C30000079        device
```

**Base/ConstPool.py**

```python
# 添加手机设备信息(值改为自己的手机设备)
DEVICE1 = "Android://127.0.0.1:5037/RKKDU17C30000079"
```



## 启动

启动项目

```bash
python Entrance/run.py
```

![输入图片说明](README.assets/image-20240112104753668.png)



## 请求接口

- 接口地址：http://127.0.0.1:5000/airtest/add_task

- 请求方式：POST （form-data）

- 请求参数（网络地址的APK下载地址）：apk_url：https://downapp.baidu.com/baidusearch/AndroidPhone/13.49.0.10.1/1/1037068k/20240106221103/baidusearch_AndroidPhone_13-49-0-10-1_1037068k.apk

- 返回值：

  ```json
  {
    "code": 0,
    "data": "ok",
    "msg": "success"
  }
  ```



## 执行完成

![输入图片说明](README.assets/image-20240112105027248.png)

![输入图片说明](README.assets/image-20240112105054789.png)

![输入图片说明](README.assets/image-20240112105134741.png)


## 编写 `TestCase` 注意事项

**命名规范**

```markdown
1、读取需要测试的包名，例：com.baidu.searchbox
2、TestCase新建程序名称文件夹，如：baidu
3、新建Python文件&测试类（BaiduSearchbox）：大驼峰结构
```