Android源码编译的全过程记录

写本篇文章主要参考了官方文档和网上的一些资料，但是对于Android最新的代码来说，网上资料有些已经过时。本文中步骤已经作者实验，大家可以亲自执行试试。由于没有使用Eclipse的习惯，所以没有做Eclipse的相关配置。

编译环境：ubuntu9.10，widnows平台目前不被支持。

1）安装必要的软件环境

$ sudo apt-get install git-core gnupg sun-java5-jdk flex bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev

官方推荐的就是上面这些，如果在编译过程中发现某些命令找不到，就apt-get它。可能需要的包还有：

$ sudo apt-get install make
$ sudo apt-get install gcc
$ sudo apt-get install g++
$ sudo apt-get install libc6-dev

$ sudo apt-get install patch
$ sudo apt-get install texinfo

$ sudo apt-get install zlib1g-dev
$ sudo apt-get install valgrind
$ sudo apt-get install python2.5（或者更高版本）

需要注意的是，官方文档说如果用sun-java6-jdk可出问题，得要用sun-java5- jdk。经测试发现，如果仅仅make（make不包括make sdk），用sun-java6-jdk是没有问题的。而make sdk，就会有问题，严格来说是在make doc出问题，它需要的javadoc版本为1.5。

因此，我们安装完sun-java6-jdk后最好再安装sun-java5-jdk，或者只安装sun-java5-jdk。这里sun-java6-jdk和sun-java5-jdk都安装，并只修改javadoc.1.gz和javadoc。因为只有这两个是make sdk用到的。这样的话，除了javadoc工具是用1.5版本，其它均用1.6版本：

$ sudo apt-get install sun-java6-jdk

修改javadoc的link：

$ cd /etc/alternatives
$ sudo rm javadoc.1.gz
$ sudo ln -s /usr/lib/jvm/java-1.5.0-sun/man/man1/javadoc.1.gz javadoc.1.gz
$ sudo rm javadoc
$ sudo ln -s /usr/lib/jvm/java-1.5.0-sun/bin/javadoc javadoc

 2）设置环境变量

$ emacs ~/.bashrc

在.bashrc中新增或整合PATH变量，如下：

#java 程序开发/运行的一些环境变量

JAVA_HOME=/usr/lib/jvm/java-6-sun
JRE_HOME=${JAVA_HOME}/jre
export ANDROID_JAVA_HOME=$JAVA_HOME
export CLASSPATH=.:${JAVA_HOME}/lib:$JRE_HOME/lib:$CLASSPATH
export JAVA_PATH=${JAVA_HOME}/bin:${JRE_HOME}/bin
export JAVA_HOME;
export JRE_HOME;
export CLASSPATH;
HOME_BIN=~/bin/
export PATH=${PATH}:${JAVA_PATH}:${HOME_BIN};

保存后，同步更新：

source ~/.bashrc

3）安装repo（用来更新android源码）

创建~/bin目录，用来存放repo程序，如下：

$ cd ~
       $ mkdir bin

并加到环境变量PATH中，在第2步中已经加入。

下载repo脚本并使其可执行：

$ curl http://android.git.kernel.org/repo >~/bin/repo
       $ chmod a+x ~/bin/repo

4）初始化repo

repo是android对git的一个封装，简化了一些git的操作。

创建工程目录：

$ mkdir android
       $ cd android

repo初始化：

$ repo init -u git://android.git.kernel.org/platform/manifest.git

在此过程中需要输入名字和email地址。初始化成功后，会显示：

repo initialized in /android

在~/android下会有一个.repo的隐藏目录。

   5）同步源代码

$ repo sync

这一步要很久很久。

6）编译android源码,并得到~/android/out目录

$ cd ~/andoird
       $ make

这一过程很久。

 7）在模拟器上运行编译好的android

编译好android之后，emulator在~/android/out/host/linux-x86/bin下，ramdisk.img，system.img和userdata.img则在~/android/out/target/product/generic下。

$ cd ~/android/out/host/linux-x86/bin

增加环境变量

$ emacs ~/.bashrc

在.bashrc中新增环境变量，如下

#java 程序开发/运行的一些环境变量

export ANDROID_PRODUCT_OUT=~/android/out/target/product/generic
ANDROID_PRODUCT_OUT_BIN=~/android/out/host/linux-x86/bin
export PATH=${PATH}:${ANDROID_PRODUCT_OUT_BIN}:${ANDROID_PRODUCT_OUT};

最后，同步这些变化：

$ source ~/.bashrc
$ cd ~/android/out/target/product/generic
$ emulator -system system.img -data userdata.img -ramdisk ramdisk.img

最后进入android桌面，就说明成功了。

8）编译模块

android中的一个应用程序可以单独编译，编译后要重新生成system.img。

在源码目录下执行

$ . build/envsetup.sh （.后面有空格）

就多出一些命令：

- croot:   Changes directory to the top of the tree.
- m:       Makes from the top of the tree.
- mm:      Builds all of the modules in the current directory.
- mmm:     Builds all of the modules in the supplied directories.
- cgrep:   Greps on all local C/C++ files.
- jgrep:   Greps on all local Java files.
- resgrep: Greps on all local res/*.xml files.
- godir:   Go to the directory containing a file.

可以加—help查看用法。

我们可以使用mmm来编译指定目录的模块，如编译联系人：

$ mmm packages/apps/Contacts/

编完之后生成两个文件：

out/target/product/generic/data/app/ContactsTests.apk
       out/target/product/generic/system/app/Contacts.apk

可以使用

$ make snod

重新生成system.img，再运行模拟器。

9）编译SDK

直接执行make是不包括make sdk的。make sdk用来生成SDK，这样，我们就可以用与源码同步的SDK来开发android了。

a）修改/frameworks/base/include/utils/Asset.h

‘UNCOMPRESS_DATA_MAX = 1 * 1024 * 1024’ 改为 ‘UNCOMPRESS_DATA_MAX = 2 * 1024 * 1024’

原因是eclipse编译工程需要大于1.3M的buffer；

b）编译ADT

由于本人不使用eclipse，所以没有进行这步；

c）执行make sdk

注意，这里需要的javadoc版本为1.5，所以你需要在步骤1中同时安装sun-java5-jdk

$ make sdk

编译很慢。编译后生成的SDK存放在out/host/linux-x86/sdk/，此目录下有android-sdk_eng.xxx_linux- x86.zip和android-sdk_eng.xxx_linux-x86目录。android-sdk_eng.xxx_linux-x86就是 SDK目录。

实际上，当用mmm命令编译模块时，一样会把SDK的输出文件清除，因此，最好把android-sdk_eng.xxx_linux-x86移出来。

此后的应用开发，就在该SDK上进行，所以把7）对于~/.bashrc的修改注释掉，增加如下一行：

export PATH=${PATH}:~/android/out/host/linux-x86/sdk/android-sdk_eng.xxx_linux-x86/tools

注意要把xxx换成真实的路径；

 d）关于环境变量、android工具的选择

目前的android工具有：

A、我们从网上下载的Android SDK，如果你下载过的话（ tools下有许多android工具，lib/images下有img映像）
        B、我们用make sdk编译出来的SDK（ tools下也有许多android工具，lib/images下有img映像）
        C、我们用make编译出来的out目录（ tools下也有许多android工具，lib/images下有img映像）

那么我们应该用那些工具和img呢？

首先，我们一般不会用A选项的工具和img，因为一般来说它比较旧，也源码不同步。其次，也不会用C选项的工具和img，因为这些工具和img没有经过SDK的归类处理，会有工具和配置找不到的情况；事实上，make sdk产生的很多工具和img，在make编译出来out目录的时候，已经编译产生了，make sdk只是做了copy而已。

e）安装、配置ADT
       略过；

f）创建Android Virtual Device

编译出来的SDK是没有AVD（Android Virtual Device）的，我们可以通过android工具查看：

$ android list

创建AVD：

$ android create avd -t 1 -n myavd

可以android –help来查看上面命令选项的用法。创建中有一些选项，默认就行了。

再执行android list，可以看到AVD存放的位置。

以后每次运行emulator都要加-avd myavd或@myavd选项：

$ emulator -avd myavd

10）编译linux内核映像

 a）准备交叉编译工具链

android代码树中有一个prebuilt项目，包含了我们编译内核所需的交叉编译工具。

 b）设定环境变量

$ emacs ~/.bashrc

增加如下两行：

export PATH=$PATH:~/android/prebuilt/linux-x86/toolchain/arm-eabi-4.4.0/bin
       export ARCH=arm

保存后，同步变化：

$ source ~/.bashrc

 c）获得合适的内核源代码

$ cd ~/android

获得内核源代码仓库

$ git clone git://android.git.kernel.org/kernel/common.git kernel
       $ cd kernel
       $ git branch

显示

* android-2.6.27

说明你现在在android-2.6.27这个分支上，也是kernel/common.git的默认主分支。

显示所有head分支：

$ git branch -a

显示

* android-2.6.27
remotes/origin/HEAD -> origin/android-2.6.27
remotes/origin/android-2.6.25
remotes/origin/android-2.6.27
remotes/origin/android-2.6.29
remotes/origin/android-goldfish-2.6.27
remotes/origin/android-goldfish-2.6.29

我们选取最新的android-goldfish-2.6.29，其中goldfish是android的模拟器模拟的CPU。

$ git checkout -b android-goldfish-2.6.29 origin/android-goldfish-2.6.29
       $ git branch

显示

android-2.6.27
       * android-goldfish-2.6.29

我们已经工作在android-goldfish-2.6.29分支上了。

d）设定交叉编译参数

打开kernel目录下的Makefile文件，把CROSS_COMPILE指向刚才下载的prebuilt中的arm-eabi编译器.

CROSS_COMPILE ?= arm-eabi-

把

LDFLAGS_BUILD_ID = $(patsubst -Wl$(comma)%,%,\
       $(call ld-option, -Wl$(comma)–build-id,))

这一行注释掉，并且添加一个空的LDFLAGS_BUILD_ID定义，如下:

LDFLAGS_BUILD_ID =

e）编译内核映像

$ cd ~/android/kernel
       $ make goldfish_defconfig
       $ make

f）测试生成的内核映像

$ emulator -avd myavd -kernel ~/android/kernel/arch/arm/boot/zImage