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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
<html devsite>
<head>
<title>Requirements</title>
<meta name="project_path" value="/_project.yaml" />
<meta name="book_path" value="/_book.yaml" />
</head>
<body>
<!--
Copyright 2017 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<p>
Before you download and build the Android source, ensure your system meets
the following requirements then see <a href="initializing.html">Establishing
a Build Environment</a> for installation instructions by operating system.
</p>
<h2 id=hardware-requirements>Hardware requirements</h2>
<p>
Your development workstation should meet or exceed these hardware
requirements:
</p>
<ul>
<li>A 64-bit environment is required for Android 2.3.x (Gingerbread) and
higher versions, including the master branch. You can compile older versions
on 32-bit systems.
</li>
<li>At least 100GB of free disk space to checkout the code and an extra 150GB
to build it. If you conduct multiple builds, you will need even more space.
</li>
<li>If you are running Linux in a virtual machine, you need at
least 16GB of RAM/swap.
</li>
</ul>
<h2 id=software-requirements>Software requirements</h2>
<p>
The <a href="https://android.googlesource.com/" class="external">Android Open
Source Project (AOSP)</a> <code>master</code> branch is traditionally
developed and tested on Ubuntu Long Term Support (LTS) releases, but other
distributions may be used. See the list below for recommended versions.
</p>
<p>
Your workstation must have the software listed below. See
<a href="initializing.html">Establishing a Build Environment</a> for
additional required packages and the commands to install them.
</p>
<h3 id=latest-version>OS and JDK</h3>
<p>
If you are developing against the AOSP <code>master</code> branch, use one
of these operating systems: Ubuntu 14.04 (Trusty) or Mac OS v10.10 (Yosemite)
or later with Xcode 4.5.2 and Command Line Tools.
</p>
<p>
For the Java Development Kit (JDK), note the <code>master</code> branch of
Android in AOSP comes with a prebuilt version of OpenJDK; so no additional
installation is required. Older versions require a separate install.
</p>
<p>See <a href="#older-versions">Packages for older versions</a>.
<h3 id=packages>Key packages</h3>
<ul>
<li>Python 2.6 to 2.7 from <a href="http://www.python.org/download/" class="external">python.org</a></li>
<li>GNU Make 3.81 to 3.82 from <a href="http://ftp.gnu.org/gnu/make/" class="external">gnu.org</a></li>
<li>Git 1.7 or newer from <a href="http://git-scm.com/download" class="external">git-scm.com</a></li>
</ul>
<h3 id=binaries>Device binaries</h3>
<p>
Download previews, factory images, drivers, over-the-air (OTA) updates, and
other blobs below. For details, see
<a href="building.html#obtaining-proprietary-binaries">Obtaining proprietary
binaries</a>.
</p>
<ul>
<li><a href="https://developers.google.com/android/blobs-preview" class="external">Preview
binaries (blobs)</a>. For AOSP <code>master</code> branch development.
</li>
<li><a href="https://developers.google.com/android/images" class="external">Factory
images</a>. For supported devices running tagged AOSP release branches.
</li>
<li><a href="https://developers.google.com/android/drivers" class="external">Binary
hardware support files</a>. For devices running tagged AOSP release
branches.
</li>
</ul>
<h3 id=toolchain>Build toolchain</h3>
<p>
Android 8.0 and higher support only
<a href="https://developer.android.com/ndk/guides/standalone_toolchain.html#working_with_clang" class="external">Clang/LLVM</a>
for building the Android platform. Join the
<a href="https://groups.google.com/forum/#!forum/android-llvm" class="external">android-llvm</a>
group to pose questions and get help. Report NDK/compiler issues at the
<a href="https://github.com/android-ndk/ndk" class="external">NDK GitHub</a>.
</p>
<p>
For the
<a href="https://developer.android.com/ndk/guides/index.html" class="external">Native
Development Kit (NDK)</a> and legacy kernels, GCC 4.9 included in the AOSP
master branch (under <code>prebuilts/</code>) may also be used.
</p>
<h3 id=older-versions>Packages for older versions</h3>
<p>
This section details operating systems and JDK packages for older versions of
Android.
</p>
<h4 id=operating-systems>Operating systems</h4>
<p>
Android is typically built with a GNU/Linux or Mac OS operating system. It is
also possible to build Android in a virtual machine on unsupported systems
such as Windows.
</p>
<p>We recommend building on GNU/Linux instead of another operating system. The
Android build system normally uses ART, running on the build machine, to
pre-compile system dex files. Since ART is able to run only on Linux, the
build system skips this pre-compilation step on non-Linux operating systems,
resulting in an Android build with reduced performance.
</p>
<h5 id=linux>GNU/Linux</h5>
<ul>
<li>Android 6.0 (Marshmallow) - AOSP master: Ubuntu 14.04 (Trusty)</li>
<li>Android 2.3.x (Gingerbread) - Android 5.x (Lollipop): Ubuntu 12.04
(Precise)</li>
<li>Android 1.5 (Cupcake) - Android 2.2.x (Froyo): Ubuntu 10.04 (Lucid)</li>
</ul>
<h5 id=mac>Mac OS (Intel/x86)</h5>
<ul>
<li>Android 6.0 (Marshmallow) - AOSP master: Mac OS v10.10 (Yosemite) or
higher with Xcode 4.5.2 and Command Line Tools
</li>
<li>Android 5.x (Lollipop): Mac OS v10.8 (Mountain Lion) with Xcode 4.5.2
and Command Line Tools
</li>
<li>Android 4.1.x-4.3.x (Jelly Bean) - Android 4.4.x (KitKat): Mac OS v10.6
(Snow Leopard) or Mac OS X v10.7 (Lion) and Xcode 4.2 (Apple's Developer
Tools)
</li>
<li>Android 1.5 (Cupcake) - Android 4.0.x (Ice Cream Sandwich): Mac OS
v10.5 (Leopard) or Mac OS X v10.6 (Snow Leopard) and the Mac OS X v10.5
SDK
</li>
</ul>
<h4 id=jdk>JDK</h4>
<p>
See <a href="initializing.html#installing-the-jdk">Installing the JDK</a>
for the prebuilt path and installation instructions for older versions.
</p>
<ul>
<li>Android 7.0 (Nougat) - Android 8.0 (Oreo): Ubuntu -
<a href="http://openjdk.java.net/install/" class="external">OpenJDK 8</a>,
Mac OS -
<a href="http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html#jdk-8u45-oth-JPR" class="external">jdk
8u45 or newer</a>
</li>
<li>Android 5.x (Lollipop) - Android 6.0 (Marshmallow): Ubuntu -
<a href="http://openjdk.java.net/install/" class="external">OpenJDK 7</a>,
Mac OS -
<a href="https://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase7-521261.html#jdk-7u71-oth-JPR" class="external">jdk-7u71-macosx-x64.dmg</a>
</li>
<li>Android 2.3.x (Gingerbread) - Android 4.4.x (KitKat): Ubuntu -
<a href="http://www.oracle.com/technetwork/java/javase/archive-139210.html" class="external">Java
JDK 6</a>, Mac OS - <a href="http://support.apple.com/kb/dl1572" class="external">Java JDK
6</a>
</li>
<li>Android 1.5 (Cupcake) - Android 2.2.x (Froyo): Ubuntu -
<a href="http://www.oracle.com/technetwork/java/javase/archive-139210.html" class="external">Java
JDK 5</a>
</li>
</ul>
<h4 id=make>Make</h4>
<p>
To avoid build errors, Android 4.0.x (Ice Cream Sandwich) and earlier must
<a href="initializing.html#reverting-from-make-382">revert from make 3.82</a>.
</p>
</body>
</html>
|
