如何在 Android Studio 中设置外部文档？答案

【问题标题】：How to set up external documentation in Android Studio?如何在 Android Studio 中设置外部文档？
【发布时间】：2015-03-10 00:55:02
【问题描述】：

我想让 Shift+F1（显示外部文档）工作。我知道这个问题： How can I make IntelliJ/Android Studio open Android docs when clicking F1 on function?

但我的项目结构完全不同（即缺少库部分！）

如何在 Android Studio 1.1.0 中设置外部文档位置？
IE。用于 Android 支持库、Google Play 服务等。

编辑： Android SDK 的外部文档已经可以使用，但我无法将其更改为在线版本，我根本无法将其设置为 Play Services 和 Support Library

【问题讨论】：

标签： android intellij-idea android-studio

【解决方案1】：

根据要求重复上面的评论作为答案：

不幸的是，Android Studio 已经操纵了 IntelliJ 设置 IDE，因此您无法在 UI 中提供指向文档的外部链接。通常，模块设置（或项目结构）能够查看所有库并配置在哪里可以找到外部文档。如果你觉得勇敢，你可以去~/.idea/libraries手动尝试并编辑play_services_x_y_z.xml（x、y和z是你正在使用的版本号。）寻找<JAVADOC />标签。修改为<JAVADOC>并添加子标签<root url="put_your_external_url_here" />然后关闭javadoc标签。

如果文件发生更改，您应该能够创建自定义 gradle 任务以注入适当的 XML，从而防止 gradle 同步问题。但是，这将是一些工作。这实际上是 IntelliJ 如何处理 Gradle 内部的 maven 依赖项及其项目设置的功能，而不是 gradle 的错，所以我认为没有任何特殊的 gradle 设置可以使其工作。

【讨论】：

只有内部文档对我有用，而不是外部文档。在我的“~”目录下，我找不到 .idea/libraries 文件。它是否有不同的位置可以找到？我的 SDK 位置是：Users/myname/Library/Android/sdk 和 JDK 位置是 /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home
@RedM 随着 Android Studio 的发展，它不断变化。在 OS X 上，设置存储在 $HOME/Library/Preferences/AndroidStudio4.0 中（尽管您的尾随版本可能不同 - 取决于您安装的内容！）查看 options/jdk.table.xml 文件。那里将定义许多 JDK，在您使用的那个下，您应该找到一个 <javadocPath> 标记和一个根 URL 设置。您应该可以根据需要进行修改。
对不起，我还是有点失落。我找到了文件 jdk.table.xml，但是当搜索我当前使用的 jdk 版本“jdk1.8.0_45”时，仅该文件就有 30 个匹配项。此外，当搜索“javadocPath”时，有 112 个匹配项。我怎么知道要修改哪一个，我应该添加/删除/编辑什么？谢谢拉里。
查找作为您目标平台 API 一部分的 JDK - 尽管最好只修改最新的 (API 29) 条目。这就是 AS 真正要从中汲取灵感的地方。
我去了标签“jdk”，在标签“name”下的值为“Android API 29 Platform”，然后我向下滚动到“javadocPath”标签（同时仍在jdk下父标签）。我在下添加了这个："developer.android.com" type="simple" />" ，重新启动了 Android Studio，不幸的是，它没有工作。

【解决方案2】：

进入您的 Android SDK（工具 -> Android -> SDK 管理器）并确保为您构建的目标 Android 版本安装了“Android SDK 文档”（请参阅 Android 5.1 (API 22) 部分):

【讨论】：

SDK 的外部文档正在工作，但我无法更改它，也无法为 Play 服务和支持库设置它
不幸的是，Android Studio 已经操纵了 IntelliJ 设置 IDE，因此您无法在 UI 中提供指向文档的外部链接。通常，模块设置（或项目结构）能够查看所有库并配置在何处查找外部文档。如果你觉得很勇敢，你可以手动尝试通过转到 ~/.idea/libraries 并编辑 play_services_x_y_z.xml（x、y 和 z 是你正在使用的版本#s。）寻找标签。将其修改为并添加一个子标签然后关闭 javadoc 标签。
谢谢，这确实有效！剩下的唯一问题是它在 gradle 同步时被删除（当然这并不奇怪）。但是由于这是一个好的解决方案（/hack），如果您为此单独回答，如果几天后没有更好的解决方案，您将获得赏金。虽然我希望有办法以某种方式将其放入 gradle 构建文件中。
...或防止它在 gradle 同步时被删除。