# aipsi-cws-auto-test

**Repository Path**: DaHuYuXiXi/aipsi-cws-auto-test

## Basic Information

- **Project Name**: aipsi-cws-auto-test
- **Description**: aipsi-cws-auto-test
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2022-07-08
- **Last Updated**: 2022-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 移动应用自动化测试

## 环境事项
- java-client: 7.6.0
- appium-server版本: 1.20+
![img.png](img.png)
- chromeDriver: >=70+,<=80+ ,最好是70或者72

下载地址如下: http://chromedriver.storage.googleapis.com/index.html

![img_1.png](img_1.png)

- 替换appium-server启动使用的chromeDriver

![img_2.png](img_2.png)
![img_3.png](img_3.png)

****

## 依赖事项

- 首先拉取该仓库到本地: https://gitee.com/DaHuYuXiXi/appium-hybird-client
- 安装到本地仓库
![img_4.png](img_4.png)
- 完工!!!


****

## 配置文件事宜

关于appium服务器的配置文件默认为: appiumConfig.properties 

其中默认给出的配置为:
- deviceName=127.0.0.1:62001 (默认使用夜神模拟器)
- platformName=Android (默认使用安卓平台)
- appPackage=io.ionic.starter 
- appActivity=.MainActivity
- automationName=uiautomator2 (默认使用安卓平台引擎,苹果端需要替换)
- noReset= false (每次测试前,都会先关闭然后，清空应用程序数据)
- appiumServerAddress=http://127.0.0.1:4723/wd/hub (appium服务器地址,默认即可)
- implicitlyWait=30 (默认隐式等待30s,webview测试中发现设置后不生效,暂未知晓具体原因)
- webview= WEBVIEW_io.ionic.starter (默认切换到该webview context)
- clearSystemFiles=false (默认不会在每次会话结束时,重新卸载安装应用程序,如果设置为true了,那么需要指明apk的路径,因为需要从本机推送apk到手机)
- app=app-debug.apk (默认会去当前项目路径下寻找apk)

**对于安卓端来说,只需要考虑deviceName参数即可,如果不是使用的夜神模拟器,只需要在配置文件中声明覆盖默认值即可。**

**对于苹果端来说,需要考虑下面这些属性:**
- deviceName 
- UDID
- app (指定测试apk在本机的位置,如: C:/deskTop/app-debug.apk)
- platformName
- automationName

其中要使用IOS环境进行测试,必须先手动开启IOS环境,通过启动时设置VM参数: -DdeviceType=ios ,或者手动通过编码方式:
```java
System.setProperty(DEVICE_TYPE,IOS);
```
还可以直接在配置文件中指定开启: (推荐方式!!!)

```java
ios=true
```
**开启了IOS环境之后,platformName和automationName属性会被设置为默认值,不需要管,只需要声明:deviceName,UDID和app即可**

- ios的platformName默认值为: iOS
- ios的automationName默认值为: XCuiTest
- app默认值为app-debug.apk (默认会去当前项目路径下寻找apk)

****

## 测试数据

### 格式

测试文件中测试数据的声明格式如下:

```yaml
#测试类的全类名,注意要将.替换为-
com-aipsi-cws-auto-cases-TestSupplierAnno:
                    #如果某个测试方法中需要输入测试数据,那么下面写上方法名:
                    #每一个测试数据按照-分割,尽量不要让测试数据中出现"-"字符,否则可能会导致解析出现错误
                             supplierAddTest: 测试数据1-测试数据2-测试数据3
                             sipplierListTest: 测试数据1-测试数据2-测试数据3
```
****
## 异常自动截图
异常自动截图功能,默认是关闭的,如果要开启,可以在配置文件中进行配置
````yaml
#是否开启异常截图
openExSnapshot=true
#异常截图生成路径
snapshotFilePath=snapshot/supplier/
````
**如果出现错误,会进行截图并且将异常记录在文件中**

**截图和异常文件命名格式为: yy-MM-dd-HH-mm-ss-UUID前五个字符.png/.text**