README.md · Zhou Shihui/BoringTest

# BoringTest

这是一个执行PR测试验证的一个网站

所有软件和环境均在windows环境下部署

[包管理使用指导](bundle.md)

# 1.下载

源码下载： [BoringTest: 这是一个PR验证测试网站 (gitee.com)](https://gitee.com/yogaxxxxx/BoringTest)

软件下载： [BoringTest工具包](https://space.welink.huaweicloud.com/p/eaca46e8db2f95fff7a8753c29999558)

# 2.开发板环境配置

开发板驱动安装：

```
下载解压BoringTest工具包中的：DriverAssitant_v5.1.1.zip

双击DriverInstall.exe进行开发板驱动安装
```

hdc驱动安装:

```
下载解压BoringTest工具包中的：toolchains-windows-x64-4.1.3.2-Canary1.zip

将其解压到指定目录（随意），将此目录追加到环境变量中
```

测试：

```
打开cmd窗口执行：hdc list targets

显示sn号即为开发板环境配置成功
```

# 3.源码工程配置

jdk安装

```
下载解压BoringTest工具包中的：jdk-8u333-windows-x64.exe

一路安装即可（可选择自己的安装目录）

配置环境变量：
1.新增JAVA_HOME变量，值为安装目录
2.在Path中新增%JAVA_HOME%/bin
```

python安装

```
下载解压BoringTest工具包中的：python-3.7.9-amd64.exe

一路安装即可（可选择自己的安装目录）

配置环境变量：
在Path中新增自己的安装目录
```

idea安装：

```
下载解压BoringTest工具包中的：ideaIU-2023.1.exe

一路安装即可
```

配置源码工程：

```
使用idea打开项目文件：

1.进入Settings>Build,Execution,Deployment>Build Tools>Maven

2.查看 User settings file中settings.xml所在目录（没有此文件的话下载BoringTest工具包中settings.xml到这个目录）

3.打开settings.xml，将BoringTest工具包中的localRepository.zip解压后的目录配置到到下面的位置中

<localRepository>D:\localRepository</localRepository>

4.重新进入Settings>Build,Execution,Deployment>Build Tools>Maven 查看Local repository中是不是上面3中配置的目录

5.等待idea加载完成即可

6.此时就已经可以启动项目了，进行访问了
```

# 4.访问地址配置

此项配置BoringTset的访问地址，可根据子系统自身情况选择配置

```js
文件位置1: src/main/resources/application.properties

示例:
    server.servlet.context-path=yyy
    server.port=xxx

文件位置2: src/main/resources/static/config.js

示例:(和文件位置1中的yyy保持一致)
    global.__MY_CONFIG__ = {
        API_HOST: 'yyy'
    };
```

访问端口号：xxx（此项配置不可为空，为空默认8080）

访问路径：yyy（此项配置可以为空）

根据文件1、2即可得访问地址为：[http://localhost](http://localhost/):端口号/访问路径

# 5.用户配置

此项配置BoringTest的使用谁的账户来发送邮件和获取PR状态信息

```js
文件位置: data/config/user.json

示例:
{
  "email": "这里是你的邮箱，建议qq邮箱",
  "email_token": "邮箱token",
  "email_smtp": "smtp.qq.com",
  "gitee_token": "gitee token"
}
```

说明：

邮箱token可以在qq邮箱中：设置>账户> POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务 开启服务后获取；

email_smtp：邮箱服务器地址，qq邮箱即为smtp.qq.com（其他邮箱自己搜索一下）

gitee token可以在gitee中：账号设置>私人令牌>生成新令牌 获取；

# 6.CI配置

此项配置可以使BoringTest根据分支获取到准确的版本和测试用例

```js
文件位置: data/config/ci.json
```

说明：

后续有一些特殊的分支，按照规律继续往里面添加即可（后续看能不能把这个配置文件变成自动获取）

# 7.测试类型和模块配置

根据子系统自身情况配置对应模块，和上面7对应

```js
文件位置: src/main/resources/static/config.js

示例:
    global.__TDD_TYPE__ = {
        options: [
            {label: "ACTS"},
            {label: "DCTS"},
            {label: "UT"},
            {label: "FUZZ"},
            {label: "MST"},
            {label: "BENCHMARK"}
        ]
    };
    global.__MODULE__ = {
        options: [
            { label: "moudle1" },
            { label: "moudle2" },
            { label: "moudle3" },
        ]
    };
```

意为：

测试用例类型分为：ACTS、DCTS、UT、FUZZ、MST、BENCHMARK

测试模块分为：moudle1、moudle2、moudle3 ...

# 8.用例配置（重中之重）

此项配置的正确与否直接影响BoringTset是否可以根据测试类型和模块最终执行到正确的用例

```js
文件位置: data/config/case.json

[{
  "ACTS": {
      xxx
  },
  "DCTS": {
      xxx
  },
  "HATS": {
      xxx
  },
  "UT": {
      xxx
  },
  "FUZZ": {
      xxx
  },
  "ST": {
      xxx
  },
  "MST": {
      xxx
  },
  "BENCHMARK": {
      xxx
  }
}]
```

说明：

此项设置的简单与否与子系统是否完成部件化整改相关，建议找对子系统测试用例位置熟悉的人来配置

完成部件化整改： https://gitee.com/yogaxxxxx/BoringTest/blob/power/data/config/case.json

未完成部件化整改： https://gitee.com/yogaxxxxx/BoringTest/blob/dsoftbus/data/config/case.json

# 9.运行

方式一：idea运行

```
此种方式适用于调试代码

点击运行即可
```

方式二：Maven打包运行

```
1.点击idea右边侧栏的Maven,选择BoringTest>Lifecycle>package 进行打包

2.打包完成后，生成位置为项目位置下target目录下的 BoringTest-0.0.1-SNAPSHOT.jar

3.cmd窗口直接执行即可：java -jar BoringTest-0.0.1-SNAPSHOT.jar
```

# 10.访问

访问自己配置的域名即可：http://localhost:8081/test/dsoftbus

Zhou Shihui/BoringTest

简介

发行版

贡献者

近期动态

Zhou Shihui/BoringTest .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Zhou Shihui/BoringTest