android源碼的編譯

/**
版本：1.0
日期：2009-03-18
作者：HKjinzhao
備忘：初始版本
*/
/**
版本：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
 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 libncurses-dev
 
 sudo apt-get install git-core gnupg
 sudo apt-get install flex bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl
 sudo apt-get install ncurses-dev
 sudo apt-get install zlib1g-dev
 sudo apt-get install valgrind
 sudo apt-get install python2.5

安裝java環境
sudo apt-get install sun-java6-jre sun-java6-plugin sun-java6-fonts sun-java6-jdk

註：官方文檔說如果用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-java5-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、設定環境變數
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

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、下載 android源碼並更新之
建議不要用repo來下載（android源碼超過1G，非常慢），直接在網上下載http://www.androidin.com/bbs/pub/cupcake.tar.gz。而且解壓出來的 cupcake下也有.repo檔案夾，可以通過repo sync來更新cupcake代碼：
tar -xvf  cupcake.tar.gz

repo sync（更新很慢，用了3個小時）

5、編譯android源碼,並得到~/project/android/cupcake/out 目錄
進入android源碼目錄：
make
這一過程很久（2個多小時）

6、在模擬器上運行編譯好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下
cd ~/project/android/cupcake/out/host/linux-x86/bin

增加環境變數
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進行開發

7、編譯linux kernel
直接make android源碼時，並沒有make linux kernel。因此是在運行模擬器，所以不用編譯 linux kernel。如果要移值android，或增刪驅動，則需要編譯 linux kernel
linux kernel的編譯將在以後的文章中介紹。

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了。

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。
注意，我們是先執行2），再執行3）。因為在執行./build_server.sh時，會把產生的SDK清除了。
用上了新的源碼，adt這個調試工具也得自己來產生，步驟如下：
進入cupcake源碼的development/tools/eclipse/scripts目錄，執行：
export ECLIPSE_HOME=你的eclipse路徑
./build_server.sh 你想放ADT的路徑

3）執行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移出來

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請參考官方文檔

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。