steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 1 | # [Bazel](https://bazel.build) |
Han-Wen Nienhuys | d08b27f | 2015-02-25 16:45:20 +0100 | [diff] [blame] | 2 | |
| 3 | *{Fast, Correct} - Choose two* |
| 4 | |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 5 | Build and test software of any size, quickly and reliably. |
Han-Wen Nienhuys | d08b27f | 2015-02-25 16:45:20 +0100 | [diff] [blame] | 6 | |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 7 | * **Speed up your builds and tests**: |
Googler | 7dd9ab5 | 2019-09-25 10:36:25 -0700 | [diff] [blame] | 8 | Bazel rebuilds only what is necessary. |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 9 | With advanced local and distributed caching, optimized dependency analysis and |
| 10 | parallel execution, you get fast and incremental builds. |
Han-Wen Nienhuys | d08b27f | 2015-02-25 16:45:20 +0100 | [diff] [blame] | 11 | |
Josh Goldberg | bbdda5f | 2017-11-29 00:20:52 -0800 | [diff] [blame] | 12 | * **One tool, multiple languages**: Build and test Java, C++, Android, iOS, Go, |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 13 | and a wide variety of other language platforms. Bazel runs on Windows, macOS, |
| 14 | and Linux. |
Googler | 5fba619 | 2015-03-17 22:12:05 +0000 | [diff] [blame] | 15 | |
Josh Goldberg | bbdda5f | 2017-11-29 00:20:52 -0800 | [diff] [blame] | 16 | * **Scalable**: Bazel helps you scale your organization, codebase, and |
| 17 | continuous integration solution. It handles codebases of any size, in multiple |
| 18 | repositories or a huge monorepo. |
Googler | 5fba619 | 2015-03-17 22:12:05 +0000 | [diff] [blame] | 19 | |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 20 | * **Extensible to your needs**: Easily add support for new languages and |
| 21 | platforms with Bazel's familiar extension language. Share and re-use language |
| 22 | rules written by the growing Bazel community. |
Googler | 5fba619 | 2015-03-17 22:12:05 +0000 | [diff] [blame] | 23 | |
Googler | e7bfc7e | 2015-03-18 22:03:53 +0000 | [diff] [blame] | 24 | ## Getting Started |
Han-Wen Nienhuys | d08b27f | 2015-02-25 16:45:20 +0100 | [diff] [blame] | 25 | |
fwe | f1e6c65 | 2022-04-13 11:26:36 -0700 | [diff] [blame] | 26 | * [Install Bazel](https://bazel.build/install) |
| 27 | * [Get started with Bazel](https://bazel.build/contribute/getting-started) |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 28 | * Follow our tutorials: |
Han-Wen Nienhuys | d08b27f | 2015-02-25 16:45:20 +0100 | [diff] [blame] | 29 | |
fwe | f1e6c65 | 2022-04-13 11:26:36 -0700 | [diff] [blame] | 30 | - [Build C++](https://bazel.build/tutorials/cpp) |
| 31 | - [Build Java](https://bazel.build/tutorials/java) |
| 32 | - [Android](https://bazel.build/tutorials/android-app) |
| 33 | - [iOS](https://bazel.build/tutorials/ios-app) |
Han-Wen Nienhuys | d08b27f | 2015-02-25 16:45:20 +0100 | [diff] [blame] | 34 | |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 35 | ## Documentation |
| 36 | |
fwe | f1e6c65 | 2022-04-13 11:26:36 -0700 | [diff] [blame] | 37 | * [Bazel command line](https://bazel.build/docs/user-manual) |
| 38 | * [Rule reference](https://bazel.build/reference/be/overview) |
| 39 | * [Use the query command](https://bazel.build/reference/query) |
| 40 | * [Extend Bazel](https://bazel.build/rules/concepts) |
| 41 | * [Write tests](https://bazel.build/reference/test-encyclopedia) |
| 42 | * [Roadmap](https://bazel.build/community/roadmaps) |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 43 | * [Who is using Bazel?](https://github.com/bazelbuild/bazel/wiki/Bazel-Users) |
| 44 | |
Philipp Wollermann | 67e4189 | 2021-08-27 08:56:11 -0700 | [diff] [blame] | 45 | ## Reporting a Vulnerability |
| 46 | |
| 47 | To report a security issue, please email security@bazel.build with a description |
| 48 | of the issue, the steps you took to create the issue, affected versions, and, if |
| 49 | known, mitigations for the issue. Our vulnerability management team will respond |
| 50 | within 3 working days of your email. If the issue is confirmed as a |
| 51 | vulnerability, we will open a Security Advisory. This project follows a 90 day |
| 52 | disclosure timeline. |
| 53 | |
steren | a9f7687 | 2017-07-07 22:12:52 +0200 | [diff] [blame] | 54 | ## Contributing to Bazel |
| 55 | |
| 56 | See [CONTRIBUTING.md](CONTRIBUTING.md) |
Damien Martin-Guillerez | 5e23954 | 2016-11-07 15:41:20 +0000 | [diff] [blame] | 57 | |
pcloudy | aded1b1 | 2022-04-22 05:03:16 -0700 | [diff] [blame] | 58 | [](https://buildkite.com/bazel/bazel-bazel) |