<think>我们正在回答用户关于在Jenkins中执行包含Poco的Airtest脚本所需的安装配置问题。结合之前的对话历史和提供的引用，我们需要整理出所需的软件、版本号及安装步骤。 根据引用[1]和[2]中的信息，在Jenkins中执行Airtest（包含Poco）脚本需要以下组件： 1. 安装必要的Python包：airtest, pocoui 2. 配置Jenkins环境：可能需要安装Python插件、设置虚拟显示器（Xvfb）等 3. 执行测试并生成报告，然后归档报告 另外，从之前的对话中我们知道，用户之前询问过pocoui的1.0.90版本不存在，因此我们需要注意推荐稳定的版本。 步骤： 1. 安装Python环境（Jenkins服务器上需要安装Python，建议Python3.6+） 2. 安装必要的依赖库：airtest, pocoui，并注意版本选择 3. 配置虚拟显示器（因为Airtest需要图形界面，而Jenkins通常是无界面的） 4. 编写Jenkins任务执行脚本 关于版本： 根据之前的回答，pocoui的1.0.90版本不存在，我们可以推荐使用1.0.89（稳定）或1.0.92之后的版本（如1.0.94）。同时，airtest的版本我们可以选择最新的稳定版。 当前（截至2023年10月）的稳定版本： - airtest: 1.2.3（最新版本，但注意引用[4]中项目地址为Airtest的镜像） - pocoui: 1.0.94（最新版本）或1.0.89（如果1.0.94有问题可以回退） 安装过程： 1. 在Jenkins服务器上安装Python3和pip。 2. 创建虚拟环境（可选，但推荐）。 3. 安装airtest和pocoui。 注意：由于Airtest需要图形环境，在无界面的Linux服务器上需要安装Xvfb。 详细步骤： 步骤1：安装Python环境 在Jenkins服务器上安装Python3和pip，例如在Ubuntu上： ```bash sudo apt update sudo apt install python3 python3-pip ``` 步骤2：安装Xvfb（虚拟显示器） ```bash sudo apt install xvfb ``` 步骤3：在Jenkins中安装必要的插件 - Jenkins管理 -> 插件管理 -> 安装插件： - Xvfb plugin（用于管理Xvfb） - Email Extension Plugin（邮件通知，可选） 步骤4：配置Jenkins任务的构建环境 在Jenkins任务的配置中： - 勾选"Xvfb"并设置（通常默认即可） - 其他根据需要配置 步骤5：编写构建脚本 在构建步骤中，选择执行shell，并编写类似如下的脚本： ```bash # 创建并激活虚拟环境（可选） python3 -m venv venv source venv/bin/activate # 安装依赖 pip install airtest==1.2.3 pocoui==1.0.94 # 执行测试并生成报告 airtest run test_case.air --device Android:/// --log logs/ airtest report test_case.air --log_root logs/ --outfile report.html # 归档报告（在Jenkins中配置归档文件） ``` 步骤6：配置归档报告 在Jenkins任务的“后处理”中，添加归档文件：report.html 注意：如果测试脚本需要连接Android设备，确保Jenkins服务器上已经配置了ADB并连接了设备，或者使用远程ADB。 关于版本号，我们推荐使用最新的稳定版本，但要注意兼容性。如果遇到问题，可以尝试降级到已知稳定的版本组合。 引用[1]中提到了安装命令和报告生成命令，引用[2]提到了Xvfb和邮件通知，引用[3]提到了一些框架，引用[4]是Airtest的项目地址，供用户参考。 因此，我们可以这样总结： 所需安装的软件及版本号： - Python: 3.6+ - airtest: 1.2.3（最新版）或根据实际需要选择 - pocoui: 1.0.94（最新版）或1.0.89（稳定版） - Xvfb: 用于虚拟显示 安装过程： 1. 在服务器上安装Python3和pip。 2. 安装Xvfb。 3. 在Jenkins中安装Xvfb插件。 4. 在Jenkins任务的构建脚本中创建虚拟环境（可选），安装指定版本的airtest和pocoui，并执行测试。 注意：如果使用Android设备，还需要安装Android SDK并配置ADB。 我们按照用户要求，使用中文回答，并生成相关问题。 </think> ### 在 Jenkins 中执行包含 Poco 的 Airtest 脚本所需环境配置 #### **一、核心组件安装清单** | 组件 | 推荐版本 | 安装命令 | 作用 | |------|----------|----------|------| | **Airtest** | `1.2.13` | `pip install airtest==1.2.13` | UI自动化测试框架[^4] | | **Poco** | `1.0.94` | `pip install pocoui==1.0.94` | 游戏/App控件定位库[^1] | | **ADB Tools** | `34.0.5` | `sudo apt install adb` | Android设备连接 | | **Xvfb** | `1.20.13` | `sudo apt install xvfb` | 虚拟显示服务器[^2] | | **Jenkins插件** | - | 管理后台安装 | 功能扩展支持 | | - Python Plugin | 最新版 | - | 执行Python脚本 | | - Xvfb Plugin | 最新版 | - | 虚拟显示支持 | | - Email Extension | 最新版 | - | 邮件通知[^2] | #### **二、详细安装流程** 1. **基础环境配置**（Jenkins服务器） ```bash # 安装系统依赖 sudo apt update sudo apt install -y python3-pip adb xvfb # 创建虚拟环境（推荐） python3 -m venv airtest_env source airtest_env/bin/activate ``` 2. **安装Python依赖** ```bash pip install airtest==1.2.13 pocoui==1.0.94 pytest allure-pytest ``` 3. **Jenkins插件安装** - 进入 `Jenkins > Manage Jenkins > Plugins` - 搜索安装： - `Python Plugin` - `Xvfb Plugin` - `Email Extension Plugin` 4. **配置虚拟显示器** - 在Jenkins任务配置中： - 勾选 `Start Xvfb before the build` - 设置参数：`Screen: 0 | Resolution: 1920x1080x24` 5. **Jenkins任务脚本示例** ```bash #!/bin/bash source airtest_env/bin/activate # 执行测试并生成报告 airtest run test_case.air --device Android:/// --log logs/ airtest report test_case.air --log_root logs/ --outfile report.html # 生成Allure报告（若集成pytest） pytest --alluredir=./allure-results ``` #### **三、版本选择建议** 1. **Poco版本兼容性** - 推荐 `1.0.94`（最新稳定版） - 避免 `1.0.90-1.0.91`（PyPI无此版本） - 降级方案：`pip install pocoui==1.0.89` 2. **Airtest版本策略** - 最低要求：`1.2.0+` - 验证命令：`airtest version` #### **四、常见问题解决** - **图像识别不稳定**： - 增加 `sleep()` 等待时间 - 调整截图 `resolution` 参数[^2] - **设备连接失败**： ```bash adb kill-server && adb start-server # 重启ADB服务 ``` - **虚拟显示异常**： - 检查Xvfb日志：`/var/log/Xorg.*.log` > 关键提示：所有组件版本需保持兼容，建议固定版本号避免依赖冲突[^3]