android-studio - 如何让 Google Play 服务 API 和 Firebase API 的 API javadoc 显示在 Android Studio 中，而不是没有文档的反编译类？

Question

当我点击我在 Android Studio 的 android 项目中使用的任何 Google Play 服务 API 或 Firebase API 时，IDE 会将我带到类的反编译版本，其中变量名称被混淆并且没有任何文档的方法。任何想法如何直接在 IDE 中查看文档？

我怀疑原因是 play 服务和 firebase 服务不是开源的，我对 没问题。不是 看到impls，我明白他们想要保护它。但是我真的会从直接在 IDE 中查看文档而不是按 alt-tab 键切换到浏览器中受益。谢谢你的帮助。

Answer 1

Javadoc 确实应该与客户端库一起分发。我们在谷歌内部有一个悬而未决的问题，但我没有关于何时提供适当解决方案的时间表。但是，我可以为您提供一个可以应用于您的项目的解决方法。这不是一个很好的解决方案，但它是一些东西。

在我的 OSX 机器上，Android SDK 安装在这里:

/Users/[myusername]/Library/Android/sdk

Play 服务和 Firebase javadoc 的本地副本在这里(您的可能有所不同):

/Users/[myusername]/Library/Android/sdk/extras/google/google_play_services/docs/reference/

您实际上可以使用以下过程将此路径附加到 Android Studio 中的 Firebase 客户端库:

在“外部库”下的项目 View 中找到 Firebase/Play 客户端库。

右键单击您最有兴趣查看 javadoc 的那个。例如，对于 Firebase 实时数据库，您可以使用“firebase-database-9.2.0”。

在上下文菜单中，单击底部的库属性。

在“库属性”窗口中，有一个带有 + 号的按钮。单击那个。这使您可以将 javadoc 路径附加到该库中的类。

从上方导航/粘贴您的 javadoc 路径到对话框中。

在下一个对话框中，告诉它“JavaDocs”。

现在，当您为该库中的类调用 javadoc 时，您将看到它。但是，您必须为每个需要 javadoc 的库执行此操作。

如果由于某种原因您没有安装本地 javadoc，您可以附加 javadoc 的远程 url。为此，请使用下方带有小地球的加号按钮，然后粘贴 javadoc url。对于 Firebase，这是 https://firebase.google.com/docs/reference/android对于 Play 服务，那就是 https://developers.google.com/android/reference/

完成所有这些手动工作并不是很好，但至少它可以让您在 IDE 中获得 javadoc。

如果您想编写一个脚本来为您使用的所有内容附加它，请知道此过程实际上只是修改 .idea/libraries 下的文件。您可以很容易地观察在 IDE 中进行更改时被修改的 javadoc XML 元素，如果需要，您可以自己编写/编辑更改。