支持旧版本

构建较近的旧版本(>= 5.0 Lollipop)

对于 Android 5.0 版(Lollipop 或 L)到 Android 8.0 版(Oreo 或 O),请考虑使用随附的 Dockerfile,以简化所有必需软件包的安装。

构建更早的旧版本(<= 4.4 KitKat)

操作系统

Android 通常是在 GNU/Linux 或 Mac OS X 操作系统中进行构建。您也可以使用虚拟机在不支持的系统(例如 Windows)中构建 Android。

我们建议在 GNU/Linux 上进行构建。Android 构建系统通常会在构建机器上运行 ART,以预编译系统 DEX 文件。ART 只能在 Linux 上运行,因此构建系统会在非 Linux 操作系统上跳过这个预编译步骤,从而导致 Android 构建性能下降。

GNU/Linux

  • Android 6.0 (Marshmallow) – AOSP master:Ubuntu 14.04 (Trusty)
  • Android 2.3.x (Gingerbread) – Android 5.x (Lollipop):Ubuntu 12.04 (Precise)
  • Android 1.5 (Cupcake) – Android 2.2.x (Froyo):Ubuntu 10.04 (Lucid)

Mac OS X (Intel/x86)

  • Android 6.0 (Marshmallow) – AOSP master:Mac OS X v10.10 (Yosemite) 或更高版本,具有 Xcode 4.5.2 和命令行工具
  • Android 5.x (Lollipop):Mac OS X v10.8 (Mountain Lion),具有 Xcode 4.5.2 和命令行工具
  • Android 4.1.x (Jelly Bean) – Android 4.4.x (KitKat):Mac OS X v10.6 (Snow Leopard) 或 Mac OS X v10.7 (Lion),以及 Xcode 4.2(Apple 开发者工具)
  • Android 1.5 (Cupcake) – Android 4.0.x (Ice Cream Sandwich):Mac OS X v10.5 (Leopard) 或 Mac OS X v10.6 (Snow Leopard),以及 Mac OS X v10.5 SDK

GNU make

对于早于 AOSP master 分支的版本(一直到 Android 4.1.x (Jelly Bean)),请使用 GNU make (gmake) 3.82。对于 Android 4.0.x (Ice Cream Sandwich) 及更低版本,请从 gmake 3.82 还原到旧版本,以避免出现构建错误。

Xcode 和其他软件包

对于版本较低的 Mac OS X v10.8 或更低版本,请从 Apple 开发者网站安装 Xcode。如果您尚未注册成为 Apple 开发者,则必须创建一个 Apple ID 才能下载。

如果您使用的是 Mac OS X v10.4,还需要安装 Bison:

    POSIXLY_CORRECT=1 sudo port install bison

如果使用 MacPorts,请发出以下命令:

    POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg

如果使用 Homebrew,请发出以下命令:

    brew install gmake libsdl git gnupg2

从 gmake 3.82 还原到旧版本

在 Android 4.0.x (Ice Cream Sandwich) 及更低版本中,gmake 3.82 中存在一个会导致 Android 无法构建的错误。您可以按照以下步骤使用 MacPorts 来安装 3.81 版:

  1. 修改 /opt/local/etc/macports/sources.conf,并将以下行:
        file:///Users/Shared/dports
    添加到 rsync 行上方。然后创建以下目录:
        mkdir /Users/Shared/dports
  2. 在新的 dports 目录下,运行以下命令:
        svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/ devel/gmake/
  3. 为新的本地代码库创建一个端口索引:
        portindex /Users/Shared/dports
  4. 安装旧版 gmake:
        sudo port install gmake @3.81

JDK

支持的版本

适用于 Linux 的 JDK

Android 开源项目 (AOSP) 中的 Android master 分支带有预构建版本的 OpenJDK(位于 prebuilts/jdk/ 下),因此无需另行安装。

较低版本的 Android 需要单独安装 JDK。在 Ubuntu 上,请使用 OpenJDK

对于 Ubuntu 15.04 及更高版本

请运行以下命令:

sudo apt-get update
sudo apt-get install openjdk-8-jdk

对于 Ubuntu LTS 14.04

目前没有适用于 Ubuntu 14.04 的受支持 OpenJDK 8 软件包。Ubuntu 15.04 OpenJDK 8 软件包能够在 Ubuntu 14.04 中顺利使用。更高的软件包版本(例如适用于 15.10、16.04 的版本)在 14.04 上使用以下指令时不起作用。

  1. old-releases.ubuntu.com 下载适用于 64 位架构的 .deb 软件包:
  2. (可选)对照随以上每个软件包列出的 SHA256 字符串,确认已下载文件的校验和。例如,使用 sha256sum 工具:
        sha256sum {downloaded.deb file}
  3. 安装软件包:
        sudo apt-get update
    为下载的每个 .deb 文件运行 dpkg。运行过程中可能会因缺少依赖项而出现错误:
        sudo dpkg -i {downloaded.deb file}
    解决缺少依赖项的问题:
        sudo apt-get -f install

(可选)更新默认的 Java 版本

(可选)对于以上 Ubuntu 版本,请通过运行以下命令来更新默认的 Java 版本:

sudo update-alternatives --config java
sudo update-alternatives --config javac