星河云梯（StarRiver）是一款功能强大的自动化测试工具，能够帮助开发人员和测试人员高效地创建、管理和执行测试用例。以下是使用星河云梯的分步指南

安装星河云梯

根据你的操作系统选择合适的安装方法：

• npm/yarn：
  • Linux/macOS：

    npm install star-river

    或者

    yarn add star-river

• Docker：

  docker pull starriver/star-river

  启动容器：

  docker run --volume /path/to/star-river:/app starriver/star-river

• PyPI：

  pip install star-river

配置环境

在使用星河云梯之前,需要配置以下环境变量：

• 星河云梯地址：如果你在本地运行，可能需要配置星河云梯的服务地址。

  export STAR_RIVER_URL=http://localhost:300

• 项目根目录：告诉星河云梯你的项目根目录：

  export STAR_RIVER_PROJECT_ROOT=/path/to/your/project

• 浏览器驱动：配置浏览器驱动路径：

  export STAR_RIVER_BROWSER_DRIVER=/path/to/chromedriver

• 执行路径：

  export STAR_RIVER_EXEC_PATH=/path/to/tests

运行测试用例

使用星河云梯运行测试用例：

• 运行单个测试用例：

  star-river run /path/to/test-case.json --env KEY=VALUE

  • --env：用于设置环境变量。

• 运行多个测试用例：

  star-river run /path/to/test1.json --include-regex '/path/to/.*\.json'

  • --include-regex：匹配特定的文件名模式。

• 运行整个项目：

  star-river run --project /path/to/star-river-project

使用参数

星河云梯提供多种参数选项：

• --format：指定输出格式,如json或html。
• --filter：过滤测试用例,支持正则表达式匹配。
• --env：设置环境变量。
• --browser：指定运行测试的浏览器类型，

  star-river run --browser chrome

高级功能

利用星河云梯的高级功能：

• 并行执行：

  star-river run --parallel

• 自定义执行路径：

  star-river run --executor /path/to/executor

集成开发环境（IDE）

星河云梯支持在IntelliJ IDEA、VS Code等IDE中集成：

• IntelliJ IDEA：

  下载星河云梯插件，安装后在项目中添加配置,选择星河云梯作为测试工具。

• VS Code：

  通过Marketplace安装星河云梯 VS Code 扩展,配置项目路径和浏览器驱动。

• PyCharm：

  手动下载星河云梯的JAR文件,添加到项目依赖中。

故障排除

如果在使用过程中遇到问题,可以参考星河云梯的官方文档或社区求助。

社区支持

访问星河云梯的GitHub仓库，找到示例项目和详细文档，加入社区或开发者论坛,获取更多帮助。

通过以上步骤，你可以轻松开始使用星河云梯,提升自动化测试效率。