Google Git
Sign in
bazel / bazel / 09077a35da3def2474d90f1cc1bb14848dd6fd4f / . / README.md
blob: d789254d1e74778d704497d194e32a293734ceab [file] [log] [blame] [view]
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]1# [Bazel](https://bazel.build)
Han-Wen Nienhuysd08b27f2015-02-25 16:45:20 +0100[diff] [blame]2
3*{Fast, Correct} - Choose two*
4
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]5Build and test software of any size, quickly and reliably.
Han-Wen Nienhuysd08b27f2015-02-25 16:45:20 +0100[diff] [blame]6
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]7* **Speed up your builds and tests**:
8 Bazel only rebuilds what is necessary.
9 With advanced local and distributed caching, optimized dependency analysis and
10 parallel execution, you get fast and incremental builds.
Han-Wen Nienhuysd08b27f2015-02-25 16:45:20 +0100[diff] [blame]11
Josh Goldbergbbdda5f2017-11-29 00:20:52 -0800[diff] [blame]12* **One tool, multiple languages**: Build and test Java, C++, Android, iOS, Go,
sterena9f76872017-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.
Googler5fba6192015-03-17 22:12:05 +0000[diff] [blame]15
Josh Goldbergbbdda5f2017-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.
Googler5fba6192015-03-17 22:12:05 +0000[diff] [blame]19
sterena9f76872017-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.
Googler5fba6192015-03-17 22:12:05 +0000[diff] [blame]23
Googlere7bfc7e2015-03-18 22:03:53 +0000[diff] [blame]24## Getting Started
Han-Wen Nienhuysd08b27f2015-02-25 16:45:20 +0100[diff] [blame]25
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]26 * [Install Bazel](https://docs.bazel.build/install.html)
27 * [Get started with Bazel](https://docs.bazel.build/getting-started.html)
28 * Follow our tutorials:
Han-Wen Nienhuysd08b27f2015-02-25 16:45:20 +0100[diff] [blame]29
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]30 - [Build C++](https://docs.bazel.build/tutorial/cpp.html)
31 - [Build Java](https://docs.bazel.build/tutorial/java.html)
Umesh Yadave35047e2017-11-27 12:12:08 -0800[diff] [blame]32 - [Android](https://docs.bazel.build/tutorial/android-app.html)
33 - [iOS](https://docs.bazel.build/tutorial/ios-app.html)
Han-Wen Nienhuysd08b27f2015-02-25 16:45:20 +0100[diff] [blame]34
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]35## Documentation
36
dmartingcdb8a632017-09-04 11:43:35 +0200[diff] [blame]37 * [Bazel command line](https://docs.bazel.build/user-manual.html)
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]38 * [Rule reference](https://docs.bazel.build/be/overview.html)
39 * [Use the query command](https://docs.bazel.build/query.html)
dmaclach2ed32612017-11-21 07:53:33 -0800[diff] [blame]40 * [Extend Bazel](https://docs.bazel.build/skylark/concepts.html)
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]41 * [Write tests](https://docs.bazel.build/test-encyclopedia.html)
42 * [Roadmap](https://bazel.build/roadmap.html)
43 * [Who is using Bazel?](https://github.com/bazelbuild/bazel/wiki/Bazel-Users)
44
45## Contributing to Bazel
46
47See [CONTRIBUTING.md](CONTRIBUTING.md)
Damien Martin-Guillerez5e239542016-11-07 15:41:20 +0000[diff] [blame]48
Jingwenec7c2732018-01-11 14:31:57 -0800[diff] [blame]49[![Build Status](https://ci.bazel.build/buildStatus/icon?job=bazel-tests)](https://ci.bazel.build/job/bazel-tests)
sterena9f76872017-07-07 22:12:52 +0200[diff] [blame]50
51Bazel is released in 'Beta'.
52See the [product roadmap](https://bazel.build/roadmap.html) to learn about the
53path toward a stable 1.0 release.