在Eclipse中查看Android SDK的源代码-优快云博客

viahttp://stuffthathappens.com/blog/2008/11/01/browsing-android-source-in-eclipse/

Google的Android SDK中包含一个android.jar文件，里面有Android所有的公开类的API接口。同时，Google还提供了一个Eclipse插件，可以很容易的开始进行开发。但是，这里并没有一个类似于androidSrc.jar的文件，因此当我们试图在Eclipse去查看Android SDK的源代码的时候，会得到下面这样的一个页面：

Google已经发布了Android所有的源代码，很大。要在Eclipse中查看Android的源代码，需要去http://source.android.com/（国内需），Get Source那个页面内按照指示一步步的将所有的东西都通过Git弄下来。很值得抽出一个晚上的时间来做这件事，因为如果能够随时查看源码，对于理解SDK如何工作的是非常有帮助的。

链接到Eclipse

现在我们有了源码，应该可以告诉Eclipse如何找到它了。右键点击android.jar——属性，可是却发现了这样的信息：

嗯....那段话的大意是，当前的class path的设置属于'Android Library'，不允许用户修改。好吧，只能去看看ADT的源码了，看能否找到什么办法。

查看ADT源码

当下载完Android源码之后，我们已经得到了所有内容，包括：操作系统、Dalvik虚拟机、Eclipse插件、公开的SDK...等等。

在 com.android.ide.eclipse.adt.project.internal 包里，我找到一个名为AndroidClassspathContainerInitializer.java 的类，包含如下代码：

IPath android_src = new Path(AdtPlugin.getOsAbsoluteAndroidSources());

好，再来看看AdtPlugin.java:

/** Returns the absolute android sources path in the sdk */
public static String getOsAbsoluteAndroidSources() {
return getOsSdkFolder() + getOsRelativeAndroidSources();
}

/** Returns the android sources path relative to the sdk folder */
public static String getOsRelativeAndroidSources() {
return AndroidConstants.FD_ANDROID_SOURCES;
}

最后来看看AndroidConstants.java:

public static final String FD_ANDROID_SOURCES = "sources";

搞定！

解决方案 #1

根据上面的分析，我们可以在android SDK的安装目录内创建一个sources目录，与android.jar位于同一个目录内。之后，我们可以在之前下好的Android源码中找到所有我们需要的代码。SDK的代码在frameworks/base/core/java，在这个目录下有一个android目录，我们需要将这个目录拷贝（链接）到SDK安装目录中的sources目录。你可能需要想想办法，把所有分散在不同Component的源码都弄到一起去。最终我们的目录结构大致如下：

SDK_PATH
  |-- android.jar
  +--docs/...
  +--samples/...
  +--sources
       +--android
       |      ...accounts, annotation, app, bluetooth, etc...
       +--com/android/etc...
       +--dalvik/...
       +--java/...
       +--javax/...

我把所有这样的目录都弄进来了，但是没有详细记录。

注：上面的代码是适用于以前的老版本的ADT，目前最新版本的ADT已经不适用了。经过查看源代码发现，最新版本的ADT需要在SDK目录下的platformsandroid-X对应的目录下建立sources目录，其中X是3、4、7、8之一的数字，对应不同的SDK版本。这也是一个比较合理的方案，毕竟不同版本的SDK的源码还是不一样的。

再注：（也就是我http://log4think.com），我自己写了一个脚本来做这个事情。这个脚本会从Android的源码目录中搜索并提取出分布在不同目录下的源代码，并按照package名字的目录结构重新组织。这里说的“Android的源码目录”指的是从source.android.com上面，使用repo
sync同步下来的代码库。

如果你在Linux或者Mac下工作，sources的源码目录结构可以用我写的如下的一个Shell脚本来完成这个事情，在Android的源码目录下运行这个脚本，然后会在~/workspace/src-tree创建"几乎"所有Java源码的soft symbol link。之后也可以用tar带-h参数打包到windows下使用。你可以根据自己的需求修改一下。

 
      #!/bin/bash 
     
      dest_dir 
      =~/workspace/src-tree 
     
      if 
      [ ! -z 
      "$1" 
      ]; 
      then 
     
      dest_dir 
      = 
      $1 
     
      fi 
     
      curr_dir 
      = 
      $PWD 
     
      dirname 
      = 
      $(basename 
      $dest_dir 
      ) 
     
      if 
      [ -d 
      $dest_dir 
      ] ; 
      then 
     
       rm -rf 
      $dest_dir 
     
      fi 
     
       mkdir -p 
      $dest_dir 
     
      for d in 
      $(find . -path .repo -prune 
      \ 
     
       -or -path .git -prune 
      \ 
     
       -or -path 
      "*/src/com/*" -type d -print 
      \ 
     
       -or -path 
      "*/src/net/*" -type d -print 
      \ 
     
       -or -path 
      "*/src/org/*" -type d -print 
      \ 
     
       -or -path 
      "*/java/com/*" -type d -print 
      \ 
     
       -or -path 
      "*/java/net/*" -type d -print 
      \ 
     
       -or -path 
      "*/java/org/*" -type d -print 
      \ 
     
       -or -path 
      "*/java/android/*" -type d -print 
      \ 
     
       -or -path 
      "*/java/javax/*" -type d -print 
      ) 
     
      do 
     
      sd 
      = 
      $( 
      echo 
      $d | sed 
      's#.*/src/\(.*\)/#\1/#g' | sed 
      's#.*/java/\(.*\)/#\1/#g' 
      ) 
     
      echo 
      ";; $d" 
     
      echo 
      "-> $sd" 
     
       mkdir -p 
      $dest_dir/ 
      $sd 
     
      for f in 
      $( 
      cd 
      $d; find . -mindepth 0 -maxdepth 1 -type f | sed 
      's#^\./##g' 
      ); 
      do 
     
      echo 
      " $f" 
     
       ln -s 
      $curr_dir/ 
      $d/ 
      $f 
      $dest_dir/ 
      $sd/ 
      $f 
     
      done 
     
      done 
     
      # package the source directory 
     
      $( 
      cd 
      $(dirname 
      $dest_dir 
      ); rm 
      ${ 
      dirname 
      }.tar.gz; tar zcfh 
      ${ 
      dirname 
      }.tar.gz 
      $dirname 
      ) 
     
    view raw 
     make-android-src-tree.sh 
    This Gist brought to you by 
    GitHub.

现在，当我再去查看Android SDK类的时候，可以看到源码了：

解决方案 #2

如果你实在不愿意把所有的Android源码拷贝到SDK目录里面去，也可以创建一个Eclispe User Library并把源码附加上去。
viahttp://stuffthathappens.com/blog/2008/11/01/browsing-android-source-in-eclipse/