为了为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软件包。

  

说明足够好吗？

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

  

如果应该更新说明，什么是通知管理该文档页面的最佳方法？

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