aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/install.md
diff options
context:
space:
mode:
authorGravatar Googler <noreply@google.com>2015-08-31 16:54:16 +0000
committerGravatar Kristina Chodorow <kchodorow@google.com>2015-08-31 19:21:43 +0000
commit2215a06bac6b5e0727e67c0e4f7d4a398f0cef67 (patch)
tree95696a264c00e4406ffc5bfd3910e5fd2b7f5ebb /site/docs/install.md
parentc7c25d9bc86cc5565b4f5a32a08a0ff22a6aa95d (diff)
Update installation instructions to support binary installer:
- Updates install.md to include information on downloading and running the installer - Updates getting-started.md to refer users to the installation instructions -- MOS_MIGRATED_REVID=101943813
Diffstat (limited to 'site/docs/install.md')
-rw-r--r--site/docs/install.md98
1 files changed, 28 insertions, 70 deletions
diff --git a/site/docs/install.md b/site/docs/install.md
index 35b55f9078..4d4a174e64 100644
--- a/site/docs/install.md
+++ b/site/docs/install.md
@@ -8,79 +8,39 @@ layout: documentation
Supported platforms:
-* Ubuntu Linux
+* Ubuntu Linux (Utopic 14.10 and Trusty 14.04 LTS)
* Mac OS X
Java:
* Java JDK 7 or later
-## Downloading Bazel
+## Install dependencies
-Clone the Bazel repo from GitHub:
+### Ubuntu
-```
-$ cd $HOME
-$ git clone https://github.com/google/bazel.git
-```
-
-## Building Bazel
-
-### Building Bazel on Ubuntu
-
-To build Bazel on Ubuntu:
-
-#### 1. Install JDK 7:
-
-**Ubuntu Utopic (14.10) and Trusty (14.04 LTS).** To install OpenJDK 7:
+#### 1. Install OpenJDK 7
```
$ sudo apt-get install openjdk-7-jdk openjdk-7-source
```
-#### 2. Install required packages:
-
-```
-$ sudo apt-get install pkg-config zip g++ zlib1g-dev
-```
-
-#### 3. Build Bazel:
-
-```
-$ cd bazel
-$ ./compile.sh
-```
-
-If this fails to find a correct Java version, then try to
-set the `JAVA_HOME` environment variable.
-
-Find the Java `bin` directory using `readlink -f $(which javac)`
-and use `javac -version` to verify that you have the right JDK version (1.7+).
-Then set the `JAVA_HOME` environment variable to the `bin` directory
-parent.
-
-For example, if the path is `/usr/lib/jvm/jdk1.7.0/bin/javac`, set the
-`JAVA_HOME` variable to `/usr/lib/jvm/jdk1.7.0`:
+#### 2. Install required packages
```
-$ export JAVA_HOME=/usr/lib/jvm/jdk1.7.0
+$ sudo apt-get install pkg-config zip g++ zlib1g-dev unzip
```
-You can also add this line to your `~/.bashrc` file.
-
-
-### Building Bazel on OS X
-
-To build Bazel on Mac OS X:
+### Mac OS X
#### 1. Install JDK 7
-JDK7 can be downloaded from
+JDK 7 can be downloaded from
[Oracle's JDK Page](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html).
Look for "Mac OS X x64" under "Java SE Development Kit". This will download a
DMG image with an install wizard.
-#### 2. Install XCode Command Line Tools
+#### 2. Install XCode command line tools
Xcode can be downloaded from the
[Apple Developer Site](https://developer.apple.com/xcode/downloads/), which will
@@ -89,41 +49,39 @@ redirect to the App Store.
For `objc_*` and `ios_*` rule support, you must have Xcode 6.1 or later with
iOS SDK 8.1 installed on your system.
-Once XCode is installed you can trigger the license signature with the following command:
+Once XCode is installed you can trigger the license signature with the following
+command:
```
$ sudo gcc --version
```
-#### 3. Install MacPorts or Homebrew for installing required packages.
+## Download Bazel
-While not required to compile Bazel, a package manager like MacPorts or Homebrew
-is recommended to help install other dependencies like protobuffer support.
+Download the [Bazel installer](https://github.com/google/bazel/releases) for
+your operating system.
-Homebrew can be installed via a 1-line script from [brew.sh](http://brew.sh/).
+## Run the installer
-Macports is available from [macports.org](https://www.macports.org/install.php).
+Run the installer:
-#### 4. Build Bazel
+<pre>
+$ chmod +x install-<em>version</em>-<em>os</em>.sh
+$ ./install-<em>version</em>-<em>os</em>.sh --user
+</pre>
-```
-$ cd bazel
-$ ./compile.sh
-```
-
-Then you can run Bazel:
-
-```
-$ ./output/bazel help
-```
+The `--user` flag installs Bazel to the `$HOME/bin` directory on your
+system and sets the `.bazelrc` path to `$HOME/.bazelrc`. Use the `--help`
+command to see additional installation options.
-## Running Bazel
+## Set up your environment
-The Bazel executable is located at `output/bazel` in the Bazel home directory.
-It's a good idea to add this path to your default paths, as follows:
+If you ran the Bazel installer with the `--user` flag as above, the Bazel
+executable is installed in your `$HOME/bin` directory. It's a good idea to add
+this directory to your default paths, as follows:
```bash
-$ export PATH="$PATH:$HOME/bazel/output"
+$ export PATH="$PATH:$HOME/bin"
```
You can also add this command to your `~/.bashrc` file.