新的介绍内容：

Ruby Test Explorer：VS Code中高效的Ruby测试工具

Ruby Test Explorer是专为VS Code设计的测试扩展，旨在提升您的Ruby测试效率。它支持RSpec和Minitest测试框架，提供一系列强大的功能，使您的测试流程更加流畅和高效。

安装方式：

您可以通过VS Code Marketplace轻松安装Ruby Test Explorer扩展，立即开始优化您的测试流程。

设置指南：

RSpec

要使用RSpec测试框架，您需要安装Ruby和rspec-core gem，并确保您的测试套件所需的所有依赖项已安装。该扩展已在Ruby 2.6和Rspec 3.8上进行了测试，但它应该适用于大多数最新版本的Ruby和所有3.6.0以上的Rspec 3.x版本（3.6.0之前的版本目前不支持，因为它们在JSON格式化器中没有暴露测试的id属性）。

默认情况下，您需要通过Bundler使用Gemfile安装rspec，并运行bundle install，否则bundle exec rspec将无法工作。如果您希望使用除bundle exec rspec之外的其他命令运行Rspec测试，可以通过rubyTestExplorer.rspecCommand设置来配置命令。

Minitest

要使用Minitest测试框架，您需要安装Ruby和minitest gem，并确保您的测试套件所需的所有依赖项已安装。该扩展已在Ruby 2.5和2.6以及Minitest 5.x上进行了测试。它应该适用于大多数最新版本的Ruby和Minitest。

功能亮点：

• 支持RSpec和Minitest测试套件。
• 自动检测测试框架（基于bundle list列出的gem），也支持手动覆盖。
• 运行单个测试、完整测试套件或特定文件的测试。
• 查看失败测试的输出（在测试资源管理器侧边栏中点击测试以打开输出视图）。
• 在测试文件中显示失败测试的行装饰。
• 显示测试状态，包括成功、失败和待定（在扩展中称为“跳过”）。
• 测试套件运行时的实时测试状态更新。
• 每个测试的文件位置信息。
• 可配置的RSpec命令和spec/目录。
• 可配置的Minitest命令和test/目录。
• 测试层次结构信息。
• 当测试目录中的文件发生变化时，自动重新加载测试套件信息。
• 支持多根工作区。

配置选项：

Ruby Test Explorer提供了多种配置选项，允许您根据需求定制测试环境：

故障排除：

如果扩展无法正常工作，您可以尝试以下几种方法：

• 确保已运行bundle install，并且Gemfile.lock中指定的所有gem都已安装（假设您使用的是Bundler）。
• 如果您使用的是minitest，请禁用并行测试。可以通过在test_helper.rb中设置parallelize(workers: 1)，或在rubyTestExplorer.minitestCommand中添加PARALLEL_WORKERS=1来实现。
• 启用rubyTestExplorer.logpanel配置设置，并查看输出中的Ruby Test Explorer Log。这应该能显示扩展正在做什么，并提供更多关于幕后发生的事情的上下文。（您也可以使用rubyTestExplorer.logfile将日志记录到特定文件中）。
• 检查VS Code开发者工具（命令面板 > '开发人员：切换开发者工具'）是否有JSON解析错误，或者任何看起来可能来自扩展的内容。这可能是扩展中的错误，或者是您的设置问题。
• 如果您使用的是RSpec，请确保使用的是最新版本的rspec-core gem。如果您使用的是3.6.0之前的版本，扩展可能无法工作。
• 如果您使用的是RSpec，请确保RSpec命令和spec目录配置正确。默认情况下，测试使用bundle exec rspec运行，测试假定在./spec/目录中。您可以通过rubyTestExplorer.rspecCommand和rubyTestExplorer.rspecDirectory分别配置这些。
• 如果测试套件信息无法加载，您的testFramework配置可能设置为none，或者自动检测可能无法确定测试框架。尝试将testFramework配置设置为rspec或minitest，具体取决于您想要使用的框架。

如果所有方法都失败或您怀疑扩展有问题，请随时打开一个issue！:)

贡献指南：

您需要安装VS Code、Node（任何版本>=12应该都可以工作）和Ruby。

• 克隆仓库：git clone https://github.com/connorshea/vscode-ruby-test-adapter
• 运行bin/setup安装依赖项。
• 在VS Code中打开目录。
• 运行npm run watch或在VS Code中启动watch任务，以启动TypeScript编译器。
• 转到侧边栏的调试部分，运行“Ruby adapter”。这将启动一个单独的VS Code实例，用于测试扩展。每次在命令面板中运行“Reload Window”时，都会更新代码。
  • 如果您想实际使用扩展来运行测试，您需要一个Ruby项目，我通常使用我的项目vglist进行测试，但任何带有RSpec或Minitest测试的Ruby项目都可以。

该扩展基于示例测试适配器，检查该仓库可能对您有帮助。其他语言的测试适配器也可能是有用的参考。

运行测试

仓库中包含了两组测试：

• 用于收集测试信息和运行测试的Ruby脚本测试。使用ruby目录中的bundle exec rake运行。
• 调用Ruby脚本的VS Code扩展测试。从VS Code的调试面板使用“Run tests for”配置运行。
  • 每个支持的测试框架都有单独的调试配置。
  • 请注意，您需要在更改扩展代码或测试之前运行npm run build && npm run package，否则无法成功运行扩展测试。

您可以在.github/workflows/test.yml中查看CI配置。

发布新版本

请参阅VS Code扩展文档以获取更多信息。

在发布之前，请确保更新CHANGELOG.md文件。您还需要登录到vsce。在创建个人访问令牌以登录时，请确保为您的Azure DevOps账户中的所有组织授予访问权限。否则，它将无法正确工作。

vsce publish VERSION，例如vsce publish 1.0.0将自动处理创建git提交和git标签，更新package.json，并将新版本发布到Visual Studio Marketplace。发布后，您需要手动运行git push和git push --tags。

或者，您可以使用vsce publish major、vsce publish minor或vsce publish patch来提升扩展版本。