把Android源代碼加入SDK

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

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

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

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

fix_android_sdk.py android-source > android-sdk >

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

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

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