Ubuntu下Android源码编译及Eclipse开发环境搭建

/** 
版本：1.1 
日期：2009-03-27 
作者：HKjinzhao 
备注：增加make sdk，修改一些内容 
*/ 

本次编译过程主要参考官方文档（http://source.android.com/download）和网上相关资料（如http://blog.csdn.net/liaoshengjiong/archive/2009/03/04/3957749.aspx） 

编译环境：Ubuntu8.10 

1、安装软件环境 
$sudo apt-get install build-essential 
make 
gcc 
g++ 
libc6-dev 

patch 
texinfo 
libncurses-dev 

git-core gnupg 
flex bison gperf libsdl-dev 
libesd0-dev libwxgtk2.6-dev build-essential zip curl ncurses-dev 
zlib1g-dev 
valgrind 
python2.5 


2、安装java环境 
A、提出问题 
官方文档说如果用sun-java6-jdk可出问题，得要用sun-java5-jdk。经测试发现，如果仅仅make（make不包括 make sdk）；问题1：用sun-java6-jdk是没有问题的。而make sdk，就会有问题，严格来说是在make doc出问题，它需要的javadoc版本为1.5。 
B、分析问题 
因此，我们安装完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版本： 
C、解决问题 
安装jdk6 
$sudo apt-get install sun-java6-jre sun-java6-plugin sun-java6-fonts sun-java6-jdk 
安装jdk5 
需要在源文件中添加如下资源信息，执行如下命令 
$sudo gedit /etc/apt/sources.list 
添加的信息如下： 
deb http://run.hit.edu.cn/ubuntu/ jaunty main restricted universe multiverse 
deb-src http://run.hit.edu.cn/ubuntu/ jaunty main restricted universe multiverse 
deb http://run.hit.edu.cn/ubuntu/ jaunty-updates main restricted universe multiverse 
deb-src http://run.hit.edu.cn/ubuntu/ jaunty-updates main restricted universe multiverse 
deb http://run.hit.edu.cn/ubuntu/ jaunty-backports main restricted universe multiverse 
deb-src http://run.hit.edu.cn/ubuntu/ jaunty-backports main restricted universe multiverse 
deb http://run.hit.edu.cn/ubuntu/ jaunty-security main restricted universe multiverse 
deb-src http://run.hit.edu.cn/ubuntu/ jaunty-security main restricted universe multiverse 
最后安装jdk5 
$sudo apt-get update 
$sudo apt-get install sun-java5-jdk 
安装后选择当前使用的jdk 
$sudo update-alternatives --config java 
$sudo update-java-alternatives -s java-1.5.0-sun 
这时候再执行$java -version命令就能看到java 1.5已经正常工作了 

修改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 

3、设置环境变量 
$vim ~/.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}:${JRE_PATH}:${HOME_BIN}; 
#echo $PATH; 

最后，同步这些变化： 
$source ~/.bashrc 

4、安装repo（用来更新android源码） 
创建~/bin目录，用来存放repo脚本程序，如下： 
$ cd ~ 
$ mkdir bin 
并加到环境变量PATH中，在第2步中已经加入 
下载repo脚本并使其可执行： 
$ curl http://android.git.kernel.org/repo >~/bin/repo 
$ chmod a+x ~/bin/repo 

这时~/bin目录中多了一个repo脚本程序文件。 

5、下载 android源码并更新之 
建议不要用repo来下载（android源码超过1G，非常慢）建议下载cupcake项目，命令如下： 
$repo init -u git://android.git.kernel.org/platform/manifest.git -b cupcake (如果不出错的话，5分钟内应提示成功，跟网络自己速度有关) 
然后执行如下命令: 
$repo sync（更新很慢，用了3个小时） 


6、编译android源码（使用make命令） 
更新源码完成后并得到~/project/android/cupcake/out 目录 
进入android源码目录执行如下命令： 
$make 
这将显示如下信息： 

xiongmc@xiongmc-pc:~/android/bin$  cd src-2.2/ 
xiongmc@xiongmc-pc:~/android/bin/src-2.2$ ls 
bionic    cts          device      hardware  out       sdk 
bootable  dalvik       external    Makefile  packages  system 
build     development  frameworks  ndk       prebuilt 
xiongmc@xiongmc-pc:~/android/bin/src-2.2$ make 
============================================ 
PLATFORM_VERSION_CODENAME=REL 
PLATFORM_VERSION=2.2 
TARGET_PRODUCT=generic 
TARGET_BUILD_VARIANT=eng 
TARGET_SIMULATOR= 
TARGET_BUILD_TYPE=release 
TARGET_BUILD_APPS= 
TARGET_ARCH=arm 
HOST_ARCH=x86 
HOST_OS=linux 
HOST_BUILD_TYPE=release 
BUILD_ID=MASTER 
。。。。。。。 
。。。。 
。。。 
。。。。。 
。。。。。。 
这一过程很久（大概2个多小时，与自己cup有关） 

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

android SDK的emulator程序在android-sdk-linux_x86-1.0_r2/tools/下，emulator是需要加载一些后缀为.image 的文件，默认加载android-sdk-linux_x86-1.0_r2/tools/lib/images下的kernel-qemu（内核） ramdisk.img system.img userdata.img  这三个 

编译好android之后， 
emulator    程序在~/project/android/cupcake/out/host/linux-x86 /bin下， 
ramdisk.img system.img userdata.img    文件则在~/project/android/cupcake/out/target/product/generic下 

我们增加模拟器的环境变量 
$vim ~/.bashrc 
在.bashrc中新增环境变量，如下 
#java 程序开发/运行的一些环境变量 
export ANDROID_PRODUCT_OUT=~/project/android/cupcake2/out/target/product/generic 
ANDROID_PRODUCT_OUT_BIN=~/project/android/cupcake2/out/host/linux-x86/bin 
export PATH=${PATH}:${ANDROID_PRODUCT_OUT_BIN}; 

最后，同步这些变化： 
$source ~/.bashrc 

启动模拟器： 
$emulator -image system.img -data userdata.img -ramdisk ramdisk.img 
最后进入android桌面，就说明成功了。 
out/host/linux-x86/bin下生成许多有用工具（包括android SDK/tools的所有工具），因此，可以把eclipse中android SDK的路径指定到out/host/linux-x86/bin进行开发了 

================================================================ 

8、编译linux kernel（可选，主要是系统移植需要） 
直接make android源码时，并没有make linux kernel。因此是在运行模拟器，所以不用编译 linux kernel。如果要移值android，或增删驱动，则需要编译 linux kernel 
linux kernel的编译将在以后的文章中介绍。 

9、编译单个模块（如果需要修改系统某些应用，那么就需要单个应用编译） 
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来编译指定目录的模块，如编译联系人，具体操作如下： 
$. build/envsetup.sh 
$mmm packages/apps/Contacts/     
编完之后生成两个apk文件： 
out/target/product/generic/data/app/ContactsTests.apk 
out/target/product/generic/system/app/ Contacts.apk 
可以使用make snod重新生成system.img 
再运行模拟器 

10、编译SDKandroid源码的编译【直接执行make命令是不包括make sdk的。make sdk用来生成SDK，这样，我们就可以用与源码同步的SDK来开发 android了】步骤如下： 

1）修改/frameworks/base/include/utils/Asset.h 
‘UNCOMPRESS_DATA_MAX = 1 * 1024 * 1024’ 改为 ‘UNCOMPRESS_DATA_MAX = 2 * 1024 * 1024’ 
原因是Eclipse编译工程需要大于1.3M的buffer 

2）编译ADT（记住我们先编译adt后编译sdk） 
    若下载的是cupcake源码需进入：development/tools/eclipse/scripts目录，如果下载的是主线代码，需要进入：sdk/eclipse/scripts目录（才会有build_server.sh脚本命令），执行如下命令 

$export ECLIPSE_HOME=你的eclipse路径 
$./build_server.sh 你想放ADT的路径 

注意：在执行./build_server.sh命令时，会将out/host/linux-x86/目录下生成的sdk及我们之前make后生成的文件（ramdisk.img，userdata.img，system.img）给清除掉，这也就是我们为什么要先编译adt后编译sdk的原因。 

3）执行make sdk。 
$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移出来 

4）关于环境变量、android工具的选择 
目前的android工具有： 
A、我们从网上下载的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，因为一般来说它比较旧，也源码不同步。测试发现，如果使用B选项的工具和img，android模拟器窗口变小（可能是skin加载不了），而用C选项的工具和img则不会有此问题。 
有些android工具依赖android.jar（比如android），因此，我们在eclipse中使用B选项的工具（SDK），使用C选项的 img。其实，从emulator -help-build-images也可以看出，ANDROID_PRODUCT_OUT是指向C选项的img目录的 
不过，除了用A选项的工具和img，用B或C的模拟器都不能加载sdcard，原因还不清楚。 

5）安装、配置ADT 
安装、配置ADT请参考官方文档 

(1) Eclipse IDE下载地址：http://www.eclipse.org/downloads/ 
(2) ADT安装地址：https://dl-ssl.google.com/android/eclipse ，注意安装时与eclipse的版本一致，通常JEE版本无法更新ADT，最好使用java Base版。 

6）创建Android Virtual Device 
编译出来的SDK是没有AVD（Android Virtual Device）的，我们可以通过android工具查看： 
android list 
输出为： 
Available Android targets: 
[1] Android 1.5 
     API level: 3 
     Skins: HVGA-P, QVGA-L, HVGA-L, HVGA (default), QVGA-P 
Available Android Virtual Devices: 
表明没有AVD。如果没有AVD，eclipse编译工程时会出错（Failed to find a AVD compatible with target 'Android 1.5'. Launch aborted.） 
创建AVD： 
android create avd -t 1 -c ~/sdcard.img -n myavd 
可以android –help来查看上面命令选项的用法。创建中有一些选项，默认就行了 
再执行android list，可以看到AVD存放的位置 
以后每次运行emulator都要加-avd myavd或@myavd选项，这里eclipse才会在你打开的emulator中调试程序 


注意： 
这样，SDK和ADT就生成了，就按照官方文档把他们整合到Eclipse，这里不再细说了。 
建个android的新工程，试试你自己编译的sdk。