JetBrains TeamCity 集成

JetBrains TeamCity 是一个可以构建、测试和发布软件的持续集成服务器。 Squish Runner 插件提供了无缝的 Squish 与 TeamCity 集成。它允许向 构建配置 中添加一个或多个 Squish Runner 构建步骤，并在指定的本地或远程代理上执行 Squish 图形界面测试。执行完成后，如果所有测试都通过，则构建将被设置为 成功。否则，构建将设置为 失败。此外，测试的工件将存储起来，以便高效地处理缺陷。

Squish Runner 插件安装

插件可以从以下位置获取：https://resources.qt.io/hubfs/Squish/squish-teamcity-latest.zip。

要安装 Squish Runner 插件，请关闭 TeamCity 服务器，并将带有插件的 zip 存档复制到 TeamCity 数据目录/plugins 目录。最后，启动 TeamCity 服务器以自动解压并处理插件文件。

要检查 TeamCity 数据目录 的位置，请转到 管理员 > 全局设置。

要验证插件是否已安装，请转到 管理员 并选择 插件列表。Squish Runner 插件应列在 外部插件 列表中。

构建步骤定义

要指定构建 配置步骤，请选择 构建步骤 选项，并点击 添加构建步骤 按钮。从 运行类型 下拉菜单中选择 Squish Runner。您可以为单个构建配置添加多个 Squish Runner 构建步骤。

构建步骤配置

接下来，配置插件执行的构建步骤。在 Squish 安装 部分，安装根目录 字段，指定 Squish 目录的路径。用户可以手动输入路径或使用先前在 构建参数 中指定的值。

在 测试 部分，指定 Squish 执行的测试用例。必填设置是 测试套件，其中必须指定具有完整路径的测试套件名称。如果您只指定 测试套件 并将 测试用例 字段留空，则将执行给定测试套件中的所有测试用例。要从测试套件中仅执行指定的测试用例，请在 测试用例 字段中指定它们。接受单个或多个值（用逗号分隔）。

在 设置 部分，您可以指定执行图形界面自动化测试的附加参数

• 在 主机 字段中，指定 squishserver 运行的主机。如果您省略此值，则使用默认值 localhost。
• 在 端口号 字段中，指定 squishserver 监听的端口号。如果您省略此值，则使用默认端口号 4322。
• 环境变量 字段可以包含 squishrunner 和 squishserver 的环境变量。您可以使用空格分隔多个环境变量。
• 选中 启动/停止 squishserver 复选框将在代理运行的主机上启动 squishserver，监听构建步骤中配置的端口。完成测试执行后，将停止 squishserver。在 Windows 平台上运行的代理不支持启动和停止 squishserver。

构建执行

Squish Runner 测试作为完整构建的一部分执行。如果由于 FAIL 或 ERROR 导致任何测试用例失败，则构建将标记为失败。在构建日志中，用户可以检查哪个 Squish Runner 步骤导致整个构建失败。所有报告都存储在工件选项卡中，包括结果 XML 文件、HTML 报告以及 Squish 在失败或错误情况下捕获的截图。