| <html devsite><head> |
| <title>搭建编译环境</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> |
| 本部分介绍了如何设置本地工作环境来编译 Android 源文件。您必须使用 Linux 或 Mac OS。目前不支持在 Windows 环境下进行编译。 |
| </p> |
| <p> |
| 要简要了解代码审核和代码更新的整个过程，请参阅<a href="../contribute/life-of-a-patch.html">补丁程序的生命周期</a>。 |
| </p> |
| <aside class="note"><strong>注意</strong>：本网站中所有命令的前面都带有美元符号 ($)，以便与输出或文件条目区分开来。您可以使用每个命令框右上角的“点击复制”功能来复制所有行（不包括美元符号），也可以三击每行来分别复制各行（不包括美元符号）。<em></em> |
| </aside> |
| |
| <h2 id="choosing-a-branch">选择分支</h2> |
| <p> |
| 针对编译环境的某些要求是由您打算编译的源代码的版本决定的。要查看可用分支的完整列表，请参阅<a href="../start/build-numbers.html">细分版本号</a>。您还可以选择下载并编译最新的源代码（称为 <code>master</code>）。如果您选择这么做，请在初始化代码库时直接忽略分支规范。 |
| </p> |
| <p> |
| 选择分支后，请按照下面的相应说明来设置编译环境。 |
| </p> |
| |
| <h2 id="setting-up-a-linux-build-environment">设置 Linux 编译环境</h2> |
| <p> |
| 以下说明适用于所有分支（包括 <code>master</code>）。 |
| </p> |
| <p>我们会定期在最近推出的一些 Ubuntu LTS (14.04) 和 Debian 测试版本中对 Android 编译系统进行内部测试。其他大多数分发版本都应该具有所需的编译工具。 |
| </p> |
| <p> |
| 如果是 Gingerbread (2.3.x) 及更高版本（包括 <code>master</code> 分支），需要使用 64 位环境。如果是较低的版本，则可以在 32 位系统中进行编译。 |
| </p> |
| <aside class="note"><strong>注意</strong>：要查看完整的硬件和软件要求列表，请参阅<a href="requirements.html">要求</a>。然后，请按照下方适用于 Ubuntu 和 Mac OS 的详细说明进行操作。 |
| </aside> |
| |
| <h3 id="installing-the-jdk">安装 JDK</h3> |
| <p> |
| <a href="https://android.googlesource.com/" class="external">Android 开源项目 (AOSP)</a> 中 Android 的 <code>master</code> 分支在 <code>prebuilts/jdk/</code> 下有预编译版本的 OpenJDK，因此无需另行安装。 |
| </p> |
| <p> |
| 较低版本的 Android 需要另行安装 JDK。在 Ubuntu 上，请使用 <a href="http://openjdk.java.net/install/" class="external">OpenJDK</a>。要了解确切的版本，请参阅 <a href="requirements.html#jdk">JDK 要求</a>；要了解相关说明，请参阅以下各个部分。 |
| </p> |
| <h4 id="for-ubuntu-15-04">如果 Ubuntu >= 15.04</h4> |
| <p> |
| 请运行以下命令： |
| </p> |
| <pre class="devsite-click-to-copy"> |
| <code class="devsite-terminal">sudo apt-get update</code> |
| <code class="devsite-terminal">sudo apt-get install openjdk-8-jdk</code> |
| </pre> |
| |
| <h4 id="for-ubuntu-14-04">如果是 Ubuntu LTS 14.04</h4> |
| <p> |
| 目前没有适用于 Ubuntu 14.04 的受支持 OpenJDK 8 软件包。<strong>Ubuntu 15.04 OpenJDK 8</strong> 软件包能够在 Ubuntu 14.04 中顺利使用。<em>我们发现，按照以下说明操作时，更高的软件包版本（例如适合 15.10、16.04 的版本）在 Ubuntu 14.04 中无法正常工作。</em> |
| </p> |
| <ol> |
| <li>从 <a href="http://old-releases.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/">old-releases.ubuntu.com</a> 下载适用于 64 位架构的 <code>.deb</code> 软件包： |
| <ul> |
| <li><a href="http://old-releases.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/openjdk-8-jre-headless_8u45-b14-1_amd64.deb">openjdk-8-jre-headless_8u45-b14-1_amd64.deb</a>（SHA256：<code>0f5aba8db39088283b51e00054813063173a4d8809f70033976f83e214ab56c0</code>） |
| </li> |
| <li><a href="http://old-releases.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/openjdk-8-jre_8u45-b14-1_amd64.deb">openjdk-8-jre_8u45-b14-1_amd64.deb</a>（SHA256：<code>9ef76c4562d39432b69baf6c18f199707c5c56a5b4566847df908b7d74e15849</code>） |
| </li> |
| <li><a href="http://old-releases.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/openjdk-8-jdk_8u45-b14-1_amd64.deb">openjdk-8-jdk_8u45-b14-1_amd64.deb</a>（SHA256：<code>6e47215cf6205aa829e6a0a64985075bd29d1f428a4006a80c9db371c2fc3c4c</code>） |
| </li> |
| </ul> |
| </li> |
| <li>（可选）对照随以上每个软件包列出的 SHA256 字符串，确认已下载文件的校验和。例如，使用 <code>sha256sum</code> 工具： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sha256sum {downloaded.deb file}</pre> |
| </li> |
| <li>安装软件包： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo apt-get update</pre> |
| 为下载的每个 .deb 文件运行 <code>dpkg</code>。运行过程中可能会因缺少依赖项而出现错误： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo dpkg -i {downloaded.deb file}</pre> |
| 解决缺少依赖项的问题： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo apt-get -f install</pre> |
| </li> |
| </ol> |
| |
| <h4 id="default-java-version">更新默认的 Java 版本 - 可选</h4> |
| <p> |
| （可选）对于以上 Ubuntu 版本，请通过运行以下命令来更新默认的 Java 版本：</p> |
| <pre class="devsite-click-to-copy"> |
| <code class="devsite-terminal">sudo update-alternatives --config java</code> |
| <code class="devsite-terminal">sudo update-alternatives --config javac</code> |
| </pre> |
| <aside class="note"> |
| <b>注意</b>：在编译过程中，如果您遇到 Java 版本错误，请参阅<a href="building.html#wrong-java-version">错误的 Java 版本</a>以查找可能的原因和解决方案。 |
| </aside> |
| |
| <h3 id="installing-required-packages-ubuntu-1404">安装所需的软件包 (Ubuntu 14.04)</h3> |
| <p> |
| 您将需要 64 位版本的 Ubuntu。建议您使用 Ubuntu 14.04。 |
| </p> |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev libgl1-mesa-dev libxml2-utils xsltproc unzip |
| </pre> |
| <aside class="note"><strong>注意</strong>：要使用 SELinux 工具进行政策分析，您还需要安装 <code>python-networkx</code> 软件包。 |
| </aside> |
| <aside class="note"><strong>注意</strong>：如果您使用 LDAP 并且希望运行 ART 主机测试，则还需要安装 <code>libnss-sss:i386</code> 软件包。 |
| </aside> |
| |
| <h3 id="installing-required-packages-ubuntu-1204">安装所需的软件包 (Ubuntu 12.04) |
| </h3> |
| <p> |
| 您可以使用 Ubuntu 12.04 来编译较低版本的 Android。master 或最近推出的一些版本不支持 Ubuntu 12.04。 |
| </p> |
| <pre class="devsite-click-to-copy"> |
| <code class="devsite-terminal">sudo apt-get install git gnupg flex bison gperf build-essential zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc zlib1g-dev:i386</code> |
| <code class="devsite-terminal">sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so</code> |
| </pre> |
| |
| <h3 id="installing-required-packages-ubuntu-1004-1110">安装所需的软件包 (Ubuntu 10.04 - 11.10) |
| </h3> |
| <p> |
| 不再支持在 Ubuntu 10.04-11.10 中进行编译，但它们仍可用来编译较低版本的 AOSP。 |
| </p> |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo apt-get install git gnupg flex bison gperf build-essential zip curl zlib1g-dev libc6-dev lib32ncurses5-dev ia32-libs x11proto-core-dev libx11-dev lib32readline5-dev lib32z-dev libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc |
| </pre> |
| <p> |
| 在 Ubuntu 10.10 中，请运行以下命令： |
| </p> |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo ln -s /usr/lib32/mesa/libGL.so.1 /usr/lib32/mesa/libGL.so |
| </pre> |
| <p> |
| 在 Ubuntu 11.10 中，请运行以下命令： |
| </p> |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo apt-get install libx11-dev:i386 |
| </pre> |
| |
| <h3 id="configuring-usb-access">配置 USB 使用权限</h3> |
| <p> |
| 按照说明<a href="https://developer.android.com/studio/run/device.html#setting-up" class="external">设置用于开发的设备</a>，以安装适用于所有 Android 设备且由社区维护的默认 <code>udev</code> 规则集。 |
| </p> |
| |
| <h3 id="using-a-separate-output-directory">使用单独的输出目录</h3> |
| <p> |
| 默认情况下，每次编译的输出都会存储在相应源代码树的 <code>out/</code> 子目录下。 |
| </p> |
| <p> |
| 在一些拥有多个存储设备的计算机上，如果将源文件和输出存储在单独的存储卷中，编译速度会更快。若要进一步提高编译速度，可以将输出存储在已针对速度（而非崩溃稳定性）进行优化的文件系统中，这是因为在文件系统损坏时可以重新生成所有文件。 |
| </p> |
| <p> |
| 要进行这项设置，请导出 <code>OUT_DIR_COMMON_BASE</code> 变量，使其指向将存储输出目录的位置。 |
| </p> |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| export OUT_DIR_COMMON_BASE=<path-to-your-out-directory> |
| </pre> |
| <p> |
| 对于每个单独的源代码树，其输出目录都将以其存放目录命名。例如，如果您有源代码树 <code>/source/master1</code> 和 <code>/source/master2</code>，并且 <code>OUT_DIR_COMMON_BASE</code> 设为了 <code>/output</code>，那么输出目录将为 <code>/output/master1</code> 和 <code>/output/master2</code>。 |
| </p> |
| <p> |
| 在这种情况下，切勿将多个源代码树存储在具有相同名称的目录下，否则会导致输出目录共享终止，并且会出现不可预知的结果。只有 Jelly Bean (4.1) 及更高版本（包括 <code>master</code> 分支）支持这种做法。 |
| </p> |
| <h2 id="setting-up-a-mac-os-x-build-environment">设置 Mac OS 编译环境</h2> |
| <p> |
| 在默认安装过程中，Mac OS 会在一个保留大小写但不区分大小写的文件系统中运行。Git 并不支持此类文件系统，而且此类文件系统会导致某些 Git 命令（例如 <code>git status</code>）的行为出现异常。因此，我们建议您始终在区分大小写的文件系统中处理 AOSP 源文件。使用下文中介绍的磁盘映像可以非常轻松地做到这一点。 |
| </p> |
| <p> |
| 有了适当的文件系统后，在新型 Mac OS 环境中编译 <code>master</code> 分支就会变得非常简单。要编译较早版本的分支，则需要一些额外的工具和 SDK。 |
| </p> |
| |
| <h3 id="creating-a-case-sensitive-disk-image">创建区分大小写的磁盘映像</h3> |
| <p> |
| 您可以使用磁盘映像在现有的 Mac OS 环境中创建区分大小写的文件系统。要创建磁盘映像，请启动磁盘工具，然后选择<strong>新建映像</strong>。完成编译至少需要 25GB 空间；更大的空间能够更好地满足未来的需求。使用稀疏映像有助于节省空间，而且以后可以随着需求的增加进行扩展。请务必选择 <strong>Case sensitive, Journaled</strong> 存储卷格式。 |
| </p> |
| <p> |
| 您也可以通过 shell 使用以下命令创建磁盘映像： |
| </p> |
| <pre class="devsite-click-to-copy devsite-terminal" data-terminal-prefix="# "> |
| hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 40g ~/android.dmg |
| </pre> |
| <p> |
| 这将创建一个 <code>.dmg</code>（也可能是 <code>.dmg.sparseimage</code>）文件，该文件在装载后可用作具有 Android 开发所需格式的驱动盘。 |
| </p> |
| <p> |
| 如果您以后需要更大的存储卷，还可以使用以下命令来调整稀疏映像的大小： |
| </p> |
| <pre class="devsite-click-to-copy devsite-terminal" data-terminal-prefix="# ">hdiutil resize -size <new-size-you-want>g ~/android.dmg.sparseimage |
| </pre> |
| <p> |
| 对于存储在主目录下的名为 <code>android.dmg</code> 的磁盘映像，您可以向 <code>~/.bash_profile</code> 中添加辅助函数： |
| </p> |
| <ul> |
| <li>要在执行 <code>mountAndroid</code> 时装载磁盘映像，请运行以下命令： |
| <pre class="devsite-click-to-copy"> |
| # mount the android file image |
| mountAndroid() { hdiutil attach ~/android.dmg -mountpoint /Volumes/android; }</pre> |
| <aside class="note"><strong>注意</strong>：如果系统创建的是 <code>.dmg.sparseimage</code> 文件，请将 <code>~/android.dmg</code> 替换为 <code>~/android.dmg.sparseimage</code>。 |
| </aside> |
| </li> |
| <li>要在执行 <code>umountAndroid</code> 时卸载磁盘映像，请运行以下命令： |
| <pre class="devsite-click-to-copy"> |
| # unmount the android file image |
| umountAndroid() { hdiutil detach /Volumes/android; }</pre> |
| </li> |
| </ul> |
| <p> |
| 装载 <code>android</code> 存储卷后，您将在其中开展所有工作。您可以像对待外接式驱动盘一样将其弹出（卸载）。 |
| </p> |
| |
| <h3 id="installing-the-mac-jdk">安装 JDK</h3> |
| <p> |
| 要查看要在开发各种 Android 版本时使用的 Java 版本，请参阅相关<a href="requirements.html">要求</a>。 |
| </p> |
| |
| <h4 id="installing-required-packages">安装所需的软件包</h4> |
| <ol> |
| <li>使用以下命令安装 Xcode 命令行工具： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| xcode-select --install</pre> |
| 对于较低版本的 Mac OS（10.8 或更低版本），您必须通过 <a href="http://developer.apple.com/" class="external">Apple 开发者网站</a>安装 Xcode。如果您尚未注册成为 Apple 开发者，则必须创建一个 Apple ID 才能下载。 |
| </li> |
| <li>通过 <a href="http://www.macports.org/install.php">macports.org</a> 安装 MacPorts。请确保 <code>/opt/local/bin</code> 在路径中显示在 <code>/usr/bin</code> <strong>前面</strong>。否则，请将以下内容添加到 <code>~/.bash_profile</code> 文件中： |
| <pre class="devsite-click-to-copy"> |
| export PATH=/opt/local/bin:$PATH</pre> |
| <aside class="note"><strong>注意</strong>：如果主目录中没有 <code>.bash_profile</code> 文件，请创建一个。 |
| </aside> |
| </li> |
| <li>通过 MacPorts 获取 Make、Git 和 GPG 软件包： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg</pre> |
| 如果您使用的是 Mac OS X v10.4，还需要安装 bison： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| POSIXLY_CORRECT=1 sudo port install bison</pre> |
| </li> |
| </ol> |
| |
| <h4 id="reverting-from-make-382">将 make 3.82 还原到较低版本</h4> |
| <p> |
| 在 Android 4.0.x (Ice Cream Sandwich) 及更低版本中，gmake 3.82 中存在一个会导致 Android 无法编译的错误。您可以按照以下步骤使用 MacPorts 来安装 3.81 版： |
| </p> |
| <ol> |
| <li>修改 <code>/opt/local/etc/macports/sources.conf</code>，在 rsync 行上方添加下面这行内容： |
| <pre class="devsite-click-to-copy"> |
| file:///Users/Shared/dports</pre> |
| 然后创建该目录： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| mkdir /Users/Shared/dports</pre> |
| </li> |
| <li>在新的 <code>dports</code> 目录下，运行以下命令： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/ devel/gmake/</pre> |
| </li> |
| <li>为新的本地代码库创建一个端口索引： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| portindex /Users/Shared/dports</pre> |
| </li> |
| <li>使用以下命令安装旧版 gmake： |
| <pre class="devsite-terminal devsite-click-to-copy"> |
| sudo port install gmake @3.81</pre> |
| </li> |
| </ol> |
| |
| <h4 id="setting-a-file-descriptor-limit">设置文件描述符数量上限</h4> |
| <p> |
| 在 Mac OS 中，可同时打开的文件描述符的默认数量上限太低，在高度并行的编译流程中，可能会超出此上限。要提高此上限，请将下列行添加到 <code>~/.bash_profile</code> 中： |
| </p> |
| <pre class="devsite-click-to-copy"> |
| # set the number of open files to be 1024 |
| ulimit -S -n 1024</pre> |
| |
| <h2 id="next-download-the-source">下一篇：下载源代码</h2> |
| <p> |
| 编译环境已准备就绪！请继续阅读<a href="downloading.html">下载源代码</a>一文。 |
| </p> |
| |
| </body></html> |
