史上最简单Android源码编译环境搭建方法-Windows系列-PHP中文网

史上最简单Android源码编译环境搭建方法

爱谁谁

发布： 2025-09-22 08:09:08

原创

912人浏览过

自android源码编译环境的搭建以来，始终是件棘手的事情。网络上关于如何编译android源码的文章不计其数，但它们要么方法繁琐、步骤繁多；要么声称解决了某些编译问题（需要修改头文件、系统配置等），让人对其可信度产生怀疑。有些朋友硬着头皮照做，结果由于伟大的gfw，多数人连第一步——repo脚本的下载都无法完成，即使下载成功也过不了gerrit那一关。此外，即便你有访问国外网站的能力，下载时间也成了拦路虎；普通的v**通常需要七八个小时，简直痛不欲生。久而久之，很多人对下载编译android源码望而却步。

今天，我为大家提供一个极简且稳定的方案，来解决Android源码的下载编译问题。

首先，下载问题可以通过镜像解决；清华镜像和科大镜像都是非常不错的选择，通常一到两个小时即可下载完一个Android源码分支。

然后是编译环境问题。由于Android源码庞大，依赖复杂；一旦使用的编译工具链有细微不同就可能导致编译失败。官方文档推荐使用Ubuntu 14.04进行编译。如果我们使用Windows或Mac系统，传统方式是使用虚拟机；但在今天，我们完全可以使用Docker替代！！借助Docker，我们无需担心编译环境问题；无论我们的开发机是什么系统，都可以使用Docker创建Ubuntu Image，并在这个Ubuntu系统环境中创建编译所需的工具链（JDK、Ubuntu系统的依赖库等）；而且，Docker运行的Ubuntu系统开销比虚拟机低得多，这样下载以及编译速度就有了质的提升。更重要的是，这个环境可以作为一个Image打包发布！这样，你在不同的开发机上，以及你与你的同事之间有了同一套编译环境，这会省去很多不必要的麻烦。关于Docker的更多内容，请见Docker官网。

当然，这个伟大的创举并不是我完成的，而是kylemanna/docker-aosp！我针对Docker以及中国大陆的网络环境做了一部分修改，fork了一份tiann/docker-aosp。

废话不多说，我们来看看具体如何使用，以及如何简单操作。

使用步骤：

安装Docker：Docker的下载地址见Docker下载；下载完毕后安装即可。
准备工作：如果你不是Mac系统，可以直接略过这一步。

码上飞
码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情

Mac的文件系统默认不区分大小写，这不满足Android源码编译系统的要求（编译时直接Error）；因此需要单独创建一个大小写敏感的磁盘映像。步骤如下：

打开Mac的系统软件：磁盘工具CMD + N，创建新的磁盘映像，参数设置如下图：

其中磁盘大小设置为50~100G合适，格式一定要选择带区分大小写标志的。
开始下载编译：真正的下载编译过程相当简单，脚本会自动完成；步骤如下：
- 设置Android源码下载存放的目录；如果是Mac系统，这一步必须设置为一个大小写敏感的目录；否则后面编译时会失败。如果不设置这一步，那么源码会下载到
```
~/aosp-root
```
  登录后复制
  目录；设置过程如下：
```
export AOSP_VOL=/Volume/Android/
```
  登录后复制
- 下载wrapper脚本；如果需要下载其他系统版本，直接修改下载完毕后的build-nougat.sh文件的android-4.4.4_r2.0.1改成你需要的分支即可，分支的信息见分支列表
```
curl -O https://raw.githubusercontent.com/kylemanna/docker-aosp/master/tests/build-nougat.sh
```
  登录后复制
- 运行脚本，开始自动下载安装过程；Windows系统可以使用Bash for Windows或cygwin。
```
bash ./build-nougat.sh
```
  登录后复制