1.3　Android源码下载和编译

Android源码的开发需要Linux环境，读者可以安装Ubuntu 10.04及其后续版本，推荐安装Ubuntu的10.04或者12.04这两个LTS（长期技术支持）版本。本书基于Jelly Bean（Android 4.1）分析源代码，该部分源代码的编译需要64位操作系统环境。本节将介绍如何在Ubuntu 12.04（LTS）-64bit上搭建Android源码开发所需环境，这是保障后续步骤能够顺利进行的前提条件，必须准确无误。Android源码分成上层系统源码和Linux Kernel两部分，需要分别下载。

注意　Android Jelly Bean源码超过6GB，编译至少需要25GB空间，应确保有足够的磁盘空间。

1.3.1　搭建开发环境

Android Jelly Bean的编译依赖Sun JDK 1.6，由于Ubuntu默认使用Open JDK，所以需要首先安装JDK 1.6。

步骤1　更新Ubuntu JDK软件源。在终端执行如下命令：

$ sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
$ sudo apt-get update

步骤2　安装JDK 1.6。在终端执行如下命令：

$ sudo apt-get install sun-java6-jdk

步骤3　安装必需的开发包。在终端执行以下命令：

$ sudo apt-get install git-core gnupg flex bison gperf build-essential \
zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev \
libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 \
libgl1-mesa-dev g++-multilib mingw32 openjdk-6-jdk tofrodos \
python-markdown libxml2-utils xsltproc zlib1g-dev:i386
$ sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so

注意　“”在Ubuntu 终端中会被解释成换行符。

各个安装包的主要作用如表1-5所示。

注意　如果读者想进一步了解上述安装包的作用，可以到Ubuntu网站（http://packages.ubuntu.com/）查询。

到此为止，源码开发环境已经准备完毕，可以开始下载源码了。

1.3.2　下载Android上层系统源代码

Android用repo和git管理源代码。

git是Linux之父 Linus Torvalds 为了管理 Linux 内核开发而开发的一个开放源码的分布式版本管理软件，它与 SVN、CVS这样的集中式版本管理软件有很大不同。在集中式版本管理软件中多个客户端共享一个仓库（repository），而在git这样的分布式版本管理软件中，每一个客户端都包含一个完整仓库，客户端可以离线操作，本地提交可以稍后再提交到服务器上。

Android是由kernel、dalvik、bionic、prebuilt、frameworks等多个git库组成，为了方便使用， Android项目提供了一个名为repo的Python的脚本来统一管理这些git仓库。
Android源代码分成两部分，其中Kernel部分需要单独下载。这里先讲解上层系统源码的下载流程。这部分代码非常庞大，下载时间需要数小时以上。

步骤1　建立repo工作目录。
$ mkdir ~/bin （在主目录下创建bin目录，~在Ubuntu下代表主目录）
$ PATH=~/bin:$PATH （将bin目录加入PATH环境变量）

步骤2　下载repo脚本。

$ curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo

                (下载repo脚本到bin目录）

$ chmod a+x ~/bin/repo （给repo脚本可执行权限）

步骤3　建立Android源码目录。

$mkdir –p ~/android/jellybean （建立jellybean目录存放Android 4.1源代码）
$cd ~/android/jellybean （切换到jellybean目录下）

步骤4　初始化repo。

allong@android:~/android/jellybean $ repo init
-u https://android.googlesource.com/platform/manifest -b android-4.1.1_r3

其中，-u为源码的git服务器地址，-b为源码的某个分支。

如果读者不清楚源码服务器上的分支情况，可以执行“git ls-remote”命令查看远程服务器都有哪些分支，然后选择较新分支下载。命令如下：

allong@android:~/android/jellybean $ git ls-remote

            –tags https://android.googlesource.com/platform/manifest 
            

git ls-remote命令可以查看远程服务器上的branch列表。执行后显示内容如下：

1db98b3dedca5ab8b6eeefc5a7a98720e73fefdf refs/tags/android-2.3.7_r1
……
500aaaa87f49fddc1c7ca5066eebb2e03fdd14ac refs/tags/android-4.0.3_r1
……
可以通过tags后面的值判断有哪些branch可供下载。本书基于Android 4.1.1，所以传给-b参数的值取为“android-4.1.1_r3”。

注意　目录 refs 包含heads 和 tags两个子目录，其中存放了不同分支的头的索引，可以通过索引查看有哪些branch。如果没有指定-b，将下载Android主线（master默认分支）上最新版本的源代码，但这部分代码往往是不稳定的。

步骤5　下载Android源码。

初始化repo后，如果要下载Android源码，只需要进入源码根目录，然后在终端执行以下命令：
allong@android:~/android/jellybean$ repo sync

这个过程将从服务器同步源码，需要花费几个小时的时间。可以通过“repo sync –j8”命令开启并行下载，8是开启8线程。读者可根据主机情况自行调整参数。

1.3.3　下载指定模块源码

Android全部源码十分庞大，如果只需要下载部分源码，可以单独指定模块名称，这样可以节省大量时间。本节将介绍如何下载指定项目，步骤如下。

步骤1　查看都有哪些模块可以下载，在终端中执行以下命令：
allong@android:~/android/jellybean$ repo manifest -o -

执行后将显示如下信息：

…… （省略部分信息）

path="packages/wallpapers/HoloSpiral"/>
path="packages/wallpapers/LivePicker"/>

…… （省略部分信息）

……（省略部分信息）

其中，name表示项目模块的名称以及在源码服务器上的相对路径，path表示项目的本地路径。

注意　repo manifest -o - 命令读取的是本地源码根目录（笔者的本地源码目录是~/android/jellybean）下的.repo/manifests/default.xml文件，读者可以直接打开该文件，也可以得到同样的项目信息。

步骤2　将项目模块名指定给repo sync。

知道了有哪些项目模块可以单独下载，只需要将项目模块名指定给repo sync即可。例如，要下载platform/system/core项目，只需运行以下命令：
allong@android:~/android/jellybean$ repo sync platform/system/core

1.3.4　下载 Android Linux Kernel 源码

Kernel部分的源码没有采用repo工具管理，可以直接通过git工具下载，步骤如下。
步骤1　进入Android源码根目录。

笔者机器上的根目录是~/android/jellybean，建立kernel目录命令如下：
cd ~/android/jellybean
mkdir kernel
cd kernel

步骤2　下载Kernel源码。

读者可以在终端中执行以下任一条命令，下载Android Kernel部分源码。这里选择common.git通用版下载，其余是针对特定处理器的版本。

$ git clone https://android.googlesource.com/kernel/common.git
$ git clone https://android.googlesource.com/kernel/goldfish.git
$ git clone https://android.googlesource.com/kernel/msm.git
$ git clone https://android.googlesource.com/kernel/omap.git
$ git clone https://android.googlesource.com/kernel/samsung.git
$ git clone https://android.googlesource.com/kernel/tegra.git

步骤3　检出Kernel 3.0 分支。

由于Android Jelly Bean使用的是Linux 3.0内核，所以还需要切换到Kernel 3.0 分支。
$ cd common //进入common版内核的下载路径
$ git branch -a //查看都有哪些分支
$ git checkout remotes/origin/Android-3.0??//检出Kernel 3.0分支?

1.3.5　编译Android上层系统源码

一般来讲，源码下载后就可以直接学习Android源代码了。但这样无法调试源码，也无法得知源码编译后生成的文件是什么。所以这里继续讲解Android源代码的编译流程，步骤如下。

步骤1　导入预设脚本。在终端中执行以下命令：

allong@android:~/android/jellybean$ . build/envsetup.sh
注意　.后面有空格，“.”在Shell中是指令，使用方式是 “. filename”，作用是从filename中读取指令并执行。读者也可以用 “source build/envsetup.sh”代替，作用是一样的。

步骤2　指定产品名和编译变量。在终端中执行以下命令：

allong@android:~/android/jellybean$ lunch
You're building on Linux
Lunch menu... pick a combo:

1. full-eng
2. full_x86-eng
3. vbox_x86-eng
4. full_stingray-userdebug
……（省略部分内容）

Which would you like? [full-eng] 1 （输入1）

注意　lunch是envsetup.sh脚本中提供的函数，负责设置一些环境变量，比如TARGET_PRODUCT、TARGET_BUILD_VARIANT等。

　　　full表示完全编译，eng表示工程版。full-eng对应模拟器设备。

步骤3　编译全部源码。在终端中执行以下命令：

allong@android:~/android/jellybean$ make -j8 （开启8线程开始编译）
编译全部源码十分耗时，但这也是必需的，只能等待。下一节将讲解如何编译指定模块。

1.3.6　编译指定模块源码

实际开发中，并不需要每次都编译所有源代码，只需要编译自己修改的模块即可。Android的编译系统提供了强大的机制支持单独模块的编译，而且十分简单。Android提供三种方式用于编译单独模块：

make 模块名
mm 来自于envsetup.sh脚本中注册的函数
mmm来自于envsetup.sh脚本中注册的函数
下面将分别介绍这三种方法。

1．make 模块名
这种方法适合第一次编译，会把依赖模块一并编译。它需要在全部源代码中找到编译模块的Android.mk文件，并检查依赖模块是否有修改，因此编译时间较长。使用这种方法，我们只需要搜索源码目录下的Android.mk文件，找到模块名，然后指定给make即可。

（1）编译应用层源码

对于应用层程序，需要查看Android.mk文件的LOCAL_PACKAGE_NAME变量。
例如，要编译Phone应用程序的源码，先查看Phone的Android.mk文件，在终端中运行以下命令：
allong@android:~/android/jellybean$ cat packages/apps/Phone/Android.mk
显示Android.mk的内容如下：

……（省略部分内容）

LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := com.android.phone.common

……（省略部分内容）

LOCAL_PACKAGE_NAME := Phone

……（省略部分内容）

找到LOCAL_PACKAGE_NAME字段，其值便是我们需要得到的编译参数，即Phone。得到编译参数后，在终端中运行如下命令便可单独编译Phone模块及其依赖模块：

allong@android:~/android/jellybean$make Phone

（2）编译框架层和系统运行库源码

对于框架层和系统运行库，需要查看LOCAL_MODULE变量。

以frameworks包中的源码为例，在终端中运行以下命令：

allong@android:~/android/jellybean$ find frameworks -name Android.mk

该命令将搜索frameworks目录下所有的Android.mk文件，列表如下：

frameworks/media/libvideoeditor/lvpp/Android.mk
frameworks/media/libvideoeditor/osal/src/Android.mk
frameworks/base/cmds/app_process/Android.mk
……（省略其他部分）

以app_process为例，在终端中运行以下命令：

allong@android:~/android/jellybean$ cat
frameworks/base/cmds/app_process/Android.mk
显示Android.mk的内容如下：
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE:= app_process
include $(BUILD_EXECUTABLE)

LOCAL_MODULE变量的值便是我们要找的模块名。在终端中运行以下命令：
allong@android:~/android/jellybean$make app_process

2．mmm命令

该命令是envsetup.sh中注册的函数，用于在源码根目录编译指定模块，参数为模块的相对路径。只能在第一次编译后使用。比如要编译Phone部分源码，需要在终端中执行以下命令：
allong@android:~/android/jellybean$mmm packages/apps/phone

3．mm命令

该命令也是envsetup.sh中注册的函数，用于在模块根目录编译这个模块。只能在第一次编译后使用。例如要编译Phone部分源码，需要在终端中执行以下命令：

allong@android:~/android/jellybean$cd packages/apps/phone
allong@android:~/android/jellybean/packages/apps/phone$mm
注意　mmm和mm命令必须在执行“.build/envsetup.sh”之后才能使用，并且只编译发生变化的文件。如果要编译模块的所有文件，需要-B选项，例如mm -B。