aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/install-compile-source.md
diff options
context:
space:
mode:
authorGravatar steren <steren@google.com>2017-06-30 15:49:47 +0200
committerGravatar Marcel Hlopko <hlopko@google.com>2017-07-03 09:05:12 +0200
commit30c35a2a447a9fc5e93a6a5849d9c8a480d99464 (patch)
tree0df07bb83594e8f1a92d0d1af4a9edaf770a3cea /site/docs/install-compile-source.md
parent3e2cee83eddb340d9a0d96cc545ccbda76b489ac (diff)
Reorganize Windows install instructions
* move Compile requirement and instructions to the "compile from source" page * remove warning for old versions of Bazel RELNOTES: None PiperOrigin-RevId: 160641070
Diffstat (limited to 'site/docs/install-compile-source.md')
-rw-r--r--site/docs/install-compile-source.md45
1 files changed, 16 insertions, 29 deletions
diff --git a/site/docs/install-compile-source.md b/site/docs/install-compile-source.md
index 453d5658df..327d18ca44 100644
--- a/site/docs/install-compile-source.md
+++ b/site/docs/install-compile-source.md
@@ -5,6 +5,8 @@ title: Compile Bazel from Source
# <a name="compiling-from-source"></a>Compile Bazel from source
+## <a name="unix"></a> On Linux or macOS
+
1. Ensure that you have OpenJDK 8 installed on your system.
For a system based on debian packages (e.g. Debian, Ubuntu), install
OpenJDK 8 by running the command `sudo apt-get install openjdk-8-jdk`.
@@ -22,37 +24,22 @@ title: Compile Bazel from Source
binary in `output/bazel`. This binary is self-contained, so it can be copied
to a directory on the PATH (such as `/usr/local/bin`) or used in-place.
-## <a name="compiling-from-source-issues"></a>Known issues when compiling from source
-
-### On Windows:
-
-* version 0.4.4 and below: `compile.sh` may fail right after start with an error
- like this:
-
- ```
- File not found - *.jar
- no error prone jar
- ```
-
- Workaround is to run this (and add it to your `~/.bashrc`):
+## <a name="windows"></a> On Windows
- ```
- export PATH="/bin:/usr/bin:$PATH"
- ```
+Windows support is in beta. Known issues are [marked with label
+"Windows"](https://github.com/bazelbuild/bazel/issues?q=is%3Aissue+is%3Aopen+label%3A%22category%3A+multi-platform+%3E+windows%22)
+on github issues.
-* version 0.4.3 and below: `compile.sh` may fail fairly early with many Java
- compilation errors. The errors look similar to:
+Prerequisites:
- ```
- C:\...\bazel_VR1HFY7x\src\com\google\devtools\build\lib\remote\ExecuteServiceGrpc.java:11: error: package io.grpc.stub does not exist
- import static io.grpc.stub.ServerCalls.asyncUnaryCall;
- ^
- ```
+* Follow the [Windows requirements](windows.md#requirements).
+* Install [Visual C++ Build Tools](http://landinghub.visualstudio.com/visual-cpp-build-tools)
+ or the full [Visual C++](https://www.visualstudio.com/) (as part of Visual
+ Studio; Community Edition is fine) with Windows SDK installed.
- This is caused by a bug in one of the bootstrap scripts
- (`scripts/bootstrap/compile.sh`). Manually apply this one-line fix if you
- want to build Bazel purely from source (without using an existing Bazel
- binary): [5402993a5e9065984a42eca2132ec56ca3aa456f]( https://github.com/bazelbuild/bazel/commit/5402993a5e9065984a42eca2132ec56ca3aa456f).
+To build Bazel on Windows:
-* version 0.3.2 and below:
- [github issue #1919](https://github.com/bazelbuild/bazel/issues/1919)
+* Open the msys2 shell.
+* Clone the [Bazel git repository](https://github.com/bazelbuild/bazel) as normal.
+* Run ``compile.sh`` in Bazel directory.
+* If all works fine, Bazel will be built at ``output\bazel.exe``.