# app-ui-po

**Repository Path**: ghy250/app-ui-po

## Basic Information

- **Project Name**: app-ui-po
- **Description**: python+uiautomator2+jenkins+allure的po设计模式的app自动化框架
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-09
- **Last Updated**: 2024-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# app-ui-po

#### 介绍
python+uiautomator2+jenkins+allure的po设计模式的app自动化框架

#### 核心目录说明
1. element:元素层,存放操作对象的目录,此处的代码是根据data/ele.xlsx的文件自动生成,具体方法在common目录下
2. common：公共方法;如日志方法、基础类、命令行方法(以adb命令为主)
3. data：目前存放了一个元素的excel,所有元素再此维护;框架提供了通过excel生成元素层代码的方法
4. module:业务层;复杂的业务操作以及重复率较高的操作将在此封装方法
5. test_case:用例层;测试用例编写处
6. tools:工具包目录;第三方工具均存与此目录.例如OCR/Allure/jenkins/atx依赖等等
7. config:配置目录;用于存放环境参数,如系统账号、数据库链接账号等

#### 框架搭建
1. 安装jdk11+
2. 安装安卓SDK
3. 安装模拟器,并在模拟器上安装被测试软件
4. 安装allure
5. 安装jenkins
6. 安装OCR
7. 安装python3.11+
8. 创建python项目(建议用虚拟环境)
9. 给模拟器安装atx(公共方法common/cmd下封装了安装方法)
10. 安装元素识别工具:uiauto或weditor
11. 安装插件: pip install -r requirements.txt

#### 使用说明
1. 本地运行: 
   1. 进入项目根目录,命令行执行: pytest --alluredir ./report/allure-data/
   2. 查看allure报告: allure serve ./report/allure-data/
   
2. jenkins构建: 
   1. 将默认的jenkins windows服务禁用
   2. 制作jenkins war包启动方式(如果坚持使用windows服务启动jenkins的方式,将无法看到浏览器操作,因为它是后台运行)
   3. 构建合适的流水线(主要是配置git、allure和pytest运行命令) 
   4. 运行流水线