应该进行哪些测试以准备为 Bazel 做出贡献？

Question

我正在准备对 bazel java 代码进行小错误修复。我正在开发一个 Linux 发行版。

按照https://bazel.build/contributing.html 中的说明进行操作，但我遇到了两个测试说明的问题：

1. 在关于“编译 bazel”的部分中，第三段状态：“除了 Bazel 二进制文件之外，您可能还想构建 Bazel 使用的各种工具。它们位于 //src/java_tools/...,/ /src/objc_tools/... 和 //src/tools/... 及其目录包含描述其各自实用程序的 README 文件。”如果我按照这个 //src/tools/... 失败，因为我正在使用的 Linux 环境中没有 xcrun 命令。我想这是 MacOS 平台特定的测试？
2. 下一段将指导您构建分发包，然后将其解压缩到新目录中，然后执行：“bazel test //src/... //third_party/ijar/...”。我现在收到一个错误，即缺少 windows.h，我想这是 Windows 平台特定的测试。

一些问题：

• 那么有没有一种简单的方法可以只为当前平台运行测试？
• 说明是否足够好？
• 如果需要更新说明，通知管理该文档页面的人员的最佳方式是什么？

Answer 1

感谢您有兴趣为 Bazel 做出贡献！ bazel-dev 邮件列表是解决这些问题的更好途径。

您要运行的测试很大程度上取决于您所做的更改，但是当您提出拉取请求时，Bazel CI 将运行 Bazel 的所有测试以确保没有任何问题。

那么有没有一种简单的方法可以只为当前平台运行测试？

这取决于，这仍然是一项正在进行的工作，我们希望让 Bazel 更加了解平台和工具链，而无需指定额外的标志。

一般来说，您无需修改​​或担心 //src/*_tools 包，除非您直接更改它们。

说明是否足够好？

说明永远不会完美，我们一直在寻找使其更清晰、更简洁的方法。

如果需要更新说明，通知管理该文档页面的人员的最佳方式是什么？

请在 GitHub 存储库上file an issue 或通过电子邮件发送至 bazel-dev 邮件列表以进行进一步讨论。