Android Studio 中鼠标悬停 Fetching Documentation 很长时间

2017/11/13 posted in  Android

当我使用 Android Studio(macOS 10.12.6 系统, Android Studio 3.0)做 Android 项目开发时, 我经常会使用鼠标悬停的方式去查看类, 方法和字段的文档注释.

但当我这样做时, 我发现一个非常让我懊恼的问题, 当我鼠标悬停时, 出现的弹框中显示 Fetching Documentation..., 并且它会显示很长一段时间.

问题总是得解决的,经过一番搜索,我找到了问题的解决方法:修改配置文件。修改方法如下:

  1. 找到AS的配置文件目录,我的是在~/Library/Preferences下
  2. 找到AS当前版本的配置文件目录,我的是在~/Library/Preferences/AndroidStudio3.0下
  3. 找到配置文件目录下options/jdk.table.xml文件打开
  4. 找到你当前项目compileSdkVersion对应的版本所对应的jdk节点(当然如果需要的话你也可以修改所有版本的jdk节点)
  5. 再找到roots节点下的javadocPath节点,修改该节点里的的url属性,使之与sourcePath节点里的url属性一致即可

修改前的节点如下所示:

        <javadocPath>
          <root type="composite">
            <root type="simple" url="http://developer.android.com/reference/" />
          </root>
        </javadocPath>
        <sourcePath>
          <root type="composite">
            <root type="simple" url="file://``USER_HOME``/Library/Android/sdk/sources/android-26" />
          </root>
        </sourcePath>

在上面修改前的节点中,javadocPath在找android developer官网上的doc,由于网络的原因(某墙),肯定很难fetching到documentation。所以将url修改为下载到本地的源码(去本地源码中fetching documentation自然很快),如下所示:

        <javadocPath>
          <root type="composite">
            <root type="simple" url="file://``USER_HOME``/Library/Android/sdk/sources/android-26" />
          </root>
        </javadocPath>
        <sourcePath>
          <root type="composite">
            <root type="simple" url="file://``USER_HOME``/Library/Android/sdk/sources/android-26" />
          </root>
        </sourcePath>

修改完之后,需要重启下AS,fetching documentation就会很快了(不是很快,是非常快!)。