1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
---
layout: documentation
---
# Installing Bazel
## System Requirements
Supported platforms:
* Ubuntu Linux
* Mac OS X
Java:
* Java JDK 8 or later
## Downloading Bazel
Clone the Bazel repo from GitHub:
```
$ cd $HOME
$ git clone https://github.com/google/bazel.git
```
## Building Bazel
### Building Bazel on Ubuntu
To build Bazel on Ubuntu:
#### 1. Install JDK 8:
**Ubuntu Trusty (14.04 LTS).** OpenJDK 8 is not available on Trusty. To
install Oracle JDK 8:
```
$ sudo add-apt-repository ppa:webupd8team/java
$ sudo apt-get update
$ sudo apt-get install oracle-java8-installer
```
**Ubuntu Utopic (14.10).** To install OpenJDK 8:
```
$ sudo apt-get install openjdk-8-jdk
```
#### 2. Set the `JAVA_HOME` environment variable.
First, check to see if it's already set:
```
$ echo $JAVA_HOME
```
If this prints the path to the JDK 8 root directory, proceed to the next
step. Otherwise, find the Java `bin` directory using `which javac` and use
`javac -version` to verify that you have the right JDK version. Then set
the `JAVA_HOME` environment variable to the `bin` directory parent.
For example, if the path is `/usr/lib/jvm/jdk1.8.0/bin/javac`, set the
`JAVA_HOME` variable to `/usr/lib/jvm/jdk1.8.0`:
```
$ export JAVA_HOME=/usr/lib/jvm/jdk1.8.0
```
You can also add this line to your `~/.bashrc` file.
#### 3. Install required packages:
```
$ sudo apt-get install pkg-config zip g++ zlib1g-dev
```
#### 4. Build Bazel:
```
$ cd bazel
$ ./compile.sh
```
### Building Bazel on OS X
Bazel on Mac OS X requires:
* The Xcode command line tools. Xcode can be downloaded from the
[Apple Developer Site](https://developer.apple.com/xcode/downloads/).
* MacPorts or Homebrew for installing required packages.
* An installation of JDK 8.
* For `objc_*` and `ios_*` rule support, you must have Xcode 6.1 or later with
iOS SDK 8.1 installed on your system.
To build Bazel on Mac OS X:
```
$ cd bazel
$ ./compile.sh
```
Then you can run Bazel:
```
$ ./output/bazel help
```
## Running Bazel
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:
```bash
$ export PATH="$PATH:$HOME/bazel/output"
```
You can also add this command to your `~/.bashrc` file.
### Getting bash completion
Bazel comes with a bash completion script. To install it:
1. Build it with Bazel: `bazel build //scripts:bazel-complete.bash`.
2. Copy the script `bazel-bin/scripts/bazel-complete.bash` to your
completion folder (`/etc/bash_completion.d` directory under Ubuntu).
If you don't have a completion folder, you can copy it wherever suits
you and simply insert `source /path/to/bazel-complete.bash` in your
`~/.bashrc` file (under OS X, put it in your `~/.bash_profile` file).
### Getting zsh completion
Bazel also comes with a zsh completion script. To install it:
1. Add this script to a directory on your $fpath:
```
fpath[1,0]=~/.zsh/completion/
mkdir -p ~/.zsh/completion/
cp scripts/zsh_completion/_bazel ~/.zsh/completion
```
2. Optionally, add the following to your .zshrc.
```
# This way the completion script does not have to parse Bazel's options
# repeatedly. The directory in cache-path must be created manually.
zstyle ':completion:*' use-cache on
zstyle ':completion:*' cache-path ~/.zsh/cache
```
For more information, see [Getting started](getting-started.html).
|
