diff options
Diffstat (limited to 'en/setup/build/requirements.html')
-rw-r--r-- | en/setup/build/requirements.html | 198 |
1 files changed, 198 insertions, 0 deletions
diff --git a/en/setup/build/requirements.html b/en/setup/build/requirements.html new file mode 100644 index 00000000..0a1f4259 --- /dev/null +++ b/en/setup/build/requirements.html @@ -0,0 +1,198 @@ +<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 or employ ccache, 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> |