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

本次编译过程主要参考官方文档（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。