【Android】AOSP源码下载及编译 for mac

本文记录了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

回车后即可进行安装，首次可能会出现更新的问题，需要根据其给出的提示进行相应的操作。

当然如果用其他包管理器可以下载到 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 中有讨论到。