一、编译源码的背景环境

Android源码编译有什么困难

  1. AOSP 非常庞大,需要下载,但是他是Google家的,和大陆开发者之间隔着一个GFW
  2. 官方文档 推荐使用Ubuntu 14.04进行编译。我用的是MacOS,官网也给了Mac下的编译方式,不过看起来还是挺麻烦的。而且我怕搞乱我的电脑。

针对上面的两点,以前有这么两种解决方式,以前有这么几种解决方式

  1. 至于下载慢,可以使用国内镜像清华镜像科大镜像,好像现在google的开发者网站部分不用梯子就可以访问了[当前时间2017-04]
  2. 有人使用虚拟机,然后安装Ubuntu,然后编译源码。这方式也可以,但是Mac下三种虚拟机,免费的那个还不好用。而且编译本身就比较消耗资源,再装个虚拟机就更麻烦了

后来有人提出用Docker

而且这个人搞了一份Docker镜像出来 kylemanna/docker-aosp,后来有人针对Docker以及天朝的网络环境做了一部分修改,fork了一份国产的 tiann/docker-aosp。主要是修改了shell脚本中的下载源。但是这个东西在MAC OS上有bugissues 19所以我就没用成功。

有一点题外话需要说一下,这个Docker安装后会开机默认启动,默认启动倒是也没问题,有问题的是他不可以和Android虚拟机同时运行,就是AndroidStudio自带的那个虚拟机。

二、搭建Mac编译环境

修改文件描述符限制
~/.bash_profile中添加以下内容

the number of open files to be 1024
1
ulimit -S -n 1024

开发环境要求

  1. Mac OS v10.10 (Yosemite) 或以上,安装了 Xcode 4.5.2或以上,安装了Command Line Tools。
  2. 安装JDK 7
  3. 安装了python 2.7
  4. GNU Make 3.81或3.82
  5. Git

我本机环境

  1. Mac OS v10.12.4
  2. xcode v8.0
  3. git version 2.8.4 (Apple Git-73)
  4. GNU Make 3.81
  5. 为了编译不同版本的Android源码,同时安装了JDK7 & JDK8,通过配置.bash_profile 来切换
  6. Python 2.7.11
  7. 之前我电脑还安装了homebrew

磁盘分区

为什么在Mac上编译会很麻烦呢,因为Mac的文件系统默认不区分大小写,但是Android源码编译系统的要求区分大小写,这时候我们可以创建个区分大小写的磁盘空间。方法如下:

  1. 打开磁盘工具(在Launchpad中直接搜索就行)
  2. 如下图操作(磁盘命名为AOSP,磁盘大小为100G,磁盘格式一定要选择区分大小写) 首先选中Macintosh HD 然后Comand + N
    磁盘分区

    这个磁盘分区的名字后面要用到,磁盘大小好像官网推荐70G,以防不够还是大点吧,格式一定要选区分大小写。这个磁盘分区还有另一种方式,我不知道这两种方式到底有什么区别。对应磁盘的分区使用,有人为了节省Mac上的硬盘,也为了防止搞坏系统,用了外接硬盘的方式然后操作这个外接硬盘的分区。

下载Android源码

下面是科大的源也可以用清华的参考文献我下载的是Android6.0的源码,最终编译的时候选择的是x86_64

  1. 下载 repo 工具:

    1
    2
    3
    4
    mkdir ~/bin
    PATH=~/bin:$PATH
    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
  2. 建立工作目录:

    1
    2
    3
    cd /Volumes/AOSP/
    mkdir WORKING_DIRECTORY
    cd WORKING_DIRECTORY
  3. 初始化仓库

    1
    2
    3
    repo init -u git://mirrors.ustc.edu.cn/aosp/platform/manifest
    ## 如果提示无法连接到 gerrit.googlesource.com,可以编辑 ~/bin/repo,把 REPO_URL 一行替换成下面的:
    ## REPO_URL = 'https://gerrit-googlesource.proxy.ustclug.org/git-repo'

    如果需要某个特定的 Android 版本(Android 版本列表),可以通过下面的方式指定版本号,如果不指定则代码下载当前最新的代码。

    1
    repo init -u git://mirrors.ustc.edu.cn/aosp/platform/manifest -b android-6.0.1_r46

    注:在mac上运行这行可能会报错,GnuPG 这玩意不可用,解决方式看最后错解决

  4. 同步源码树(以后只需执行这条命令来同步)如果中途出现网络错误,可以停止后在执行下面的命令:

1
repo sync

然后就等着吧0_0

编译源码

  1. 清空缓存
    $ make clobber

    注:如果运行这行命令出错看文章最后错误处理

  2. 配置编译环境
    $ source build/envsetup.sh
  3. 选择编译目标
    $ lunch 这时候会列出一系列的选项然后选择一个如下:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    You're building on Darwin
    Lunch menu... pick a combo:
    1. aosp_arm-eng
    2. aosp_arm64-eng
    3. aosp_mips-eng
    4. aosp_mips64-eng
    5. aosp_x86-eng
    6. aosp_x86_64-eng
    7. full_fugu-userdebug
    8. aosp_fugu-userdebug
    9. mini_emulator_arm64-userdebug
    10. m_e_arm-userdebug
    11. m_e_mips-userdebug
    12. m_e_mips64-eng
    13. mini_emulator_x86-userdebug
    14. mini_emulator_x86_64-userdebug
    15. aosp_dragon-userdebug
    16. aosp_dragon-eng
    17. aosp_marlin-userdebug
    18. aosp_sailfish-userdebug
    19. aosp_flounder-userdebug
    20. aosp_angler-userdebug
    21. aosp_bullhead-userdebug
    22. hikey-userdebug
    23. hikey960-userdebug
    24. aosp_shamu-userdebug
    Which would you like? [aosp_arm-eng]

    然后直接输入上面选项的序号就好了这里,我选择第一个,至于上面那些名字的含义是啥看下面解释:

    官网说根据上面名字的后缀可以判断要编译那种类型的:

    • user: limited access; suited for production(有限的访问权限,一般用于发布版)
    • userdebug: 这个和user类似,但是可以获取root权限,并且能够调试
    • eng: 具有开发配置,并且有额外的调试工具(注:工程师模式engineer)

    lunch命令也可以直接这么用 $ lunch aosp_arm-eng

  4. 开始编译
    make -j16 这里指定的开启几个并行task来进行编译,官网建议j后面的数字根据你电脑的线程数量的1~2倍来设置,比如电脑是双核CPU,每个CPU为双核心四线程,那么就有8个线程。所以我配置的数量为16。
    然后就是漫长的等待ing…

启动模拟器

  1. $ source build/envsetup.sh
  2. $ lunch (选择刚才你设置的目标版本,我编译的是x86_64-eng的那个)
  3. $ emulator模拟器启动,这个命令有很多复杂用法,具体可参考官网。

烧录镜像到机器中

这个烧录过程我没有测试,官网是这么写的。

  1. 进入fastboot模式
    $ adb reboot bootloader
  2. 把img文件刷进去
    $ fastboot flashall -w 这个 -w 是为了wipes the /data partition擦除/data分区

    驱动下载

AndroidStudio中查看源码

在android源码中有这么一个目录development/tools/idegen。
顾名思义,是生成ide的project文件,主要是生成intellij的project文件,可用于AndroidStudio。

  1. 在整个Android源码全编成功之后,然后编译idegen模块,用以生成Android studio的工程配置文件,编译成功之后就生成了idegen.jar(out/host/darwin-x86/framework/idegen.jar),运行如下命令:
    $ mmm development/tools/idegen/

    注:如果刚才编译AOSP的那个命令行窗口关闭了,必须要在执行source build/envsetup.sh一次,用了初始化编译环境。

  2. 在源码根目录生成对应的android.ipr、android.iml IEDA工程配置文件。以便于AndroidStudio可以打开项目
    $ . development/tools/idegen/idegen.sh
  3. 打开Android studio,点击File –> Open,选择刚刚生成的android.ipr就好了。

三、错误处理

执行repo init的错误

错误1描述

1
2
warning: gpg (GnuPG) is not available.
warning: Installing it is strongly encouraged.

解决方法:
原因是GnuPG for osx没有安装,去https://www.gnupg.org/download/下载安装即可。
我用homebrew安装的brew install gnupg

执行make clobber的错误

错误1描述:

1
2
build/core/config.mk:660: error: Error: could not find jdk tools.jar at /System/Library/Frameworks/JavaVM.framework/Versions/A/Commands/../lib/tools.jar, please check if your JDK was installed correctly.
17:29:26 ckati failed with: exit status 1

解决方式:
~/.bash_profile添加如下代码

1
2
3
4
export JAVA_8_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_111.jdk/Contents/Home
export JAVA_HOME=$JAVA_8_HOME
##上面是jdk的配置,主要是添加下面这一行
export ANDROID_JAVA_HOME=$JAVA_HOME

错误2描述

1
2
3
4
build/core/combo/mac_version.mk:38: *****************************************************
build/core/combo/mac_version.mk:39: * Can not find SDK 10.6 at /Developer/SDKs/MacOSX10.6.sdk
build/core/combo/mac_version.mk:40: *****************************************************
build/core/combo/mac_version.mk:41: *** Stop.. Stop.

解决方法:
出现这个错误是因为xcode的版本不对,首先查看本机安装xcode的版本,
$ cd /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
然后修改build/core/combo/mac_version.mk这个文件中的下面这行,把本机的版本号添加到下面,我的是10.12 添加后如下:

1
mac_sdk_versions_supported := 10.6 10.7 10.8 10.9 10.12

错误3描述:

1
2
3
4
5
6
7
system/core/libcutils/threads.c:38:10: error: 'syscall' is deprecated: first deprecated in OS X 10.12 - syscall(2) is unsupported; please switch to a supported interface. For SYS_kdebug_trace use kdebug_signpost(). [-Werror,-Wdeprecated-declarations]
return syscall(SYS_thread_selfid);
^
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.12.sdk/usr/include/unistd.h:733:6: note: 'syscall' has been explicitly marked deprecated here
int syscall(int, ...);
^
1 error generated.

解决方式:
这个错误3归根到底是因为错误2引起的,再归根下是xcode版本引起的,(为啥说在mac上编译麻烦,这个xcode版本会出这么多破事),没办法这个我们上面用的mac sdk 10.12 版本太高了,这个版本废弃了某些方法导致编译不可用,那就去下个低版本的吧传送门压缩包在这然后下载那个10.11。理论上来说,下载后把目录放到这个路径下/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/和这个MacOSX10.12.sdk目录平级就行了,然后把错误2中添加到build/core/combo/mac_version.mk中的那个10.12改成10.11就好了。但是这个东西貌似在下次xcode升级的时候会被删掉。
a oh so? 弄个软连接:
$ mkdir ~/lib
然后把下载的压缩包解压到~/lib
$ sudo ln -s ~/lib/MacOSX10.11.sdk /Applications/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk