构建较近的旧版本(>= 5.0 Lollipop)
对于 Android 5.0 版(Lollipop 或 L)到 Android 8.0 版(Oreo 或 O),请考虑使用随附的 Dockerfile,以简化所有必需软件包的安装。
构建更早的旧版本(<= 4.4 KitKat)
操作系统
Android 通常是使用 GNU/Linux 构建的。您也可以使用虚拟机在不支持的系统(例如 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 版:
- 修改
/opt/local/etc/macports/sources.conf
,并将以下行:file:///Users/Shared/dports
添加到 rsync 行上方。然后创建以下目录:mkdir /Users/Shared/dports
- 在新的
dports
目录下,运行以下命令:svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/ devel/gmake/
- 为新的本地代码库创建一个端口索引:
portindex /Users/Shared/dports
- 安装旧版 gmake:
sudo port install gmake @3.81
JDK
支持的版本
- Android 7.0 (Nougat) – Android 8.0 (Oreo):
- Ubuntu:OpenJDK 8
- Mac OS X:JDK 8u45 或更高版本
- Android 5.x (Lollipop) – Android 6.0 (Marshmallow):
- Ubuntu:OpenJDK 7
- Mac OS X:jdk-7u71-macosx-x64.dmg
- Android 2.3.x (Gingerbread) – Android 4.4.x (KitKat):
- Ubuntu:Java JDK 6
- Mac OS X:Java JDK 6
- Android 1.5 (Cupcake) – Android 2.2.x (Froyo):
- Ubuntu:Java JDK 5
适用于 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 上使用以下指令时不起作用。
- 从 old-releases.ubuntu.com 下载适用于 64 位架构的
.deb
软件包:- openjdk-8-jre-headless_8u45-b14-1_amd64.deb
(SHA2560f5aba8db39088283b51e00054813063173a4d8809f70033976f83e214ab56c0
) - openjdk-8-jre_8u45-b14-1_amd64.deb
(SHA2569ef76c4562d39432b69baf6c18f199707c5c56a5b4566847df908b7d74e15849
) - openjdk-8-jdk_8u45-b14-1_amd64.deb
(SHA2566e47215cf6205aa829e6a0a64985075bd29d1f428a4006a80c9db371c2fc3c4c
)
- openjdk-8-jre-headless_8u45-b14-1_amd64.deb
- (可选)对照随以上每个软件包列出的 SHA256 字符串,确认已下载文件的校验和。例如,使用
sha256sum
工具:sha256sum {downloaded.deb file}
- 安装软件包:
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