【问题标题】：Gradle: Attach source and javadoc to local file in IntelliJIdeaGradle：将源代码和 javadoc 附加到 IntelliJIdea 中的本地文件
【发布时间】：2013-11-21 23:28:26
【问题描述】：

我正在使用 gradle (v1.9) 和 IntelliJIdea (v12.1.6)。我有一个简单的 java 项目和一个 build.gradle 文件。一个依赖项不在 maven Central 上，因此我将 jar 放在 lib 文件夹中。

问题

对于 maven Central 上的依赖项，gradle 使用 javadoc 和源代码（位于 $project/.idea/libraries 中）正确构建库 xml 文件。对于本地依赖项（JNativeHook），没有附加这样的源代码或 javadoc。作为对比，两个xml文件：

带有源代码和 javadoc 附件

<component name="libraryTable">
  <library name="jackson-core-2.2.3">
    <CLASSES>
      <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.fasterxml.jackson.core/jackson-core/2.2.3/1a0113da2cab5f4c216b4e5e7c1dbfaa67087e14/jackson-core-2.2.3.jar!/" />
    </CLASSES>
    <JAVADOC>
      <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.fasterxml.jackson.core/jackson-core/2.2.3/6021971970a43ae0c22f378cfb5813af869caab/jackson-core-2.2.3-javadoc.jar!/" />
    </JAVADOC>
    <SOURCES>
      <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.fasterxml.jackson.core/jackson-core/2.2.3/b1c4a6c3c26dfc425efd53c00217868b60d07de9/jackson-core-2.2.3-sources.jar!/" />
    </SOURCES>
  </library>
</component>

没有源代码和 javadoc 附件

<component name="libraryTable">
  <library name="JNativeHook-1.1.4">
    <CLASSES>
      <root url="jar://$PROJECT_DIR$/lib/JNativeHook-1.1.4.jar!/" />
    </CLASSES>
    <JAVADOC />
    <SOURCES />
  </library>
</component>

其他信息

构建文件如下所示：

apply plugin: 'java'
apply plugin: 'idea'
idea {
    module {
        downloadJavadoc = true
        downloadSources = true
    }
}

repositories {
    mavenCentral()
    flatDir(dirs: 'lib')
}

dependencies {
    // Will be fetched from mavenCentral()
    compile 'com.fasterxml.jackson.core:jackson-core:2.2.3'
    // Will be fetched from the 'lib' directory (see second repository)
    compile 'org.jnativehook:JNativeHook:1.1.4'
}

sourceCompatibility = 1.7
version = '0.1'
jar {
    manifest {
        attributes 'Implementation-Title': 'ScreenShotter',
                   'Implementation-Version': version,
                   'Main-Class': 'de.fau.screenshotter.ScreenShotter'
    }
    from {
        configurations.compile.collect { it.isDirectory() ? it : zipTree(it) }
    }
}

我的项目结构如下：

问题 (tldr;)

如何告诉 gradle 创建适当的 javadoc 和源条目并将它们添加到 IntelliJ 使用的 xml 文件中？

【问题讨论】：

也面临同样的问题，但使用的是 eclipse .classpath 文件而不是 intelliJ。

标签： intellij-idea gradle

【解决方案1】：

如果你有一个二进制存储库管理器，那么一定要在那里发布模块，这样可以立即解决问题。否则，您必须使用idea.module.iml.whenMerged 挂钩或idea.module.iml.withXml 挂钩微调idea.module。这将需要一些编码，而且我没有准备好解决方案。有关 API 详细信息，请参阅 Gradle 构建语言参考中的 IdeaModule。

【讨论】：