tiann/docker-aosp

极简Android源码编译环境搭建工具

这是一个帮助快速搭建Android源码编译环境的工具，项目fork自 kylemanna/docker-aosp；针对Docker以及天朝的网络环境做了一部分修改，仅供China用户使用。

使用步骤

安装Docker

由于Android源码庞大，依赖复杂；一旦使用的编译工具链有细微的不同就可能引发编译失败。官方文档 推荐使用Ubuntu 14.04进行编译。如果我们用Windows或者Mac系统，传统方式是使用虚拟机；但是在今天，我们完全可以使用 Docker 替代！！

使用Docker，我们可以不用担心编译环境问题；不论我们的开发机是什么系统，可以使用Docker创建Ubuntu Image，并且直接在这个Ubuntu系统环境中创建编译所需要的工具链（JDK，ubuntu系统的依赖库等等）；而且，Docker运行的Ubuntu的系统开销比虚拟机低得多，这样下载以及编译速度就有了质的提升。更重要的是，这个环境可以作为一个Image打包发布！这样，你在不同的开发机，还有你与你的同事之间有了同一套编译环境，这会省去很多不必要的麻烦。关于Docker的更多内容，见 Docker官网

Docker的下载地址见 Docker下载 ；下载完毕安装即可。

准备工作

如果你不是Mac系统，可以直接略过这一步。

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

1. 打开Mac的系统软件：磁盘工具

2. CMD + N，创建新的磁盘映像，参数设置如下图：

   

   其中磁盘大小设置为 50~100G合适，格式一定要选择带区分大小写标志的

注意：由于 Docker for Mac 中使用磁盘映射方式效率低下，请不要把源码下载到宿主机，然后使用volume映射的方式把代码映射到 docker 内部来编译代码！！，否则等待编译的过程会让你头皮发麻(比正常方式慢将近100倍，几乎无法编译完成）。

开始下载编译

真正的下载编译过程相当简单，脚本会自动完成；步骤如下：

1. 设置Android源码下载存放的目录；如果是Mac系统，这一步必须设置为一个大小写敏感的目录；不然后面编译的时候会失败。如果不设置这一步，那么源码会下载到 ~/aosp-root 目录；设置过程如下：

   export AOSP_VOL=/Volume/Android/

2. 下载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

3. 运行脚本，开始自动下载安装过程；Windows系统可以使用 Bash for Windows 或者cygwin。

   bash ./build-nougat.sh

这样，所有的工作就都做完了。只需静静等待即可；时间视下载速度而定，清华的镜像速度还可以，笔者使用不到2小时就完成了下载编译过程。

FAQ

1. bash: run.sh: No such file or directory    确保执行了第一步：正确地导出了环境变量 AOSP_VOL；Windows和Mac以及Linux上方式各不相同。
2. ccache: FATAL: x_realloc: Could not allocate 8589934592 bytes    打开build脚本，注释掉使用ccache那一行。

感谢

• kylemanna/docker-aosp
• 清华镜像