Skip to content

🏗 Minimal Android AOSP build environment with handy automation wrapper scripts

License

Notifications You must be signed in to change notification settings

chantincheung/docker-aosp

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

感谢

About

🏗 Minimal Android AOSP build environment with handy automation wrapper scripts

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 99.0%
  • Makefile 1.0%