• macOS High Sierra 版本 10.13.4
• Xcode 9.3
• aosp分支：android-8.1.0_r20

準(zhǔn)備編譯環(huán)境

具體參考官方文檔

1. 安裝 jdk8u45 or newer
2. 安裝xcode命令行

xcode-select --install

3. 安裝編譯需要用到的其他包
   使用Homebrew安裝(官方文檔使用的是MacPorts)

brew install gmake libsdl git gnupg

NOTE: gmake 可以不用安裝，使用xcode自帶的就可以

4. 設(shè)置可以同時(shí)打開(kāi)的文件數(shù)限制，避免編譯時(shí)超出限制
   在 ~/.bash_profile 添加如下語(yǔ)句

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

5. 創(chuàng)建區(qū)分大小寫(xiě)的APFS宗卷
   官方文檔創(chuàng)建的是區(qū)分大小寫(xiě)HFS+磁盤(pán)鏡像，我們這邊使用區(qū)分大小寫(xiě)的APFS卷宗
   
   APFS宗卷描述.png

   1. 打開(kāi)磁盤(pán)工具按下圖步驟操作：

      
      
      添加APFS卷宗.png
   2. 設(shè)置宗卷大小
      具體大小根據(jù)自己情況設(shè)定，配額大小最好不要小于200G
      
      設(shè)置APFS卷宗大小.png

下載源碼

具體參考官方文檔-下載源碼。
本文使用清華大學(xué)aosp鏡像下載源碼，具體步驟參考清華大學(xué)aosp鏡像提供的教程。

1. 下載repo

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

在~/.bash_profile中將剛才創(chuàng)建的~/bin目錄添加進(jìn)PATH中

export PATH=~/bin:$PATH

2. 建立工作目錄

mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY

3. 初始化倉(cāng)庫(kù)
   指定master分支

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

若要指定android版本，如下：

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.1.0_r20

4. 同步源碼樹(shù)
   repo sync 或者 repo sync -j4 # 指定并發(fā)數(shù)
   NOTE: repo sync有時(shí)會(huì)失敗，可能要運(yùn)行多次，才能同步完源碼，可以使用以下循環(huán)腳本：

#!/usr/bin/env bash
repo sync -j4
while [ $? -ne 0 ]
do
    repo sync -j4
done

編譯源碼

具體參考官方文檔-編譯源碼

source build/envsetup.sh
lunch aosp_x86_64-eng # 或者直接運(yùn)行l(wèi)unch， 在出現(xiàn)的選項(xiàng)中選擇編譯目標(biāo)
make -j8 # 根據(jù)cpu核心數(shù)（物理線(xiàn)程）選擇并發(fā)數(shù)，公式：并發(fā)數(shù)=cpu核心數(shù)（物理線(xiàn)程） x 2

編譯過(guò)程比較漫長(zhǎng)，在我的機(jī)子上大概用了2個(gè)多小時(shí)

編譯遇到的問(wèn)題

1. mac sdk10.13 不支持編譯，如下：
   internal error: Could not find a supported mac sdk: ["10.10" "10.11" "10.12"]

[44/44] bootstrap out/soong/.minibootstrap/build.ninja.in
[4/4] out/soong/.bootstrap/bin/minibp out/soong/.bootstrap/build.ninja
[860/861] glob external/clang/utils/TableGen/Android.bp
[54/54] out/soong/.bootstrap/bin/soong_build out/soong/build.ninja
FAILED: out/soong/build.ninja
out/soong/.bootstrap/bin/soong_build -t -b out/soong -d out/soong/build.ninja.d -o out/soong/build.ninja Android.bp
internal error: Could not find a supported mac sdk: ["10.10" "10.11" "10.12"]
ninja: build stopped: subcommand failed.
20:24:32 soong failed with: exit status 1

解決方法
修改AOSP/build/soong/cc/config/x86_darwin_host.go文件，添加10.13支持，如下

darwinSupportedSdkVersions = []string{
    "10.10",
    "10.11",
    "10.12",
    "10.13", // 添加mac sdk 10.13
}

2. 遇到bison錯(cuò)誤

FAILED: out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.c out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.h
BISON_PKGDATADIR=external/bison/data prebuilts/misc/darwin-x86/bison/bison -d --defines=out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.h -o out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.c external/selinux/checkpolicy/policy_parse.y

解決方法
為bison打補(bǔ)丁，重新編譯(Patch bison fix for High Sierra and build bison:)：

cd AOSP/external/bison
git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160
mm
cp AOSP/out/host/darwin-x86/bin/bison AOSP/prebuilts/misc/darwin-x86/bison/

將源碼導(dǎo)入IntelliJ IDEA

導(dǎo)入IDEA前 - 配置

1. 運(yùn)行如下命令，生成IDE工程信息文件 android.ipr 和 android.iml

source build/envsetup.sh # 在新終端下需要執(zhí)行這一步
mmma development/tools/idegen
development/tools/idegen/idegen.sh

2. 由于aosp工程很大，在導(dǎo)入IDEA前需要先修改配置：
   1. 修改VM內(nèi)存大小
      打開(kāi)IDEA 菜單欄 Help > Edit Custom VM Options，添加

-Xms1g 
-Xmx5g

2. 修改文件大小限制，打開(kāi)區(qū)分大小寫(xiě)選項(xiàng)
   打開(kāi)IDEA 菜單欄 Help -> Edit custom properties， 添加

idea.max.intellisense.filesize=100000
idea.case.sensitive.fs=true

NOTE: 重啟IDEA使配置生效

3. 用IDEA找到AOSP目錄下的android.ipr文件，打開(kāi)AOSP工程，耐心等待，索引需要一定時(shí)間

導(dǎo)入IDEA后 - 配置

1. 創(chuàng)建SDK 1.8 (No Libraries)，確保代碼跳轉(zhuǎn)到是aosp源碼，而不是系統(tǒng)安裝的JDK，如下
   NOTE 注意要?jiǎng)h掉Classpath里面所有的jar
   
   創(chuàng)建JDK1.8 (No Libraries).png
2. 刪除Modules中的dependencies，只保留<Module source> 和 1.8 (No Libraries)
   
   刪除Modules中的dependencies.png
3. 將生成的資源文件ID目錄out/target/common/R添加進(jìn)源碼目錄，避免R資源索引找不到，如圖：
   
   添加資源文件R進(jìn)源碼目錄.png

最后 Synchronize 整個(gè)工程同步下(打開(kāi)IDEA菜單 File -> Synchronize)，稍稍等待后就可以愉快的閱讀Android源碼了。