Apache OFBiz® Selenium-WebDriver

### Apache OFBiz® Selenium-WebDriver 项目总结 #### 1. 项目概述 - **目标**：通过该项目，可以编写和运行 Apache OFBiz 的用户界面测试、单元测试或业务用例测试。 - **语言选择**：选择 Java 作为开发语言，原因包括： - 提供自动完成和 Javadoc 支持。 - 使用完整的 IT 语言，便于非 IT 人员（如业务分析师）理解和使用。 #### 2. 安装与配置 - **环境要求**： - OFBiz 被测系统需运行，可以是本地或远程环境。 - OFbSwd 项目和 OFBiz 通常安装在同一台计算机上。 - **项目结构**： - `ofbiz-framework/`：Apache OFBiz 安装目录。 - `OfbSwd/`：包含所有必要的库和测试框架。 - **浏览器支持**：默认支持 Firefox 和 Chrome（Chromium）的最新版本，需预先安装。 #### 3. 测试运行 - **测试类型**： - 单元测试：独立运行，每个新功能需至少一个单元测试。 - 业务场景测试：使用 Selenium 测试用户界面。 - **运行环境**： - 默认使用 Grid 模型，需同时运行 4 个进程： 1. OFBiz 服务 2. Hub（`tools/hub.sh`） 3. Node（`tools/node.sh`，至少一个） 4. OfbSwd 测试运行（`./gradlew runSingleSelenium`） - **测试参数**：读取 `selenium.properties` 文件，包含以下关键参数： - `ofbizBaseUrl`：本地或远程 OFBiz 地址。 - `Browser`：浏览器类型。 - `Browser release`：浏览器版本。 #### 4. 数据管理 - **数据文件**： - 数据文件存储在 `test-data` 目录，使用 XML 格式（基于 `testcasedata.xsd`）。 - 每个测试场景需定义 `data-obj`，包含业务对象的字段和值。 - **数据使用**： - 测试方法应尽量使用 `data-obj` 参数，避免直接传递简单参数。 - 数据对象的字段需在 Javadoc 中详细说明或提供数据模板。 #### 5. 最佳实践 1. **测试独立性**：每个单元测试必须独立运行。 2. **测试覆盖率**： - 新功能需对应单元测试和场景测试。 - 用户界面元素（portlet、屏幕、菜单）需有 Selenium 单元测试。 3. **数据处理**： - 测试数据需从文件读取，避免硬编码。 - 数据对象字段需唯一，使用索引类型避免冲突。 4. **文档与注释**： - 测试方法需提供可读的 Javadoc，便于业务分析师理解。 - 数据对象字段需在 Javadoc 中详细说明或提供数据模板。 5. **测试执行**： - 单元测试和场景测试需多次在相同和动态环境中运行。 - 使用 `showInfoPanel()` 方法在测试开始时显示操作说明。 #### 6. 工具与支持 - **主类**：`SimpleTestSuite.java` 是所有测试套件的父类，提供运行上下文和内部方法。 - **辅助工具**： - `utils` 子目录：提供通用测试方法。 - `use` 子目录：提供可直接调用的测试方法，按组件组织，方法名称应与用户操作一致。 #### 7. 测试环境 - 提供多个测试环境供不同 OFBiz 版本使用： - https://ofbiz13-07-selenium.ofbizextra.org/example/control/main - https://ofbiz-selenium.ofbizextra.org/example/control/main - https://demo-trunk.ofbiz.apache.org/example/control/main #### 8. 总结 - 该项目提供了一个基于 Java 的 Selenium 测试框架，用于测试 Apache OFBiz 的用户界面和业务逻辑。 - 核心目标是通过标准化的测试流程和数据管理，确保测试的可靠性和可维护性。