Android Studio发布aar混淆库及其javadoc。

Question

我已经在私有Artifactory中发布了Android库（类似于这样），并且生成的Javadoc与aar库一起作为jar文件发布到Artifactory中。但是，当从另一个Android Studio项目中使用该库时，Android Studio快速文档中不会自动显示Javadoc。
经过更多试验和错误，似乎如果在发布时未对库进行混淆，则Javadoc将显示在Android Studio的快速文档中。
那么，如何发布我的混淆库并在Android Studio中为库用户显示javadoc而无需进行额外配置？
[编辑]
发布的库文件包括：
aar、javadoc.jar、sources.jar、pom文件。
目前，sources.jar允许开发人员反编译未混淆的源代码，但仍无法为库提供javadoc。

- ceekay

---

你解决了这个问题吗？我也在苦苦挣扎，但迄今为止还没有找到解决方案。 - Marty

@Marty 我还没有找到答案。目前，我仍然将开发人员引用到一个单独的HTML Javadocs页面。 - ceekay

谢谢您的回复。我正在做同样的事情，目前似乎还没有更好的方法 :( - Marty

Answer 1

您需要发布“sources”版本。如果我理解正确，您希望使用您的aar的开发人员能够查看带有注释的类的文档。

在您的gradle文件中，创建一个“source”任务，如下所示：

task javadocTask(type: Jar) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

task sourcesTask(type: Jar) {
    classifier = 'sources'
    from sourceSets.main.allSource 
    //Or exact project path if you don't have sourceSets : from "YOUR_PROJECT/src/main/java"
}

artifacts {
    archives sourcesTask
    archives javadocTask
}

- Dus

---

这就是问题所在...所有的文档都在源代码中，而Javadocs是外部的（显然你可以打开它，但这将是手动操作，而不是通过代码检查）。 - Dus

Answer 2

首先，您需要确保未混淆库的公共API。

默认情况下，库的javadoc不会被下载，除非明确指定。您需要在应用程序的主build.gradle中添加以下配置。

idea {
  module {
    downloadJavadoc = true
   }
}

通过从右上角点击“立即同步”链接或点击以下图标来将项目与gradle文件同步： 与gradle文件同步项目

Android Studio将下载javadoc并将其适当地链接到您的API。

如果javadoc仍然不可见，则尝试从“文件”>“无效缓存/重启”>“无效和重启”中使Android Studio失效并重新启动。

- Sagar