本文记录了AOSP在Mac系统上下载和编译的过程。
采用的系统是 macOS 10.13.1
所使用的AOSP分支是 android-8.1.0_r7
系统预留空间 大于200G
一. 环境配置
环境配置，官网给出了非常全的教程：Build Environment
对于Mac用户来说，需要配置的相对也不会很多
1. 创建大小写敏感文件系统
AOSP源码编译需要一个大小写敏感的文件系统环境，所以我们自己需要创建一个。打开Terminal，输入
hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 150g ~/android.dmg
上面的150g就是我们创建的文件系统的可用大小，android.dmg就是我们创建的文件系统镜像，其存放的目录可以在任何地方，这里我们暂时制定在用户根目录下。之后找到该文件双击后，就可以将其挂载到系统文件系统中。我们可以在Finder左侧看到新挂载的文件系统。
另外对于创建好的镜像文件，我们也可以重新分配其大小
hdiutil resize -size <newsize>g ~/android.dmg
2.安装JDK
对于Mac用户来说我们系统自带了Open JDK7，不过如果编译的是7.0以上的android系统的话，则需要Open JDK 8 的环境，所以我们自己需要下载安装，我们可以到官网选择需要的版本进行下载Java官网
下面列出Android版本与JDK的对应关系：
Android 7.0 (Nougat) - Android 8.0 (O release): Ubuntu - OpenJDK 8, Mac OS - jdk 8u45 or newer
Android 5.x (Lollipop) - Android 6.0 (Marshmallow): Ubuntu - OpenJDK 7, Mac OS - jdk-7u71-macosx-x64.dmg
Android 2.3.x (Gingerbread) - Android 4.4.x (KitKat): Ubuntu - Java JDK 6, Mac OS - Java JDK 6
Android 1.5 (Cupcake) - Android 2.2.x (Froyo): Ubuntu - Java JDK 5
3.安装Repo
Repo是AOSP中用于下载和管理源码的工具，也可以将其看成是git的上层管理控制工具。我们可以通过Terminal进行下载，
mkdir ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/
repochmod a+x ~/bin/repo
之后我们需要将repo配置到环境变量中，打开 ~/.bash_profile,我们将以下代码加入到文件最后一行
PATH=~/bin:$PATH
重新打开Terminal，我们输入repo后可以看到配置成功。
4. 安装XCode
Xcode为AOSP提供Native编译环境，对于Xcode的安装我们可以直接通过App Store进行安装，目前Xcode版本为9.x，SDK版本为10.13，不过对于8.x版本的Android源码来说，该版本有点高，我们需要在完成Xcode的安装后再下载一个低版本的SDK，我们可以到这里去下载：MacOSX SDK下载，我们可以下载MacOSX10.12.sdk.tar.xz
下载完成之后，Terminal输入
tar -jxvf MacOSX10.12.sdk.tar.xz
进行解压，可以获得一个MacOSX10.11.sdk的目录，之后我们通过Finder，在应用程序中找到我们Xcode，右键显示包内容，进入到Xcode里面，之后将我们刚解压出来的文件放到Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs目录下。
安装Xcode command line tools
xcode-select --install
5. 其他依赖库安装
官方推荐用MacPorts来安装，需要从MacPorts官网安装一个MacPorts，MacPorts官网，安装完之后将其配置到环境变量之中，也就是将export PATH=/opt/local/bin:$PATH配置到～/.bash_profile最后一行。
之后安装 gmake libsdl git gnupg bison，通过Terminal输入
POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg bison
回车后即可进行安装，首次可能会出现更新的问题，需要根据其给出的提示进行相应的操作。
如果出现Port gmake not found的错误的话，可以先执行
sudo port -d sync
当然如果用其他包管理器可以下载到 gmake libsdl git gnupg bison 的话也是可以的。
二. AOSP源码下载
对于在国内的开发者来说，使用国内的镜像站下载源码是个不错的选择，我们这里推荐清华镜像站
其为我们提供了初始化包的下载方式，一开始我们可以不需要使用repo进行拉取代码，对于这个初始化包我们有两种下载方式：
一种是使用其官网提供的方法，首先打开终端Terminal，定位到需要存放源码的目录，输入
wget -c https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar # 下载初始化包
按回车后，就会从镜像站下载资源包，需要注意的是，这个包大小有40多G，所以下载过程需要花费非常漫长的时间，另外不支持断点续传。
另外一种下载方式是使用第三方下载器，比如使用迅雷，直接在下载地址中输入https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar，即可进行下载。
这里推荐使用第二种方式，主要是速度快，而且支持断点续传，非常方便。下载完成之后，我们会获得一个aosp-latest.tar的文件，这是源码的压缩包。
三. 代码同步更新
我们将aosp-latest.tar放到大小写敏感的文件系统中，使用tar命令进行解压
tar xf aosp-latest.tar
cd AOSP
可以获得一个AOSP目录，里面包含一个隐藏的.repo目录，我们需要将镜像站的地址更新到里面的配置文件中。打开.repo/manifest.xml，找到里面的
<remote name="aosp"
fetch="https://android.googlesource.com"
review="android-review.googlesource.com"/>
将 fetch="https://android.googlesource.com" 改成 fetch="https://aosp.tuna.tsinghua.edu.cn"
另外，打开.repo/manifests.git/config，将url = https://android.googlesource.com/platform/manifest 修改为url = https://aosp.tuna.tsinghua.edu.cn/platform/manifest。
做完这些之后，我们将Terminal定位到AOSP目录，输入
repo sync
注意：使用清华镜像的需要注意的是，因为我们有修改manifest文件，而.repo整个文件也是通过git进行管理的，所以首次sync会提示文件没有commit，所以需要先到.repo目录下执行git 的 add、commit操作。
sync操作需要一个漫长到等待过程，成功后就可以在AOSP目录看到最新的源码资源。
使用Repo一个比较好的地方是，即使更新中途断网了也没关系，因为其有记忆功能，重新输入该命令，会跳过已经更新的资源。
四. 查看和切换分支
在AOSP目录下，我们可以用repo来查看当前所有可切换的分支，输入
cd .repo/manifests
git branch -a | cut -d / -f 3
可以列出所有的分支
从中选择android-8.1.0_r7，进行切换，切换的命令如下
repo init -b android-8.1.0_r7
repo sync
之后花费一些时间等待切换即可。
五. 编译
编译需要执行一下几个过程
1. 进入到AOSP目录，执行
make clobber
这会清除之前的缓存文件。
2. 之后执行
source build/envsetup.sh
初始化一些环境变量
3. 接下来输入
lunch aosp_arm-eng
选择目标编译版本。
如果不想使用该版本的话，我们可以直接输入lunch，其会提示所有的可以编译的版本。
4. 编译
make -j4
输入该命令后就会开始执行编译，整个过程会持续1～2个小时，请耐心等待。
六. 运行
直接在AOSP目录下运行
emulator
七. 问题记录处理
1. bison bug
我们在编译的时候可能会遇到的一个问题，这是AOSP源码里面的一个问题，解决方法是通过Terminal
cd external/bison
git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160
mm
完成后回到AOSP目录执行
cp out/host/darwin-x86/bin/bison prebuilts/misc/darwin-x86/bison/
之后执行make -j4就能正常编译
该问题在 https://groups.google.com/forum/#!msg/android-building/D1-c5lZ9Oco/hPBVZ0ElEAAJ 中有讨论到。
