|
|
@@ -1,6 +1,11 @@
|
|
|
# 慕测安卓应用自动化测试中台系统
|
|
|
系统说明：本系统为部署在安卓机柜上的系统，为企业版or教育版提供自动化测试服务。
|
|
|
|
|
|
+## 特别说明
|
|
|
+因为本系统涉及到安卓手机等物理设备，所以对于物理环境较为敏感。
|
|
|
+本系统提供的功能的前提是，在机柜上有稳定连接设备。因为涉及到物理设备，所以有些情况会比较玄学。
|
|
|
+如遇到设备相关的问题，请自行Google解决。
|
|
|
+
|
|
|
## 使用方法
|
|
|
|
|
|
### 编译
|
|
|
@@ -12,6 +17,19 @@
|
|
|
2. 执行java -jar xxx.jar即可
|
|
|
3. 所有文件夹中的文件不要轻易删除，很多都是依赖文件以及配置文件。
|
|
|
|
|
|
+### 私有云环境执行说明
|
|
|
+1. 因为私有云不保证机柜可以上外网，所以私有云版本使用本地存储保存数据
|
|
|
+2. 使用前请保证部署机器上有nginx静态文件服务器
|
|
|
+3. 项目启动命令修改为
|
|
|
+java -jar xxx.jar --spring.profiles.active=privatecloud --fs_dir=/Users/henrylee/business/download --data_url_prefix=http://{ip}:{port}/download/trace_data/
|
|
|
+4. --spring.profiles.active：指定启动配置文件，具体内容可以看application.yaml
|
|
|
+5. --fs_dir：指向本地的nginx静态资源服务器中存放数据的文件夹
|
|
|
+6. --data_url_prefix：报告中下载路径的前缀，ip为部署机器ip，port为文件服务端口
|
|
|
+7. 需要特别注意的是，在第三点的例子中，文件服务器的路径为/Users/henrylee/business，download是其中的相对路径，
|
|
|
+这个download与data_url参数中的download是对应的，
|
|
|
+以及trace_data文件夹是默认生成的，可以不管
|
|
|
+8. 私有云版本相关问题，可以联系郭超同学。
|
|
|
+
|
|
|
### 环境说明
|
|
|
1. 本项目为SpringBoot项目，组件均已在mvn中配置，可直接编译执行。
|
|
|
2. lib文件夹下aapt工具不同系统有不同的版本，请使用部署的操作系统中安卓环境的aapt工具
|
|
|
@@ -21,8 +39,14 @@
|
|
|
### 服务器环境要求
|
|
|
1. 服务器中应有redis实例，端口6379，建议使用docker部署
|
|
|
2. 服务器中应有完整的appium环境，具体搭建指南请Google。或者使用慕测全家桶Linux环境。
|
|
|
-3. 建议使用Appium1.7.2，如需更新（如需要使用一些新特性），使用npm命令即可，但是由于AppiumServer有些版本存在Bug，所以不保证更新后系统的稳定性。
|
|
|
-4. 使用前请使用adb devices命令查看可用设备，如无可用设备，系统也没啥意义。
|
|
|
+（需要注意的是，慕测全家桶中的npm，node与appium版本较为老旧，可能会和新系统出现不兼容的情况，主要的体现是AppiumDriver始终无法初始化，
|
|
|
+如果遇到类似情况，请更新node，npm以及Appium
|
|
|
+3. 目前稳定运行的的环境为node10.16.3，npm6.13.4.
|
|
|
+但是理论上node与npm的版本越新越好，只要能支持相关Appium版本的安装即可（就是比较新的Appium可能旧版本的npm装不上
|
|
|
+4. 建议使用较新版本的Appium Server，
|
|
|
+目前尝试过可以稳定运行的版本为1.13.0，如需更新（如需要使用一些新特性），使用npm命令即可，但是由于AppiumServer有些版本存在Bug，所以不保证更新后系统的稳定性。
|
|
|
+5. 使用前请保证手机均已正确配置，并使用adb devices命令可以看到相关设备，如无可用设备，系统也没啥意义。
|
|
|
+6. 手机硬件相关的问题处理，请自行Google。
|
|
|
|
|
|
## 项目目录说明
|
|
|
|
LiHaoyu