diff options
author | David Chen <dzc@google.com> | 2016-08-29 08:56:37 +0000 |
---|---|---|
committer | Klaus Aehlig <aehlig@google.com> | 2016-08-29 09:42:52 +0000 |
commit | 15c09dd1b5dbd7e76fe42d193a79dab8bfc24abc (patch) | |
tree | e6df9943f0f96c095a6f91240a8f4bc3a84708d9 /site/docs/windows.md | |
parent | 6f2e6fb1eff1a7a265778abf1eb32a850765599e (diff) |
Replace doc pages with redirects to versioned doc pages.
* Add a new `redirect` Jekyll layout.
* Replace all pages under docs/ with redirects to corresponding page under
versions/master/.
* Prepend links on Documentation sidebar, including generated navs for the
Skylark Library and Build Encyclopedia, with prefix for versioned directory.
* Add code to both the internal jekyll-config.sh and external jekyll-tree.sh
to add redirect pages for the Skylark Library and Build Encyclopedia.
* Bring the branched User Manual doc up to date with latest changes.
--
MOS_MIGRATED_REVID=131568800
Diffstat (limited to 'site/docs/windows.md')
-rw-r--r-- | site/docs/windows.md | 83 |
1 files changed, 2 insertions, 81 deletions
diff --git a/site/docs/windows.md b/site/docs/windows.md index a63761179c..8bf61e0e3b 100644 --- a/site/docs/windows.md +++ b/site/docs/windows.md @@ -1,83 +1,4 @@ --- -layout: documentation -title: Windows +layout: redirect +redirect: docs/windows.html --- - -Building Bazel on Windows -========================= - -Windows support is highly experimental. 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. - -We currently support only 64 bit Windows 7 or higher and we compile Bazel as a msys2 binary. - -To bootstrap Bazel on Windows, you will need: - -* Java JDK 8 or later -* [Visual Studio](https://www.visualstudio.com/) (Community Edition is okay) -* [msys2](https://msys2.github.io/) (need to be installed at - ``C:\tools\msys64\``). -* Several msys2 packages. Use the ``pacman`` command to install them: - ``pacman -S gcc git curl zip unzip zlib-devel`` - -To build Bazel: - -* Open the msys2 shell. -* Clone the Bazel git repository as normal. -* Set the environment variables: - -```bash -export JAVA_HOME="$(ls -d C:/Program\ Files/Java/jdk* | sort | tail -n 1)" -export BAZEL_SH=c:/tools/msys64/usr/bin/bash.exe -``` - -* Run ``compile.sh`` in Bazel directory. -* If all works fine, bazel will be built at ``output\bazel.exe``. - -Using Bazel on Windows -====================== - -Bazel currently supports building C++ targets and Java targets on Windows. - -### Build C++ - -To build C++ targets, you will need: - -* [Visual Studio](https://www.visualstudio.com/) -<br/>We are using MSVC as the native C++ toolchain, so please ensure you have Visual -Studio installed with the Visual C++ components -(which is NOT the default installation type of Visual Studio). - -* [Python 2.7](https://www.python.org/downloads/) -<br/>Currently, we use python wrapper scripts to call the actual MSVC compiler, so -please make sure Python is installed and its location is added into PATH. -It's also a good idea to set BAZEL\_PYTHON environment variable to tell Bazel -where python is. -<br/>For example: `export BAZEL_PYTHON=C:/Python27/python.exe` - -Bazel will auto-configure the location of Visual Studio and Python at the first -time you build any target. -If you need to auto-configure again, just run `bazel clean` then build a target. - -If everything is set up, you can build C++ target now! However, since MSVC -toolchain is not default on Windows yet, you should use flag -`--cpu=x64_windows_msvc` to enable it like this: - -```bash -$ bazel build --cpu=x64_windows_msvc examples/cpp:hello-world -$ ./bazel-bin/examples/cpp/hello-world.exe -$ bazel run --cpu=x64_windows_msvc examples/cpp:hello-world -``` - -### Build Java - -Building Java targets works well on Windows, no special configuration is needed. -Just try: - -```bash -$ bazel build examples/java-native/src/main/java/com/example/myproject:hello-world -$ ./bazel-bin/examples/java-native/src/main/java/com/example/myproject/hello-world -$ bazel run examples/java-native/src/main/java/com/example/myproject:hello-world -``` - |