1. 要求

1.1 硬件

• 160g可用磁盘空间。

笔者编译的是Android 9.0源码，下载下来后将近40g，编译后153g，所以至少需要160g可用磁盘空间。

看网上有别人下载编译7.1.1版本的源码，编译下来需要67g，则可用磁盘空间至少需要分配80g。

注：在编译过程中，如果由于磁盘空间不足导致编译失败，可重新调整磁盘大小，然后接着之前的进度继续编译，所以此处看个人编译的版本，但至少要保证可用磁盘不能太小。

1.2 软件

1.2.1 编译的Android版本与需要的Mac OS版本

• Android 6.0 (Marshmallow) - AOSP master：Mac OS v10.10 (Yosemite) 或更高版本，具有 Xcode 4.5.2 和命令行工具
• Android 5.x (Lollipop) ：Mac OS v10.8 (Mountain Lion)，具有 Xcode 4.5.2 和命令行工具
• Android 4.1.x-4.3.x (Jelly Bean) - Android 4.4.x (KitKat) ：Mac OS v10.6 (Snow Leopard) 或 Mac OS X v10.7 (Lion)，以及 Xcode 4.2（Apple 的开发者工具）
• Android 1.5 (Cupcake) - Android 4.0.x (Ice Cream Sandwich) ：Mac OS v10.5 (Leopard) 或 Mac OS X v10.6 (Snow Leopard)，以及 Mac OS X v10.5 SDK

1.2.2 JDK

• Android 7.0 (Nougat) - Android 8.0 (O) ：jdk 8u45 或更高版本
• Android 5.x (Lollipop) - Android 6.0 (Marshmallow) ：jdk-7u71-macosx-x64.dmg
• Android 2.3.x (Gingerbread) - Android 4.4.x (KitKat) ：Java JDK 6

2. 准备工作

2.1 创建分区大小写的磁盘映像

Mac OS默认会在不区分大小写的文件系统中运行，但由于Git并不支持此类文件系统，所以需要在Mac OS上建立一个区分大小写的磁盘分区。我们这里使用命令行来创建，一是比较方便，二是后期可扩展。

在终端输入以下命令来创建一个160g大小的磁盘映像：

$ hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 160g ~/android.dmg

会在当前用户目录下生成一个android.dmg.sparseimage文件，可简单理解为该文件是编译源码所需要的驱动盘。

建议在分区时size指定为160g，但如果后期不够，可以通过该命令来调整分区大小，例如下面命令调整为200g：

$ hdiutil resize -size 200g ~/android.dmg.sparseimage

注意：调整分区大小的命令，需要在该分区磁盘映像已卸载的情况下才能生效。

2.2 添加装载和卸载磁盘分区的命令和函数

为了方便装载和卸载该分区磁盘映像，我们可以向~/.bash_profile文件中添加如下函数：

# mount the android file image
mountAndroid() { hdiutil attach ~/android.dmg.sparseimage -mountpoint /Volumes/android; }

需要装载分区磁盘映像时，执行如下命令即可，装载路径为/Volumes/android：

$ mountAndroid

同样，卸载的函数如下，我们也将它添加到~/.bash_profile文件中：

# unmount the android file image
umountAndroid() { hdiutil detach /Volumes/android; }

执行如下命令，便可卸载该分区磁盘映像：

$ umountAndroid

2.3 安装Xcode和其它软件包

1. 安装Xcode命令行工具：

$ xcode-select --install

2. 安装Xcode，直接在AppStore里安装即可。

3. 安装MacPorts或Homebrew，MacPorts和Homebrew是软件包管理工具，可用来直接在终端里安装、更新和卸载软件包。建议二者都安装，笔者在通过MacPorts安装gnupg时死活装不上，最后通过Homebrew安装成功：

4. 在~/.bash_profile文件中导入路径，就可以使用port或brew命令来管理软件包了：

 export PATH=/opt/local/bin:$PATH
 export PATH=/usr/local/bin:$PATH

5. 安装gmake、libsdl、git和gnupg

• 如果是使用MacPorts，则执行如下命令：

$ POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg

• 如果是使用Homebrew，则执行如下命令：

$ brew install gmake libsdl git gnupg2

2.4 下载Mac OS SDK

由于新版本的Mac OS更新(我这里是10.14.4 Mojave版本)，导致Android源码在编译时可能报如下错误：

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);

所以需要下载旧版本的Mac OS SDK，建议下载MacOSX10.11.sdk.tar.xz
版本，解压到自定义目录，然后建立软链接。例如我放在~/lib目录下，再给它创建一个软链接，可以避免下次Mac OS或Xcode升级的时候被删除：

$ sudo ln -s ~/lib/MacOSX10.11.sdk /Applications/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk

2.3 设置文件描述符数量上限

在 Mac OS 中，可同时打开的文件描述符的默认数量上限太低，在高度并行的编译流程中，可能会超出此上限。要提高此上限，请将下列行添加到 ~/.bash_profile 中：

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

至此，一切准备工作就绪，接下来就是下载源码的过程了。

3. 下载源码

3.1 说明

这里参考Google 教程。由于墙的原因，即使我们作为技术人员能翻过去，但使用起来可能还是有各种各样的问题，所以这里我们可以通过清华大学镜像站来下载。

3.2 下载安装Repo工具

由于Android源码庞大复杂，所以Google专门开发了Repo来管理Android源码库，这里不多作介绍，有兴趣可自行阅读repo工具介绍。

按照官方建议，首先在主目录下有一个 bin/ 目录，并且将该目录包含在路径中：

$ mkdir ~/bin
$ PATH=~/bin:$PATH

然后下载Repo工具，并确保它可执行：

$ curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo
$ chmod a+x ~/bin/repo

3.3 初始化 Repo 客户端

在2.2小节中，我们通过mountAndroid命令装载了我们分区后的磁盘映像，其装载路径为/Volumes/android，所以我们需要在该目录下进行初始化：

切换到该目录下，并且创建一个aosp的工作目录：

$ cd /Volumes/android/
$ mkdir aosp
$ cd aosp

现在，我们的源码根目录全路径为/Volumes/android/aosp。

Repo的运行过程中会尝试访问官方的git源更新自己，如果想使用清华的镜像源进行更新，可以将如下内容复制到你的~/.bashrc(没有该文件则创建一个)里：

export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'

然后配置git，需要姓名和邮箱：

$ git config --global user.name "Your Name"
$ git config --global user.email "you@example.com"

运行repo init来初始化master分支：

$ repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest

要对master以外的分支进行校验，请使用 -b 来指定相应分支。要查看分支列表，请参阅源代码标记和版本，笔者这里指定的是android-9.0.0_r35分支：

$ repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-9.0.0_r35

3.4 下载 Android 源代码树

在终端输入以下命令来下载源码：

$ repo sync

由于下载源码过程比较长，所以最好将你的Mac“系统偏好设置” -> “节能”里勾选上“防止进入睡眠”，如下图所示：

image

接下来就是漫长的等待过程了，30多g，带宽如果还可以的话，差不多不到两小时就下载完成了，会提示：

Syncing work tree: 100%(xxx/xxx), done.

4. 编译

编译命令还是在下载源码的目录下输入，即/Volumes/android/aosp。

4.1 切换bash

由于Android编译只能使用bash，所以你如果使用zsh等其它的shell，需要切换至bash，切换命令如下：

$ chsh -s /bin/bash

然后重启终端才能生效。

4.2 环境设置

使用envsetup.sh脚本初始化环境：

$ source build/envsetup.sh

4.3 选择编译目标

输入lunch，会提示如下：

$ lunch 

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. aosp_car_arm-userdebug
     8. aosp_car_arm64-userdebug
     9. aosp_car_x86-userdebug
     10. aosp_car_x86_64-userdebug
     11. mini_emulator_arm64-userdebug
     12. m_e_arm-userdebug
     13. m_e_mips-userdebug
     14. m_e_mips64-eng
     15. mini_emulator_x86-userdebug
     16. mini_emulator_x86_64-userdebug
     17. uml-userdebug
     18. aosp_crosshatch-userdebug
     19. aosp_blueline-userdebug
     20. aosp_cf_x86_auto-userdebug
     21. aosp_cf_x86_phone-userdebug
     22. aosp_cf_x86_tablet-userdebug
     23. aosp_cf_x86_tablet_3g-userdebug
     24. aosp_cf_x86_tv-userdebug
     25. aosp_cf_x86_wear-userdebug
     26. aosp_cf_x86_64_auto-userdebug
     27. aosp_cf_x86_64_phone-userdebug
     28. aosp_cf_x86_64_tablet-userdebug
     29. aosp_cf_x86_64_tablet_3g-userdebug
     30. aosp_cf_x86_64_tv-userdebug
     31. aosp_cf_x86_64_wear-userdebug
     32. cf_x86_auto-userdebug
     33. cf_x86_phone-userdebug
     34. cf_x86_tablet-userdebug
     35. cf_x86_tablet_3g-userdebug
     36. cf_x86_tv-userdebug
     37. cf_x86_wear-userdebug
     38. cf_x86_64_phone-userdebug
     39. cf_x86_64_tablet-userdebug
     40. cf_x86_64_tablet_3g-userdebug
     41. cf_x86_64_tv-userdebug
     42. cf_x86_64_wear-userdebug
     43. aosp_marlin-userdebug
     44. aosp_marlin_svelte-userdebug
     45. aosp_sailfish-userdebug
     46. aosp_walleye-userdebug
     47. aosp_walleye_test-userdebug
     48. aosp_taimen-userdebug
     49. hikey-userdebug
     50. hikey64_only-userdebug
     51. hikey960-userdebug

Which would you like? [aosp_arm-eng] 

这里列出了所有的可编译的目标。所有编译目标都采用 BUILD-BUILDTYPE 形式，其中 BUILD 是表示特定功能组合的代号，BUILDTYPE 是以下类型之一，表示在什么环境下运行：

比如aosp_arm-eng的BUILD为aosp_arm，BUILDTYPE为eng，aosp代表Android开源项目，arm表示系统是运行在arm架构的处理器上，更多见官方文档。

如果你有Pixel或Nexus真机，选择对应的编译目标即可，否则我们就选模拟器，即5.aosp_x86-eng。在上面的Which would you like? [aosp_arm-eng]后面输入5即可。也直接选择:

$ lunch 5

或

$ lunch aosp_x86-eng

4.4 编译代码

在编译之前，通过输入以下命令，可以查看你的Mac的CPU核数：

$ sysctl -n machdep.cpu.core_count
4

上面输出的CPU核数为4，则可以启动4个线程来编译源码：

$ make -j4

接下来就是漫长的编译过程，一般需要2~3个小时，如果看到下面的提示，则表示已经编译完成：

#### build completed successfully (02:15:52 (hh:mm:ss)) ####

4.5 运行模拟器

在编译完成后，终端里输入以下命令，便可使用模拟器来运行编译的版本：

$ emulator

5. Android Studio导入源码

5.1 编译idegen模块

编译完成之后，运行以下命令，编译idegen模块：

$ mmm development/tools/idegen/

idegen模块编译完成后会有如下提示：

#### make completed successfully (46 seconds) ####

此时继续运行下面的命令，会在aosp根目录生成对应的android.ipr、android.iml IDEA工程配置文件

$ development/tools/idegen/idegen.sh

Read excludes: 17ms
Traversed tree: 218013ms

5.2 导入源码

启动Android Studio，选择一个已存在的Android Studio项目，然后选中aosp根目录下的android.ipr文件，如果提示需要你convert，确认convert就行。首次导入大概需要20~30分钟：

image

导入成功后，在Project Structure中，选择Modules，删除所有的依赖，只保留下图所示。这样在查看源码跳转的时候，不会进入android.jar，会直接跳转至本项目的文件中。

image

现在你可以自由地阅读源码了，enjoy it！

image

参考

Google官方Android源码编译教程
清华大学开源软件镜像站 - Android 镜像使用帮助
macOS（Sierra 10.12）上Android源码（AOSP）的下载、编译与导入到Android Studio
Android AOSP基础（二）AOSP源码下载
Android AOSP基础（三）Android系统源码的整编和单编
使用Android Studio导入源码