java - 如何让Android studio内嵌JDK使用本地文档路径

Question

我使用的是Android studio 2.2，并且使用嵌入式JDK作为我项目的JDK，这是推荐的设置方式。

我的项目有一个在主机上运行的 java 模块。当我处理这个 java 模块时，弹出菜单显示 Fetching documentation... 并且每次我想查找一些 Java API 的文档时都会花一点时间来显示文档。

我的主机上安装了另一个版本的 JDK，/Library/Java/JavaVirtualMachines/jdk1.8.0_112.jdk/Contents/Home

所以我尝试更改文件 ~/Library/Preferences/AndroidStudio2.2/options/jdk.table.xml 中的几行

<javadocPath>
    <root type="composite">
        <root type="simple" url="http://docs.oracle.com/javase/8/docs/api" />
    </root>
</javadocPath>

到

<javadocPath>
      <root type="composite">
          <root type="simple" url="jar:///Library/Java/JavaVirtualMachines/jdk1.8.0_112.jdk/Contents/Home/src.zip!/" />
          <root type="simple" url="jar:///Library/Java/JavaVirtualMachines/jdk1.8.0_112.jdk/Contents/Home/javafx-src.zip!/" />
      </root>                          
</javadocPath>

但是在我重新启动Android studio 之后，我的更改并没有生效。查文档的时候很慢，jdk.table.xml的内容恢复回来了，javadocPath url路径还是指向http://docs.oracle.com/javase/8/docs/api.

如何在带有嵌入式 JDK 的 Android Studio 中使用本地 JDK 文档？

Answer 1

将 src.jar 链接(或复制)到 jre 目录中

我在这里遇到了类似的问题。您的尝试启发了我尝试其他方法:将本地 JDK 安装中的 src.zip 文件链接到 Android Studio 的 jre 目录中。假设您的 Android Studio 位于 $ANDROID_STUDIO_HOME_DIR:

# assuming you're on something *nix-y
$ ln -s /Library/Java/JavaVirtualMachines/jdk1.8.0_112.jdk/Contents/Home/src.zip $ANDROID_STUDIO_HOME_DIR/jre/src.zip

重启后似乎有效[*]。看似适当的值会自动添加到 jdk.table.xml 文件中，并且一切都在进一步重启后幸存下来。当然，将文件复制到适当的位置会起到同样的作用，但我想我会发现软链接(soft link)是一个有用的提示，提醒了这个 hack...

[*]:我想如果您使用的是 JavaFX，您也需要为 javafx-src.zip 做同样的事情。

---

Android Studio 更新问题

后来:此更改在 Android Studio 的下一次更新后失效。更新过程(2.2 到 2.3)引发了一个关于补丁冲突的对话框，涉及我添加的 src.jar 文件。关闭该对话框后，更新运行完成。然后 Studio 似乎工作正常，除了我的 java 模块的快速文档再次丢失。我将链接重新添加到 src.jar 以使其再次运行。

---

改用 API 文档

为了完整起见，我还发现了一种使用 API 文档副本而不是本地 JDK 的 src.zip 的方法。如果将 API 文档链接/复制到 $ANDROID_STUDIO_HOME_DIR/jre/docs/api，则会获取该文档。

因此，要使用上面提到的Android SDK 文档:

$ mkdir $ANDROID_STUDIO_HOME_DIR/jre/docs
$ ln -s ~/android-sdks/docs/reference $ANDROID_STUDIO_HOME_DIR/jre/docs/api

或者，如果您有一份 Oracle 的 jdk-xxx-docs-all.zip 解压缩到 $JDK_DOCS:

$ mkdir $ANDROID_STUDIO_HOME_DIR/jre/docs
$ ln -s $JDK_DOCS/api $ANDROID_STUDIO_HOME_DIR/jre/docs/api