[Android] ADT关联源码与API文档 [2013-06-26更新]

! 注意：进行下述操作前请确保JDK已正确安装并设置环境变量。

1. 下载最新版ADT

例如：adt-bundle-windows-x86_64-20130522.zip

官网下载：http://developer.android.com/sdk/index.html

2. 解压ADT

解压 adt-bundle-windows-x86_64-20130522.zip 到任意目录。

解压后进入，可看到eclipse、sdk目录和 SDK Manager（如下图所示）。

3. 下载源码和API文档

运行 SDK Manager（在Win7系统下可能无法启动，此时可尝试运行 sdk\tools\android.bat，或者在eclipse中运行）

在最新的API（一般而言，最新的API应该会包含以前所有版本的内容）中勾选 [Documentation for Android SDK] 和 [Sources for Android SDK]，点击 [Install ...]。

在弹出的窗口中选择 [Accept License]，点击 [Install]。

上述操作完成后，SDK Manager 开始下载安装源码和API文档。

等待（耗时较长），直到提示安装完成。安装完成后关闭 SDK Manager。

安装成功后，在sdk目录下会多了一个docs目录。API文档的路径为 sdk\docs\reference，打开 index.html 可直接在浏览器中查看。下载的源码所在的路径为 sdk\sources\android-17。

4. 运行eclipse，设置工作目录，并用默认选项创建一个工程。

5. 关联源码与API文档

1) 选择 [Project]-->[Properties]，在弹出的项目属性窗口的右侧选择 [Jave Build Path]，然后在左侧选择 [Libraries] 标签页。在 [Libraries] 中找到相应的Android版本结点（例如：Android 4.2.2），展开该结点，找到 [android.jar] 并展开，此时可看到  [Source attachment]（用于关联源码）和 [Javadoc location]（用于关联API文档）。

2) 选择 [Source attachment] ，点击右侧的 [Edit]，在弹出的对话框中选择 [External location]，然后点击 [External Folder...]，选择源码所在的路径（即sdk\sources\android-17）。设置完成后如下图所示，点击 [OK]。

3) 选择 [Javadoc location]，点击右侧的 [Edit]，在弹出的对话框中选择 [Javadoc URL],殿后点击 [Browse...]，选择API文档所在的目录（即 sdk\docs\reference）。设置完成后点击 [OK] 保存并退出。

6. 测试

打开工程src下的java文件（如 MainActivity.java），将光标移动到Activity处稍等片刻会出现API说明悬浮框，这说明API文档已经关联成功。

按住Ctrl键，然后左键单击Activity后能跳转到Activity的定义则说明源码也关联成功。

此外，为检测开发环境是否已经搭建成功，建议尝试执行刚刚新建的工程。具体步骤在此不再赘述。