# TreeATE

**Repository Path**: zhenchaowang/TreeATE

## Basic Information

- **Project Name**: TreeATE
- **Description**: TreeATE是Tree Automatic Test Equipment的缩写，专注服务于工厂成品或半成品测试自动化的一种开源软件工具平台
- **Primary Language**: C/C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/treeate
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2021-03-12
- **Last Updated**: 2024-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Github issues](https://img.shields.io/github/issues/WilliamYinwei/TreeATE)](https://github.com/WilliamYinwei/TreeATE/issues)
[![Github release (latest SemVer)](https://img.shields.io/github/v/release/WilliamYinwei/TreeATE)](https://github.com/WilliamYinwei/TreeATE/releases/latest)
[![Github All Releases](https://img.shields.io/github/downloads/WilliamYinwei/TreeATE/total)](https://github.com/WilliamYinwei/TreeATE/releases)

# TreeATE
TreeATE是Tree Automatic Test Equipment的缩写，专注服务于工厂成品或半成品测试自动化的一种开源软件工具平台。

## 目标
对接工业物联网，打造简单易用的工厂自动化测试开源软件工具。

## 系统架构
![TreeATE系统架构图](https://raw.githubusercontent.com/WilliamYinwei/TreeATE/master/Doc/images/arch.png)
TreeATE借鉴了Chrome的多进程设计思路，支持并行化测试。每个独立的测试进程由“Test Engine”承接。 TreeATE（GUI）是向工厂用户提供的HMI（人机交互界面），详见博客《[开始使用TreeATE](https://blog.csdn.net/vivasoft/article/details/86063014)》。
“Test Engine”是TreeATE的核心，向下负责管理不同设备驱动，对接MES系统、测试结果输出（数据库）、图形化人机界面插件，向上接受不同种语言的测试用例（当前版本支持JavaScript和Python）和测试参数配置等数据。
通过TreeATE Dev可以编辑测试参数配置文件和开发测试用例。当然像上面提到的各种组件需要通过QT进行开发，详情的请关注[TreeATE专栏](https://blog.csdn.net/vivasoft/column/info/31202)，找到TreeATE组件或插件开发指南。

## 功能特性
* 为工厂提供统一且简单易用的用户操作界面，减免每个产品测试都有不同的程序操作界面的学习成本；
* 采用多进程技术，支持成品或半成品并行测试，测试运行时更加稳定；
* 主界面支持中文和英文；
* 支持测试工程整体循环测试；
* 支持测试失败则停止测试；
* 支持扫码加载测试工程；
* 支持扫码开始测试；
* 支持无服务器和网络自动切换为本地工作模式，测试结果本地留存；
* 支持测试结果本地查看和管理；
* 提供界面插件扩展接口；
* 支持二次自定义开发(TreeATE Dev)：
  * 支持QtScript（类JavaScript，基于ECMA标准脚本语言）快速开发自动化测试用例；
  * 支持Python语言开发自动化测试用例；
  * 提供设备控制组件化支持；
  * 提供辅助二次开发时所需的人机交互公共组件；
  * 提供TreeATE系统与MES系统的扩展接口和组件样例；
  * 支持测试参数CSV格式文件导入和导出；

TreeATE界面预览
-------------------------------------------------------------------------------
![TreeATE GUI](https://raw.githubusercontent.com/WilliamYinwei/TreeATE/master/Doc/images/TreeATE.png)
关于如何使用TreeATE，请点击[这里](https://github.com/WilliamYinwei/TreeATE/wiki/Start-TreeATE)

TreeATE Dev界面预览
-------------------------------------------------------------------------------
![TreeATE Dev GUI](https://raw.githubusercontent.com/WilliamYinwei/TreeATE/master/Doc/images/TreeATE%20Dev.png)
关于如何使用TreeATE Dev，请点击[这里](https://github.com/WilliamYinwei/TreeATE/wiki/TreeATE-Dev)

## 开发编译

TreeATE基于QT开发，运行于Windows 32位系统（支持64位）。在编译TreeATE之前，你需要安装以下开发工具：
* [qt-opensource-windows-x86-msvc2013-5.7.0](http://download.qt.io/archive/qt/5.7/5.7.0/qt-opensource-windows-x86-msvc2013-5.7.0.exe)	(L)GPL v3
* [QScintilla_gpl-2.10.3](https://github.com/WilliamYinwei/qscintilla/releases/tag/v2.10.3) GPL v3
```
  // 进入QT命令行模式  
  cd qt4qt5
  qmake
  // 进入VS 2013 x86命令行模式
  cd qt4qt5
  nmake
  nmake install 
```
* [PythonQt 3.2.0](https://github.com/MeVisLab/pythonqt)	LGPL v2.1 
  - 这个可以先下载，不用先编译，因为3part中已默认生成了32位的DLL库文件
* [Python27 32位](https://www.python.org/ftp/python/2.7.15/python-2.7.15.msi) Python License (Python-2.0)

**注意: 推荐统一采用32位编译，并选择Release配置运行**

关于以上工具的安装和详细配置请参见它们的帮助文档。

### 设置环境变量
在Windows系统环境变量中添加如下2个环境变量，根据Python27的安装路径，例如
* PYTHON_PATH  C:\Python27\
* PYTHON_LIB  C:\Python27\libs\

## 部署
在开始菜单中找到Qt 5.7 32-bit for Desktop(MSVC 2013)命令行窗口进入构建的目录。
例如：D:\Projects\build-TreeATE-Desktop_Qt_5_7_0_MSVC2013_32bit-Release\bin\
再执行以下命令
* windeployqt TestEngine.exe
* windeployqt TreeATE.exe
* windeployqt TreeATEDev.exe
* windeployqt TreeResults.exe

### 打包成安装文件
依赖 Inno Setup
* 通过 Inno Setup 打开 Setup/Setup.iss文件
* 找到第37行，根据本地实际输出的构建目录替换掉路径D:\Projects\build-TreeATE-Desktop_Qt_5_7_0_MSVC2013_32bit-Release\bin
* 再执行Build>>Compile(Ctrl+F9)或Run(F9)

运行
-------------------------------------------------------------------------------
在试用运行之前，一般还需要以下几个操作：
* 手动复制3part/PythonQt/lib/PythonQt-Qt5-PythonXXX.dll(xxx是你本地Python环境的版本号）。PythonQt-Qt5-PythonXXX.dll是通过PythonQt生成的库。

在构建的目录下启动TreeATE.exe即可。例如作者的开发构建目录为：
D:\Projects\build-TreeATE-Desktop_Qt_5_7_0_MSVC2013_32bit-Release\bin\

技术交流
-------------------------------------------------------------------------------
QQ：499722676/226406709