下载和构建 Android 源代码之前,请先确保您的系统符合以下要求,然后参阅搭建构建环境以根据操作系统获取安装说明。
硬件要求
您的开发工作站必须达到或超出以下硬件要求:
- 如果是 Android 2.3.x (Gingerbread) 及更高版本(包括 master 分支),需要 64 位环境。如果是较低的版本,则可以在 32 位系统中进行编译。
- 如果要检出代码,至少需要 250 GB 可用磁盘空间;如果要进行构建,则还需要 150 GB。如果要进行多次构建,则需要更多空间。
- 至少需要 16 GB 的可用 RAM,但 Google 建议提供 64 GB。
从 2021 年 6 月起,Google 使用 72 核机器,内置 RAM 为 64 GB,完整构建过程大约需要 40 分钟(增量构建只需几分钟时间,具体取决于修改了哪些文件)。相比之下,RAM 数量相近的 6 核机器执行完整构建过程需要 3 个小时。
软件要求
AOSPmaster
分支历来都是在 Ubuntu 长期支持 (LTS) 版本中进行开发和测试,但也可以使用其他分发版本。如需了解所需的其他软件包以及用于安装这些软件包的命令,请参阅搭建构建环境。
您的工作站必须具有下面列出的软件。这些要求适用于 AOSP master
分支。对于 Android 5.0 版(Lollipop 或 L)到 Android 8.0 版(Oreo 或 O),请考虑使用随附的 Dockerfile,以简化所有必需软件包的安装。如果您使用手动方法,请参阅支持旧版本。
操作系统
如果您要针对 AOSP master
分支进行开发,请使用 Ubuntu 18.04 (Bionic Beaver)。
JDK
AOSP 中的 Android master
分支带有预构建版本的 OpenJDK;因此无需另行安装。
旧版 Android 需要单独安装 JDK。在 Ubuntu 上,请使用 OpenJDK。
主要软件包
AOSP master 分支带有预构建版本的 Make;因此无需另行安装。类似地,Git 是在搭建构建环境过程中安装的。
确保您的系统已安装 Python 3。
设备二进制文件
下载预览、出厂映像、驱动程序、无线 (OTA) 更新和下列其他 Blob。如需了解详情,请参阅获取专有二进制文件。
- 预览二进制文件 (Blob),针对 AOSP
master
分支开发 - 出厂映像,针对运行带标记的 AOSP 版本分支的受支持设备
- 硬件支持二进制文件,针对运行带标记的 AOSP 版本分支的设备
构建工具链
Android 8.0 及更高版本仅支持使用 Clang/LLVM 来构建 Android 平台。您可以加入 android-llvm 网上论坛来提出问题并获取帮助。在 NDK GitHub 上报告 NDK/编译器问题。
对于原生开发工具包 (NDK) 和旧版内核,您也可以使用 AOSP master
分支中包含的 GCC 4.9(在 prebuilts/
下)。