当我使用 Android Studio(macOS 10.12.6 系统, Android Studio 3.0)做 Android 项目开发时, 我经常会使用鼠标悬停的方式去查看类, 方法和字段的文档注释.
但当我这样做时, 我发现一个非常让我懊恼的问题, 当我鼠标悬停时, 出现的弹框中显示 Fetching Documentation..., 并且它会显示很长一段时间.
问题总是得解决的,经过一番搜索,我找到了问题的解决方法:修改配置文件。修改方法如下:
- 找到AS的配置文件目录,我的是在~/Library/Preferences下
- 找到AS当前版本的配置文件目录,我的是在~/Library/Preferences/AndroidStudio3.0下
- 找到配置文件目录下options/jdk.table.xml文件打开
- 找到你当前项目compileSdkVersion对应的版本所对应的jdk节点(当然如果需要的话你也可以修改所有版本的jdk节点)
- 再找到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就会很快了(不是很快,是非常快!)。