把Android源代码加入SDK

各位调试Android程序的时候遇到“source not found”错误应该很抓狂吧，Goolge在发布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中，我们又如何得到这些源代码呢？
我之前的文章中提到过一个fix_android_sdk.py脚本，用来解决编译ASE的时候找不到android.os.Exec包的问题，事实上这个脚本还做了另一件事，即遍历整个< android-source >目录，把其中所有的Java代码复制到了SDK的sources目录中。ASE Wiki的中提到，编译ASE需要Android的代码树，而我当时告诉大家了一个取巧的方法，即只要下载frameworks/base的android-1.5r2这个tag的snapshot就行，因为android.os.Exec包就在其中，这足已解决我们编译ASE的问题。

回到我们把源代码加入到SDK上来，有了fix_android_sdk.py脚本（这里我们并不需要把android.os.Exec包编译并添加到android.jar，所以我把脚本中的这个功能去掉了，），如果你已经通过repo下载了完整的代码树（需要注意版本的对应），那么一切都很简单。按照下面的方法，把android源代码和SDK目录作为参数传给它即可。
fix_android_sdk.py < android-source > < android-sdk >
执行完成以后，在、、这三个project（20090729，Update，的源代码也很有用，不过解压的时候留下为智能手机准备的phone目录就够了，至于mid，这是为MID设备准备的policy）。把下载回来的文件解压到同一个目录下，目录结构随意，接下来利用fix_android_sdk.py脚本就可以把Java文件提取出来。用这种方法来提取framework的源代码比下载整个代码数来得快很多，而且提取的结果和从完整的代码树比较来看，仅仅是少了我们Debug时完全用不到的Android中捆绑的Application的源代码，以及jdiff、tagsoup、clearsilver等包的代码（这3个包我都没有接触过，如果各位觉得有必要，可以自行下载并按上面提到的方法来添加源代码，它们都在platform/external下）。

最后，如果你连上面这几个包也懒得下载，懒得装Python执行环境，那么Android Forum上有一个讨论Source code for android.jar的帖子正适合你，帖子的第10楼和11楼提供了提取好的Android 1.5 SDK源代码（虽然未必100%和你的SDK匹配，也总比满眼的source not found好吧），解压缩到你SDK下的sources目录即可。