# Appium_Pytest_Allure

**Repository Path**: hcemmm/appium_-pytest_-allure

## Basic Information

- **Project Name**: Appium_Pytest_Allure
- **Description**: 基于Appium的利用PO设计理念编写的APP自动化测试框架，测试报告采用allure生成，支持多台设备并发测试。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 22
- **Forks**: 6
- **Created**: 2020-09-26
- **Last Updated**: 2025-12-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 简介
基于appium+pytest+allure编写的安卓APP自动化框架
+ appium：手机UI自动化框架，目前已更新2.x
+ pytest：主流的自动化测试框架，可灵活进行测试用例编排
+ allure：生成html测试报告的框架
  
## 环境配置
#### 配置appium2.x所需环境
https://www.jianshu.com/u/c36f8b721775

#### 安装allure2.0+
下载地址：https://github.com/allure-framework/allure2/releases

windows安装allure教程：

1）下载最新版本即可，如windows下载 `allure-2.25.0.zip`

2）解压文件到目录，如解压到`D:\allure-2.25.0`

3）将系统环境变量path加入allure的bin目录，如：`D:\allure-2.25.0\bin`

4）打开cmd终端，输入 
```
allure --version
```
若显示版本号`2.25.0`则表示安装成功

#### 安装项目依赖
安装python相关库：在该项目根目录运行cmd命令
```
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

## 脚本结构
- config：存放全局配置文件
- data：存放项目加载的数据，包含cookie和数据字典
- download：调用下载方法时，下载的文件存放在此文件夹（暂未实现）
- handler：组件，包含allure日志step组件、log日志组件、API响应捕捉器
- logs：脚本执行时产生的日志存放在此文件夹
- **page：由测试人员编写维护，存放项目的各个页面元素定位以及步骤方法脚本**
- report：存放allure测试报告的文件夹
- screenshot：脚本执行过程中产生的截图存放在此文件夹
- **testcase：由测试人员编写维护，存放项目的各个页面的测试用例脚本**
- upload：文件上传场景所需的文件存放在此文件夹（暂未实现）
- utils：工具类，包含数据库工具类、数据转换公共工具类等，工具类的方法一般与业务无关
- yaml：存放所测试APP相关的参数配置项
- conftest.py：pytest特有的测试配置⽂件，用于设置项目所需的fixture，以及Hook函数
- pytest.ini：pytest的配置文件，用于配置allure结果路径、测试用例收集规则
- requirements.txt：项目依赖项信息文件
- run.py：脚本运行主函数

## 执行脚本
#### pycharm启动
1. 使用pycharm打开该项目；
2. 查看`run.py`，修改`device_infos`为自己的手机相关配置，支持多台手机并发；
3. 修改`yaml/desired_caps.yaml`为APP相关配置；
4. 根据你的APP在`page`文件夹下编写相关页面方法，在`testcase`编写相关测试脚本；
5. 在cmd运行appium服务，指定端口和你设置的`device_infos`保持一致，如：
```
appium -p 4725
```
如果`device_infos`有多部手机，则启动多个cmd运行appium服务，并设置不同的端口号；
6. 运行`run.py`即可。

#### 查看测试报告
若直接打开`./report/allure_report/设备名/index.html`文件，页面会显示Null，因为该报告需要在web服务器打开才能正常显示，所以需使用以下方法打开报告：

pycharm打开该项目，在 `./report/设备名/allure_report` 文件夹中，右键`index.html`文件，选择`Open in browser->chrome`即可查看测试报告