第0步：版本選擇
AOSP版本選擇很重要，如果選錯了，會造成編譯失敗等各種問題，編譯AOSP對Xcode的版本是有要求的；
比如：AOSP6.0-7.0，要求Xcode的版本是8.3，然而在MacOS 10.14上面是不支持Xcode8.3的這就很尷尬；
由於現在大家的Mac環境基本是更新到最新的10.14了，所以這里推薦大家選擇android-8.1.0_r1。
編譯環境：
- OS: macOS Mojave 10.14.4
- JDK: 1.8.0_144
- Xcode: 10.2.1
- XcodeSDK: 10.11
- AOSP: android-8.1.0_r15
- Git: 2.21.0
第一步：創建區分大小寫的磁盤映像
由於Mac OS的文件系統默認是不區分大小寫的，Git 並不支持此類文件系統，而且此類文件系統會導致某些 Git 命令（例如 git status）的行為出現異常，所以我們需要在區分大小寫的文件系統中對 AOSP 源文件進行操作。
通過 shell 使用以下命令創建磁盤映像：
# hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 150g ~/android.dmg
這里設置分配150g的大小，這將創建一個 .dmg（也可能是 .dmg.sparseimage）文件，該文件在裝載后可用作具有 Android 開發所需格式的存儲卷。
如果您以后需要更大的存儲卷，還可以使用以下命令來調整稀疏映像的大小：
# hdiutil resize -size <new-size-you-want>g ~/android.dmg.sparseimage
雙擊生成的.dmg.sparseimage文件，就會看到掛載的磁盤了，之后所有操作都在這個磁盤分區中進行，您可以像對待外接硬盤一樣將其彈出（卸載）。
如果你喜歡在命令行中掛載/卸載分區，可以向 ~/.bash_profile 中添加輔助函數：
# mount the android file image
function mountAndroid { hdiutil attach ~/android.dmg.sparseimage -mountpoint /Volumes/android; }
# unmount the android file image
function umountAndroid() { hdiutil detach /Volumes/android; }
注意文件名路徑是否一致，要使.bash_profile配置生效，需要：
# source ～/.bash_profile
之后你就可以在命令行中通過mountAndroid和unmountAndroid來操作了。
第二步：安裝所需的程序包
安裝 Xcode 命令行工具：
一般在安裝Xcode的時候會自動安裝命令行工具，這里保險起見，檢查一下：
# xcode-select --install
通過 macports.org 安裝 MacPorts。
將以下內容添加到～/.bash_profile中
export PATH=/opt/local/bin:$PATH
通過 MacPorts 獲取 Make、Git 和 GPG 程序包：
# POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg
如果您使用 Mac OS X v10.4，還需要安裝 bison：
# POSIXLY_CORRECT=1 sudo port install bison
設置文件描述符數量上限
在 Mac OS 中，可同時打開的文件描述符的默認數量上限太低，在高度並行的編譯流程中，可能會超出此上限。
要提高此上限，請將下列行添加到 ~/.bash_profile 中：
# set the number of open files to be 1024
ulimit -S -n 1024
第三步：下載源代碼
安裝Repo
Repo 是一款工具，可讓您在 Android 環境中更輕松地使用 Git.
直接運行下面的命令：
# curl https://storage.googleapis.com/git-repo-downloads/repo > ~/repo
會在主目錄下生成repo文件，接着給他賦予可執行的權限：
# chmod a+x ~/repo
為了可以方面的使用repo命令，我們把它移動到/opt/local/bin里面,因為這個路徑我們在上一步中已經加入到PATH了，所以我們可以在任何一個地方執行repo命令；
# mv ~/repo /opt/local/bin
同步源碼
進入第一步中創建好的分區，建立工作目錄：
# mkdir aosp
# cd aosp
repo的運行過程中會嘗試訪問官方的git源更新自己，如果想使用tuna的鏡像源進行更新，可以將如下內容復制到你的~/.bash_profile里：
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，這里采用清華大學的鏡像，並設置分支android-8.1.0_r15：
#repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.1.0_r15
最后一步：
# repo sync
源碼同步過程中常常會因為網絡因素而斷開，如果斷開了繼續執行repo sync命令即可，直到下載完成。
漫長的等待......
下載完成后差不多占用70G大小，因為我們后續不需要再進行分支切換與同步，所以我們可以把目錄下的.repo文件夾給刪除了，畢竟Mac的SSD容量寶貴，刪除之后你會發現硬盤大小沒有釋放，這就有點尷尬了，這個問題目前也沒找到解決的辦法，我的方法是按照第一步創建一個新的分區，把內容拷貝進去，然后把舊的分區刪了，這樣空間就釋放了。
編譯源碼
優化編譯環境 設置 ccache
要使用 ccache，請在源代碼樹的根目錄下執行以下命令：
#export USE_CCACHE=1
#export CCACHE_DIR=/<path_of_your_choice>/.ccache
#prebuilts/misc/darwin-x86/ccache/ccache -M 50G
注意<path_of_your_choice>是你源碼下載的根目錄。
最后請將以下內容添加到 .bash_profile（或等同文件）中：
export USE_CCACHE=1
配置ANDROID_JAVA_HOME環境變量
在~/.bash_profile中添加以下內容，前提必須是安裝了JDK1.8：
export ANDROID_JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
設置XcodeSDK的版本
執行以下命令，打開配置文件：
# vi build/soong/cc/config/x86_darwin_host.go
查看darwinSupportedSdkVersions，這里列出了支持的sdk版本：
darwinSupportedSdkVersions = []string{
"10.10",
"10.11",
"10.12",
}
接着我們進入以下目錄查看現有的XcodeSDK版本：
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
這里我們選擇10.11的版本，如果沒有MacOSX10.11.sdk則去MacOSX-SDKs 中下載一個，解壓到該目錄，並把其他版本的刪除，確保只保留一個就行了。
開始編譯
首先要把shell切換到bash（如果你使用的是zsh）
#chsh -s /bin/bash
初始化環境：
#source build/envsetup.sh
選擇編譯的分支：
#lunch
會出現以下列表：
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
... ...
Which would you like? [aosp_arm-eng]
要求輸入對應的數字：
如果你想在你的Nexus上設備運行,請參照官方設備對應列表選擇；
如果你只想在本機的虛擬機上運行，Mac系統的話選擇aosp_x86-eng即可。
最后一步，編譯：
#make -j6
通過-jN參數來設置編譯的並行任務數，以提高編譯速度，在此前我的CPU核心數為6，這里N值最好選在6到12之間，這里我們設置6個並行任務進行編譯。
這里需要注意的是，每次退出再進入命令行要執行以上命令之前，都要先執行：
#source build/envsetup.sh
編譯中遇到的問題
問題1：Jack編譯報錯:communication error with Jack server
原因：JACK編譯器不支持多用戶同時編譯，其他用戶在編譯，端口被占用。
解決方法：
如下：修改以下兩個配置文件中的端口號server.service.port和server.admin.port，比如都改為8096/8097：
- ~/.jack-settings
- ~/.jack-server/config.properties
注意：
兩個文件中的端口號必須一致。
修改后的端口號必須是沒有被使用的。
問題2: 出現Try increasing heap size with java option '-Xmx'
原因： 出現這個錯誤是由於電腦內存不足；
解決方法：在命令行分別執行以下三條語句，然后繼續編譯；
# export JACK_SERVER_VM_ARGUMENTS="-Dfile.encoding=UTF-8 -XX:+TieredCompilation -Xmx4g"
# ./prebuilts/sdk/tools/jack-admin kill-server
# ./prebuilts/sdk/tools/jack-admin start-server
問題3: BISON_PKGDATADIR=external/bison/data prebuilts/misc/darwin-x86/bison/bison -d
在log中出現BSION等字樣；
原因：網上說這個bsion的一個bug；
解決方法：拉取新的分支，重新編譯 bison：
#cd external/bison
#git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160
如果這步驟發生錯誤了(比如之前刪除了.repo文件夾)
這時候我們就把bison這個文件夾刪除，下載一個新的：
wget https://android.googlesource.com/platform/external/bison/+archive/c0c852bd6fe462b148475476d9124fd740eba160.tar.gz
解壓后進入bison文件夾，執行：
# mm
# cp out/host/darwin-x86/bin/bison prebuilts/misc/darwin-x86/bison/
結束
最后一切順利的話，經過漫長的編譯后，最終會出現以下畫面則說明編譯Android系統成功了。
