把Android源代碼加入SDK

 各位調(diào)試Android程序的時(shí)候遇到“source not found”錯(cuò)誤應(yīng)該很抓狂吧，Goolge在發(fā)布SDK時(shí)沒有把源代碼包含進(jìn)去著實(shí)有點(diǎn)讓人費(fèi)解，對(duì)很多人來說Git無疑是個(gè)生澀的東西，而 framework中所有Java代碼加起來打個(gè)包也就是20多MB。更要命的是，Android Eclipse plugin (ADT)不允許我們?cè)陧?xiàng)目屬性中attach源代碼到android.jar上。好在Eric Burke找到了把source加入到SDK中的辦法，通過分析ADT的源代碼我們知道ADT是從SDK目錄下的“sources”目錄來查找class對(duì)應(yīng)的源代碼，這樣我們只要把源代碼放到sources目錄中ADT就可以自動(dòng)找到對(duì)應(yīng)的源代碼了。

那么接下來的問題是，我們需要把哪些源代碼加入到SDK中，我們又如何得到這些源代碼呢?

我之前的文章Android Scripting Environment動(dòng)手玩中提到過一個(gè)fix_android_sdk.py腳本，用來解決編譯ASE的時(shí)候找不到android.os.Exec包的問題，事實(shí)上這個(gè)腳本還做了另一件事，即遍歷整個(gè)< android-source >目錄，把其中所有的Java代碼復(fù)制到了SDK的sources目錄中。ASE Wiki的CompilingASE中 提到，編譯ASE需要Android的代碼樹，而我當(dāng)時(shí)告訴大家了一個(gè)取巧的方法，即只要下載frameworks/base的android- 1.5r2這個(gè)tag的snapshot就行，因?yàn)閍ndroid.os.Exec包就在其中，這足已解決我們編譯ASE的問題。

回到我們把源代碼加入到SDK上來，有了fix_android_sdk.py腳本(這里我們并不需要把a(bǔ)ndroid.os.Exec包編譯并添加到android.jar，所以我把腳本中的這個(gè)功能去掉了，點(diǎn)擊下載修改后的腳本)，如果你已經(jīng)通過repo下載了完整的代碼樹(需要注意版本的對(duì)應(yīng))，那么一切都很簡單。按照下面的方法，把a(bǔ)ndroid源代碼和SDK目錄作為參數(shù)傳給它即可。

fix_android_sdk.py < android-source > < android-sdk >

執(zhí)行完成以后，在\platforms\android-1.5目錄下就會(huì)生成一個(gè)sources目錄，其中包含了android代碼樹中所有的Java代碼，并且都根據(jù)包名存放各自的目錄，再次Debug代碼的時(shí)候ADT就可以找到相應(yīng)的源代碼了。

如果手上沒有完整的代碼樹，又想快速的把源代碼添加到SDK呢?看過Android的代碼樹就會(huì)知道，除了frameworks/base以外，還 有很多framework的代碼其實(shí)是在Dalvik目錄下，另外還有常用的apache http的包位于external/apache-http目錄下，所以要獲得用于調(diào)試的比較完整的framework源代碼，我們至少需要從 Android的代碼庫中下載platform/dalvik.git、platform/frameworks/base.git、platform/external/apache-http.git這 三個(gè)project。把下載回來的文件解壓到同一個(gè)目錄下，目錄結(jié)構(gòu)隨意，接下來利用fix_android_sdk.py腳本就可以把Java文件提取 出來。用這種方法來提取framework的源代碼比下載整個(gè)代碼數(shù)來得快很多，而且提取的結(jié)果和從完整的代碼樹比較來看，僅僅是少了我們Debug時(shí)完 全用不到的Android中捆綁的Application的源代碼，以及jdiff、tagsoup、clearsilver等包的代碼(這3個(gè)包我都沒 有接觸過，如果各位覺得有必要，可以自行下載并按上面提到的方法來添加源代碼，它們都在platform/external下)。

最后，如果你連上面這幾個(gè)包也懶得下載，懶得裝Python執(zhí)行環(huán)境，那么Android Forum上有一個(gè)討論Source code for android.jar的帖子正適合你，帖子的第10樓和11樓提供了提取好的Android 1.5 SDK源代碼(雖然未必100%和你的SDK匹配，也總比滿眼的source not found好吧)，解壓縮到你SDK下的sources目錄即可。