如何离线使用Android SDK文档

Question

我已经使用 SDK 管理器下载了 Android SDK 文档，以便与 Android Studio v2.3.0.8 离线使用。

但每次我按 ctrl+q 显示有关类型|类型成员的快速信息时，它都会显示 "Fetching Documentation..."，等待 ~20 秒后，它会显示信息。

我不希望延迟或使用联机帮助，本地文档也已准备就绪，这是为什么呢？解决方案是什么？

编辑：在线时会发生这种情况，但离线时完全没有延迟， 好像 IDE 试图获取新版本的文档。

Answer 1

我也下载了它，我注意到 Android Studio 没有在 jdk.table.xml 中正确生成 javadocPath，这就是文件的样子（有jdk 名称为 Android API ## Platform 的标签):

...
<jdk version="2">
  <name value="Android API 25 Platform" />
  <type value="Android SDK" />
  <homePath value="$USER_HOME$/android-sdk" />
  <roots>
      ...
    <javadocPath>
      <root type="composite">
        <root type="simple" url="http://developer.android.com/reference/" />
      </root>
    </javadocPath>
      ...

File is located at Android Studio Configuration folder/config/options/jdk.table.xml

请注意 javadocPath 指向在线 url，只需将其更改为您的本地副本，在我的例子中，docs 文件夹位于 /home/mauricio/android-sdk/docs , 在 Windows 中类似于 C:/android-sdk/docs.

你必须遵循的url结构是file://<path-to-sdk>/docs/reference

You have to point to the reference folder inside the docs.

看起来像这样：

  <root type="simple" url="file:///home/mauricio/android-sdk/docs/reference" />
  <!-- if it's Windows -->
  <root type="simple" url="file://C:/android-sdk/docs/reference" />

然后，如果是运行，重启 Android Studio 就大功告成了。
我也有一个SSD，离线文档让它可以立即打开。

注意： 您必须在文件中的所有 javadocPath 中执行此操作（在任何文本编辑器中使用 Replace all 非常容易），并且当您下载一个新的 Android API，你必须再次这样做，因为它会生成指向在线文档的 url。

我认为这是 Android Studio 中的错误，因为可以正确检测和生成 sourcePath 和 classPath。值得向他们报告。

Answer 2

改进了显示文档的解决方案（来自来源）。

发现，如果您通过 SDK 管理器下载文档（它将位于 .../sdk/docs/reference），您将使用 only 24 API documentation。（假设，您的项目目标 SDK 是 25 或 22，例如）。

要解决此问题，您需要：

通过 Android Studio 中的 SDK 管理器删除文档。
就在那里，下载感兴趣的 API 的源代码（源代码已经包含文档）。我还发现，与 .../sdk/docs/reference 中的离线相比，获取 documentation from sources 的速度要快一些。

从 jdk.table.xml 中删除所有 javadoc 路径。 OS X 上此文件的路径：~/Library/Preferences/AndroidStudio.../options/jdk.table.xml

--> Delete all of these and all occurrences -->

<javadocPath>
  <root type="composite">
    <root type="simple" url="http://developer.android.com/reference/" />
  </root>
</javadocPath>

重启工作室。享受吧！

Answer 3

对于 sdk tools v26，使用命令行：

PATH_TO_SDK/tools/bin/sdkmanager "docs"

然后进入目录PATH_TO_SDK/docs并打开index.html文件

Answer 4

修复 config/options/jdk.table.xml 的一种方法是停止 IDE，删除文件，重新启动广告。 IDE 找到已安装的 SDK，并重新生成选项文件。

我在从预览版升级到 3.2 时遇到了问题，文档显示速度很慢，以上解决了这个问题。

如何离线使用Android SDK文档

How to use Android SDK Documentation offline

android

android-studio-2.3