Eclipse同时附加javadoc和android文档(转)

 

当你安装android之后，有可能你的Eclipse不再具有文档提示功能，特别是你在一台电脑上安装后android之后，拷贝到另一台电脑，虽然都可以使用，但不知道为什么，有时候确是怎么都不出来javadoc，导致你在类或者方法上，鼠标点上去，或者按shift+F2看不到文档提示。

Eclipse有直接查看java文档和类库源码的功能，不过得手工添加才行，下面对如何在Eclipse中添加java文档和类库源码进行总结。

1. Window->Pereferences…打开参数选择对话框，展开Java节点，单击“Installed JREs"，此时右边窗口会显示已经加载的jre。

2. 选中要设置的jre版本，单击"Edit"，弹出JRE编辑窗口

3. 添加javadoc：将JRE system libraries下的所有包选中（注意这里是所有包，而不是网上有人说的rt.jar，虽然这样有的人的确能出来文档提示，但是也有人出不来。） ，单击右边的“Javadoc Location”按钮，弹出javadoc设置窗口。选择“Javadoc URL”单选框，单击“Browse”按钮，选中docs/api目录，然后点击“OK”。这里如果你下载的是zip压缩，则选择archieve文件。

4. 添加source： 将JRE system libraries下的所有包选中，单击右边的“Source Attachment”按钮，弹出source attachment configuration窗口。单击“External File”按钮，选中java安装目录中的src.zip文件（C:\Program Files\Java\jdk1.6.0_24，注意了，这里不是jre文件夹下的，而是jdk文件夹下的。），然后点击“OK”

5.后面就一路OK、确定就行了。

6.android的文档，需要【your project】-》【properties】-》【libraries】-》【android.jar】->【javadoc location：】-》【edit】，选择你的android docs/reference这个文件夹，就ok。这里有的时候，你修改了javadoc location之后，它又会自动修改回合http//;的默认形式，这种情况，等一下，再修改，就行了。

在添加好了javadoc与source后，在eclipse中，使用快捷键"Shift+F2"，可快速调出选中类的api文档；使用快捷建F3（或在类上点击右键，现在查看声明），可打开类的源文件。

 

最后说一下，将java API文档换为中文的办法

如果我们将将上面的 javadoc location修改为我们的中文文档位置，事实上，在我们的anroid工程里，你看到的依然是英文文档的内容，那么这个内容来自哪里呢，通过查看路径，我们看到，这个内容来自我们android docs/reference/文件夹下的内容，当我们打开该文件，发现下面有java和javax两个java API文档的内容，原来那些内容来自这里，

 ，这样我们就要用中文文档里的两个文件java和javax来覆盖这两个文件夹，覆盖完之后，效果终于出来了。