Android Studio Aar使用Javadoc混淆了库发布

Question

我已经像这样在私人Artifactory中发布了Android库。 生成Javadoc并将其作为jar文件与aar库一起发布到工件。

但是，当使用另一个Android Studio项目中的库时，javadoc不会自动显示在Android Studio快速文档中。
经过更多的试验和错误，如果发布时未混淆库，似乎Javadoc将显示在Android Studio的快速文档中

如何在Android Studio中为库用户发布混淆的库并显示javadoc，而无需进行其他配置？

[编辑]
已发布的库文件为：
aar，javadoc.jar，sources.jar，pom文件

当前，sources.jar允许开发人员对未混淆的源代码进行反向工程，但仍不提供该库的javadoc。

Answer 1

您还需要进行“源代码”发布。 如果我正确理解您的要求，那么您希望使用aar的开发人员能够看到带有注释的课程文档。

在gradle文件中，创建一个“源”作业，如下所示：

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
}

Answer 2

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

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

idea {
  module {
    downloadJavadoc = true
   }
}

通过单击右上角的立即同步链接或单击以下图标，将项目与gradle文件同步 ：将项目与gradle文件同步

Android studio将下载javadoc并将其正确链接到您的API。

如果javadoc仍然不可见，请尝试使缓存无效并从以下位置重新启动android studio：文件>无效缓存/重新启动>无效并重新启动。