为 Bazel 项目和生态系统提供帮助的方式有很多。
提供反馈
在使用 Bazel 的过程中,您可能会发现一些有待改进的地方。 在以下情况下,您可以通过报告问题来帮助解决这个问题:
- Bazel 崩溃或您遇到只能通过
bazel clean
解决的 bug。 - 文件不完整或不清楚。您还可以使用页面右上角的“创建问题”链接,从您正在查看的页面中报告问题。
- 错误消息可以改进。
加入社区
您可以通过以下方式与 Bazel 社区互动:
- 回答 Stack Overflow 上的问题。
- 在 Slack 上帮助其他用户。
- 改进文档或贡献示例。
- 例如在博客或社交媒体上分享您的体验或建议。
贡献代码
Bazel 是一个大型项目,因此对 Bazel 源代码进行更改可能会很困难。
您可以通过以下方式为 Bazel 生态系统做贡献:
- 通过贡献拉取请求来帮助规则维护者。
- 创建新规则并开放其源代码。
- 为与 Bazel 相关的工具(例如迁移工具)贡献代码。
- 改进 Bazel 与其他 IDE 和工具的集成。
在进行更改之前,请先创建 GitHub 问题或发送电子邮件至 bazel-dev@。
最有用的贡献可以修复 bug 或添加功能(而不是样式、重构或“清理”更改)。您的更改应包含测试和文档,并注意向后兼容性、可移植性以及对内存使用和性能的影响。
如需了解如何提交更改,请参阅补丁接受流程。
Bazel 的代码说明
Bazel 有一个大型代码库,其中的代码位于多个位置。如需了解详情,请参阅代码库指南。
Bazel 的结构如下:
- 客户端代码位于
src/main/cpp
中,并提供命令行界面。 - 协议缓冲区位于
src/main/protobuf
中。 - 服务器代码位于
src/main/java
和src/test/java
中。 - Java 原生接口位于
src/main/native
中。 - 编译 Bazel 部分中的列表介绍了支持语言的各种工具。
搜索 Bazel 的源代码
如需快速搜索 Bazel 的源代码,请使用 Bazel 代码搜索。您可以浏览 Bazel 的代码库、分支和文件。您还可以查看历史记录、差异和问题信息。如需了解详情,请参阅 Bazel 代码搜索用户指南。