Mac OS X 下用 Eclipse 瀏覽和編譯 Android 源代碼
為了能夠同時(shí)開發(fā)iPhone應(yīng)用程序和Android應(yīng)用程序,我將所有的開發(fā)環(huán)境都集成到了自己的Macbook上,雖然用Macbook開發(fā)普通的Android應(yīng)用程序沒什么問題,但是你要是想用Eclipse瀏覽和編譯Android源代碼并且對(duì)其SDK進(jìn)行調(diào)試,就是很麻煩的事情了。通過Google發(fā)現(xiàn)絕大部分Android源代碼的編譯和開發(fā)環(huán)境都是在Ubantu系統(tǒng)上,雖然Android官網(wǎng)提供了在MacOS X上編譯源碼的方式,但是嘗試了多次總是發(fā)現(xiàn)有問題。
剛好這段時(shí)間Android源碼網(wǎng)站被黑,終于找了一個(gè)方法能夠下載到完整的代碼,于是就借此機(jī)會(huì)再次嘗試一下編譯源碼,同時(shí)在Eclipse里面調(diào)試成功,記錄下來整個(gè)過程方便以后查閱。
一.設(shè)置MacOS X編譯環(huán)境
這一點(diǎn)是根據(jù)Android官方網(wǎng)站提供的方法來設(shè)置的,我這里只做了一些翻譯和解釋工作。我自己的Macbook已經(jīng)升級(jí)到了Lion,對(duì)于操作系統(tǒng)配置什么就不用去擔(dān)心了。直接上吧。
1.創(chuàng)建一個(gè)大小寫敏感的磁盤鏡像文件
由于編譯Android源代碼需要將代碼存放在大小寫敏感的磁盤當(dāng)中,所以我們需要首先創(chuàng)建一個(gè)大小寫敏感的磁盤鏡像文件(如果你的磁盤已經(jīng)是大小寫敏感的,則省略這個(gè)步驟,直接進(jìn)入步驟2).
進(jìn)入應(yīng)用程序/實(shí)用工具/磁盤工具,選擇文件->新建->新建空白映像:
其中名稱可以隨意,大小可以選擇自定義30G,格式選用MacOs擴(kuò)展(區(qū)分大小寫),映像格式選擇稀疏磁盤映像,這樣文件的大小會(huì)隨著文件的多少而增長(zhǎng),不用一上來就搞30G那么大,其它都是默認(rèn)選項(xiàng)。
同時(shí),你還可以通過命令行方式生成該磁盤鏡像:
$hdiutil create -type SPARSE -fs ‘Case-sensitive Journaled HFS+‘ -size 30g /path-to-image/AndroidDisk.sparseimage
生成的硬盤鏡像文件名就是AndroidDisk.sparseimage了。似乎創(chuàng)建完以后OS會(huì)自動(dòng)把這個(gè)鏡像加載上去,掛載點(diǎn)是/Volumes/android,其中android就是上面我們?yōu)榇疟P鏡像設(shè)置的名稱。
另外也可以將如下一行代碼加入到~/.profile當(dāng)中,function mountAndroid { hdiutil attach /path-to-image/AndroidDisk.sparseimage -mountpoint /Volumes/android; }這樣以后每次用mountAndroid命令就行了。
2.安裝所需要的包
1)首先你要安裝的就是Xcode,由于我的機(jī)器本身就是用來開發(fā)iPhone應(yīng)用程序的,所以我的Xcode是最新的版本,如果你沒有Xcode,可以到蘋果的官網(wǎng)注冊(cè)一個(gè)appleid,然后可以免費(fèi)下載最新的Xcode工具和MacOS SDK。
2)從macports.org安裝MacPorts工具
安裝MacPorts之前需要確認(rèn)環(huán)境變量PATH中,/opt/local/bin出現(xiàn)在/usr/bin之前,可以運(yùn)行一下這行來確認(rèn):
$echo $PATH
否則,就將如下代碼加入~/.profile當(dāng)中。
export PATH=/opt/local/bin:$PATH
3)從MacPorts安裝make,git, and GPG packages:
$POSIXLY_CORRECT=1 sudo port install gmake libsdl git-core gnupg
4)將gmake3.82還原到3.81
gmake3.82版本存在一個(gè)Bug,所以我們要將其還原為3.81版本。
$sudo vim /opt/local/etc/macports/sources.conf
然后在rsync那行的上面一行加上:
file:///Users/Shared/dports
然后按照下面的步驟依次執(zhí)行:
$mkdir /Users/Shared/dports
$cd /Users/Shared/dports/
$svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/devel/gmake/
$portindex /Users/Shared/dports
$ sudo port install gmake @3.81
執(zhí)行完成后,檢查一下gmake的版本:
$gmake –version
GNUMake 3.81
5)修改文件標(biāo)識(shí)符限制
于是最后下載Android源碼前的最后一步就是,修改文件標(biāo)識(shí)符限制:
由于MacOS默認(rèn)將同時(shí)打開的文件標(biāo)識(shí)符數(shù)量限制得太小,并行編譯處理時(shí)可能會(huì)超出這個(gè)限制。所以在 ~/.profile里加上這么一段:
#set the number of open files to be 1024
ulimit -S -n 1024
二.下載gingerbread源代碼
Android源代碼網(wǎng)站android.git.kernel.org已經(jīng)被黑了很長(zhǎng)一段時(shí)間,后來在網(wǎng)上另外找到一網(wǎng)站提供源代碼下載。
1.創(chuàng)建~/bin/目錄
$mkdir ~/bin
$PATH=~/bin:$PATH
2.安裝repo
$curl http://git-repo.googlecode.com/files/repo-1.12 > ~/bin/repo
3.設(shè)置repo可執(zhí)行權(quán)限
$chmoda +x ~/bin/repo
4.修改~/bin/repo文件將第五行
REPO_URL=‘https://code.google.com/p/git-repo/‘
改為
REPO_URL=‘http://code.google.com/p/git-repo/‘
5.新建目錄gingerbread,并進(jìn)入該目錄
$mkdir android_gingerbread_src
$cd android_gingerbread_src
6.執(zhí)行repoinit
$repo init -u git://Android.git.linaro.org/platform/manifest.git -bgingerbread
7.找到android_gingerbread_src目錄中的.repo下面的manifest.xml文件,該文件只是一個(gè)鏈接,實(shí)際上是manifest目錄下面的default.xml文件,將
fetch="git://Android.git.kernel.org/"
改為
fetch="git://Android.git.linaro.org/"
8.回到android_gingerbread_src目錄下,執(zhí)行reposync
$repo sync
這一步需要很長(zhǎng)時(shí)間,喝杯茶等吧。
三.編譯gingerbread源代碼
1)設(shè)置必要的編譯環(huán)境
編譯gingerbread首先需要jdk1.6版本,不過Mac上已經(jīng)自帶了,所以省卻這個(gè)步驟。
其次是gingerbread的編譯還依賴于MacOSX10.5.sdk,但是我安裝Xcode最新版本后,始終都無法通過編譯,后來自己看了一下編譯腳本配置文件external/qemu/Makefile.android,其中第72行,LEOPARD_SDK:= /Developer/SDKs/MacOSX10.5.sdk,將其修改為:[!--empirenews.page--]
LEOPARD_SDK:= /Developer/SDKs/MacOSX10.6.sdk,即可通過編譯。
初始化編譯環(huán)境:
$source build/envsetup.sh
2)選擇編譯目標(biāo)
$lunch full-eng
3)開始編譯代碼
$make
如果運(yùn)氣好的話,你可以看到最終成功的提示,goodluck!
四.將源代碼導(dǎo)入Eclipse
1.拷貝.classpath
進(jìn)入gingerbread源代碼目錄,也就是上面的android_gingerbread_src。
$cd android_gingerbread_src
$cp ./development/ide/eclipse/.classpath ./
將.classpath設(shè)置為可寫
$chmod +w .classpath
2.新建Eclipse工程
運(yùn)行Eclipse,選擇File->New->Java Project,項(xiàng)目位置就選擇android_gingerbread_src根目錄,導(dǎo)入成功以后,Eclipse開始編譯源代碼,不過會(huì)報(bào)告兩個(gè)錯(cuò)誤,如下:
Project‘gingerbread‘ is missing required library:‘out/target/common/obj/JAVA_LIBRARIES/google-common_intermediates/javalib.jar‘
Project‘gingerbread‘ is missing required library:‘out/target/common/obj/JAVA_LIBRARIES/gsf-client_intermediates/javalib.jar‘
刪除.classpath中的這兩行路徑:
添加
然后重啟Eclipse,即可解決。
五.利用Eclipse調(diào)試gingerbread代碼
通過對(duì)gingerbread源代碼的調(diào)試,我們可以更為清晰的了解Android的內(nèi)部工作機(jī)制,也可以省卻大量的閱讀代碼的時(shí)間,提高學(xué)習(xí)效率。
如果要想通過Eclipse來調(diào)試gingerbread代碼,我們必須首先能夠成功通過編譯,編譯以后,會(huì)生成幾個(gè)系統(tǒng)文件,其中包括system.img,userdata.img和ramdisk.img,三個(gè)文件位于源碼目錄下的out/target/product/generic子目錄下,如果熟悉Android系統(tǒng)開發(fā)的朋友應(yīng)該知道,一個(gè)完整的Android映像應(yīng)該還包括一個(gè)叫kernel-qemu的文件,這就是Linux內(nèi)核鏡像,不過我們并沒有編譯內(nèi)核,所以這里沒有生成這個(gè)文件。
要想成功調(diào)試,我們還需要安裝androidsdk,網(wǎng)上此類文章很多,這里就不多說了。將上述三個(gè)文件拷貝到/path-androidsdk/platforms/android-10/images目錄下,替換該目錄下的三個(gè)同名文件(由于gingerbread代碼版本是2.3.3,這個(gè)版本對(duì)應(yīng)的就是android—10,一定不要搞錯(cuò)了)。
創(chuàng)建一個(gè)新的avd虛擬設(shè)備,Target選擇Android2.3.3,如圖,并啟動(dòng)模擬器。
我們可以看出,Android的版本是2.3.5,Build number是full-eng 2.3.5 GINGERBREAD eng,編譯時(shí)間是2011.10.15日。確實(shí)是我們自己編譯的鏡像。
啟動(dòng)Eclipse,選擇gingerbread源碼工程后,選擇Run->Debug Configurations,在左邊列表中選擇“Remote Java Application”,并創(chuàng)建一個(gè)新的項(xiàng)目gingerbread,將端口(Port)設(shè)置為8700,其它保持缺省,如圖所示:
在eclipse中,選擇DDMS視圖,并選中你要調(diào)試的進(jìn)程,如圖:
回到上面的Remote Java Application界面,點(diǎn)擊“Debug”按鈕來啟動(dòng)調(diào)試,此時(shí)再打開DDMS視圖,可以看到我們要調(diào)試的進(jìn)程顯示一個(gè)綠色的小圖標(biāo):
你可以在eclipse中下斷點(diǎn)開始調(diào)試了。