MacOS 10.14编译Android源码

一、搭建编译环境

1、设置 Mac OS 编译环境
在默认安装过程中，Mac OS 会在一个保留大小写但不区分大小写的文件系统中运行。Git 并不支持此类文件系统，而且此类文件系统会导致某些 Git 命令（例如 git status）的行为出现异常。因此，我们建议您始终在区分大小写的文件系统中处理 AOSP 源文件。使用下文中介绍的磁盘映像可以非常轻松地做到这一点。

有了适当的文件系统后，在新型 Mac OS 环境中编译 master 分支就会变得非常简单。要编译较早版本的分支，则需要一些额外的工具和 SDK。

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

您可以使用磁盘映像在现有的 Mac OS 环境中创建区分大小写的文件系统。要创建磁盘映像，请启动磁盘工具，然后选择新建映像。完成编译至少需要 25GB 空间；更大的空间能够更好地满足未来的需求。使用稀疏映像有助于节省空间，而且以后可以随着需求的增加进行扩展。请务必选择 Case sensitive, Journaled 存储卷格式。

2、安装 Xcode 和其他软件包

(1)使用以下命令安装 Xcode 命令行工具：

xcode-select --install

对于较低版本的 Mac OS（10.8 或更低版本），您必须通过 Apple 开发者网站安装 Xcode。如果您尚未注册成为 Apple 开发者，则必须创建一个 Apple ID 才能下载。

(1)安装 Homebrew 以进行软件包管理。

a. Homebrew - /usr/local/bin：

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

b. 使用 Homebrew，发出：

brew install git gnupg2

(2)设置文件描述符数量上限

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

# set the number of open files to be 1024

 ulimit -S -n 1024

二、下载源代码

Android 源代码树位于由 Google 托管的 Git 代码库中。Git 代码库中包含 Android 源代码的元数据，其中包括对源代码进行的更改以及更改时间。本页介绍了如何下载特定 Android 代码流水线的源代码树。

1、安装 Repo

Repo 是一款工具，可让您在 Android 环境中更轻松地使用 Git。

要安装 Repo，请执行以下操作：

(1)、确保您的主目录中有一个 bin/ 目录，并且它包含在您的路径中：

mkdir ~/bin 

PATH=~/bin:$PATH

(2)、下载 Repo 工具，并确保它可执行：

curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo

chmod a+x ~/bin/repo

(如果下载不下来请自备提子或者选择清华镜像)

2、初始化 Repo 客户端

安装 Repo 后，设置您的客户端以访问 Android 源代码库：

(1)、创建一个空目录来存放您的工作文件。如果您使用的是 MacOS，必须在区分大小写的文件系统中创建该目录。为其指定一个您喜欢的任意名称：

mkdir WORKING_DIRECTORY 

cd WORKING_DIRECTORY

(2)、使用您的真实姓名和电子邮件地址配置 Git。要使用 Gerrit 代码审核工具，您需要一个与注册的 Google 帐号相关联的电子邮件地址。确保这是您可以用来接收邮件的有效地址。您在此处提供的姓名将显示在您提交的代码的提供方信息中。

git config --global user.name "Your Name" 

git config --global user.email "you@example.com"

(3)、运行 repo init 以获取最新版本的 Repo 及其最新的问题修复。您必须为清单指定一个网址，该清单用于指定 Android 源代码中包含的各个代码库将位于工作目录中的什么位置。

repo init -u https://android.googlesource.com/platform/manifest

要检出除 master 之外的其他分支，请使用 -b 指定此分支。要查看分支列表，请参阅源代码标记和细分版本。

repo init -u https://android.googlesource.com/platform/manifest -b android-9.0.0_r35

初始化成功后，系统将显示一条消息，告诉您 Repo 已在工作目录中完成初始化。您的客户端目录现在应该包含一个 .repo 目录，这是清单等文件的存放位置。

3、下载 Android 源代码树

要将 Android 源代码树从默认清单中指定的代码库下载到工作目录，请运行以下命令：

repo sync

Android 源代码文件位于工作目录中对应的项目名称下。初始同步操作需要 1 个小时或更长时间才能完成。要详细了解 repo sync 和其他 Repo 命令，请参阅使用 Android 代码。

三、编译 Android

1、设置环境
使用 envsetup.sh 脚本初始化环境。请注意，将 source 替换成 .（一个点）可以省去一些字符，这种简写形式在文档中更为常用。

source build/envsetup.sh 或者 . build/envsetup.sh

envsetup.sh 脚本导入了一些命令，可让您使用 Android 源代码，其中包括本练习中使用的命令。以下是一些重要的命令示例：

lunch - lunch product_name-build_variant 会选择“product_name”作为要编译的产品，并选择“build_variant”作为要编译的变体，然后将这些选择存储在可被后续对 m 和其他类似命令的调用读取的环境中。

m - 从树的顶部运行编译。这很有用，因为您可以在子目录中运行 make。如果您设置了 TOP 环境变量，它便会使用此变量。如果您未设置此变量，它便会从当前目录中查找相应的树，以尝试找到树的顶层。您可以通过运行不包含参数的 m 来编译整个源代码树，也可以通过指定相应名称来编译特定目标。

mma - 编译当前目录中的所有模块及其依赖项。

mmma - 编译提供的目录中的所有模块及其依赖项。

croot - cd 到树顶层。

2、选择目标

使用 lunch 选择要编译的目标。确切的配置可作为参数进行传递。例如，以下命令表示针对模拟器进行完整编译，并且启用所有调试功能.

lunch aosp_arm-eng

如果在没有参数的情况下运行，则 lunch 会提示您从菜单中选择目标。

3、编译代码

请使用 make 进行所有编译。make 可以使用 -jN 参数处理并行任务(N代表并行任务数，并不是越大越好，根据自己电脑cpu核心数*2)。如果您未提供 -j 参数，编译系统便会自动选择其认为对您的系统最佳的并行任务计数。

如上所述，您可以通过在 make 命令行中列出相应名称来编译特定模块，而不是编译完整的设备映像。此外，m 还针对各种特殊目的提供了一些伪目标。以下是一些示例：

droid - make droid 是正常编译。此目标在此处，因为默认目标需要名称。

all - make all 可以编译 m droid 能够编译的所有元素，以及没有 droid 标记的所有元素。编译服务器会运行此命令，以确保包含在树中且包含 Android.mk 文件的所有元素都会进行编译。

clean - make clean 可以删除此配置的所有输出文件和中间文件。这与 rm -rf out/ 相同。

运行 make help 即可查看 make 提供的其他伪目标。

4、模拟 Android 设备

emulator

四、以下是我在编译过程中踩的坑

1、下载Repo工具失败：

curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo chmod a+x ~/bin/repo

执行该命令下载失败或者超时，请自备梯子或者使用清华镜像

2、初始化Repo仓库失败

执行 repo init  

(1)执行该命令报错：

warning: gpg (GnuPG)isnotavailable.

warning: Installing itisstrongly encouraged.

请检查brew instal gnupg2 命令安装gnupg2是否成功

(2)执行命令报错：

fatal: Cannot get https://gerrit.googlesource.com/git-repo/clone.bundle

fatal: error [Errno 60] Operation timed out

修改~/bin/repo(用文本编辑器打开)

REPO_URL = 'https://gerrit.googlesource.com/git-repo'

修改为

REPO_URL = 'https://gerrit-googlesource.proxy.ustclug.org/git-repo'

(3)执行命令报错：

SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:581)

修改~/bin/repo(用文本编辑器打开)

添加以下代码(Python 升级到 2.7.9 之后引入了一个新特性，当你urllib.urlopen一个 https 的时候，会验证一次 SSL 证书）

import ssl

ssl._create_default_https_context = ssl._create_unverified_context

关闭证书验证

(4)执行该命令超时，请自备梯子或者使用清华镜像

建立工作目录:

mkdir WORKING_DIRECTORY

cd WORKING_DIRECTORY

初始化仓库:

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

如果需要指定某个版本，如下：

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

同步源码树（以后只需执行这条命令来同步）：

repo sync

2、编译报错

(1)、internal error: Could not find a supported mac sdk: ["10.10" "10.11" "10.12" "10.13"]

xcode最新版本自带是的MacOSX10.14.sdk，Google未支持到该版本，可以到 https://github.com/phracker/MacOSX-SDKs/releases 下载”10.10” “10.11” “10.12” “10.13”的其中一个sdk，解压后，放到/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs中，并且创建名为MacOSX10.12.sdk 的替身。

创建方式

sudo ln -s MacOSX10.12 MacOSX10.12.sdk

经测试我在10.14上使用MacOSX10.13.sdk报错未编译成功，但是使用MacOSX10.12.sdk编译成功

3、编译过程中报错：bash: xz: command not found

未安装XZ工具

在http://tukaani.org/xz/下载文件

(1)、解压

tar -zxf xz-5.2.4.tar.gz

(2)、编译

cd xz-5.2.4

./configure

make

make install

(3)、验证

xz -V

出现XZ版本号为成功

以上内容参考自https://source.android.google.cn/setup以及各位大佬的宝贵经验，感谢他们！！！