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

由于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小时就完成了下载编译过程。

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
• 清华镜像