🏗 Minimal Android AOSP build environment with handy automation wrapper scripts
Shell Makefile
Pull request Compare This branch is 4 commits ahead, 3 commits behind kylemanna:master.
Latest commit 705219b Jan 3, 2017 @tiann committed on GitHub Update README.md
Permalink
Failed to load latest commit information.
tests add gerrit mirror for nougat Dec 29, 2016
utils utils/aosp: Only pass UID and GID arguments if NOT root Oct 15, 2016
Dockerfile nougat: First pass at building 7.0 Oct 13, 2016
LICENSE
Makefile Add convenience Makefile to easily rebuild image Apr 19, 2016
README.md Update README.md Jan 3, 2017
README_EN.md
gitconfig gitconfig: Add default gitconfig to ease repo init Nov 11, 2014
ssh_config Dockerfile: Add default SSH config Nov 21, 2014

README.md

极简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合适,格式一定要选择带区分大小写标志的

开始下载编译

真正的下载编译过程相当简单,脚本会自动完成;步骤如下:

  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那一行。

感谢