2

我将 Gradle (v2.3) 用于包含多个 Scala 子项目的项目。为每个子项目单独生成 ScalaDoc 按预期工作（运行gradle :project-a:scaladoc或gradle :project-b:scaladoc）。

但是如何获得所有Scala 子项目的单个ScalaDoc ？下面的最小项目在执行时会导致“Cannot invoke method withInputStream() on null object”错误
gradle scaladoc --info：

Starting Build
Compiling settings file '/tmp/gradle-scaladoc-test/settings.gradle' using StatementExtractingScriptTransformer.
Compiling settings file '/tmp/gradle-scaladoc-test/settings.gradle' using BuildScriptTransformer.
Settings evaluated using settings file '/tmp/gradle-scaladoc-test/settings.gradle'.
Projects loaded. Root project using build file '/tmp/gradle-scaladoc-test/build.gradle'.
Included projects: [root project 'some project', project ':project-a', project ':project-b']
Evaluating root project 'some project' using build file '/tmp/gradle-scaladoc-test/build.gradle'.
Compiling build file '/tmp/gradle-scaladoc-test/build.gradle' using StatementExtractingScriptTransformer.
Compiling build file '/tmp/gradle-scaladoc-test/build.gradle' using BuildScriptTransformer.
Evaluating project ':project-a' using empty build file.
Evaluating project ':project-b' using empty build file.
All projects evaluated.
Selected primary task 'scaladoc' from project :
Tasks to be executed: [task ':scaladoc', task ':project-a:compileJava', task ':project-a:compileScala', task ':project-a:processResources', task ':project-a:classes', task ':project-a:scaladoc', task ':project-b:compileJava', task ':project-b:compileScala', task ':project-b:processResources', task ':project-b:classes', task ':project-b:scaladoc']
:scaladoc (Thread[main,5,main]) started.
:scaladoc
Executing task ':scaladoc' (up-to-date check took 0.448 secs) due to:
  No history is available.
:scaladoc FAILED
:scaladoc (Thread[main,5,main]) completed. Took 0.768 secs.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':scaladoc'.
> Cannot invoke method withInputStream() on null object

* Try:
Run with --stacktrace option to get the stack trace. Run with --debug option to get more log output.

BUILD FAILED

Total time: 5.198 secs
Stopped 0 compiler daemon(s).

目录结构：

├─ project-a/
│   └─ src/
│       └─ main/
│           └─ scala/
│               └─ package_a/
│                   └─ A.scala
├─ project-b/
│   └─ src/
│       └─ main/
│           └─ scala/
│               └─ package_b/
│                   └─ B.scala
├─ build.gradle
└─ settings.gradle

构建.gradle

subprojects {
  repositories { 
    mavenCentral() 
  }

  apply plugin: 'scala'

  dependencies {
    compile 'org.scala-lang:scala-library:2.11.6'
  }

  tasks.withType(ScalaCompile) {
    scalaCompileOptions.additionalParameters = ['-unchecked', '-deprecation', '-feature']
    scalaCompileOptions.useAnt = false
  }
}


task scaladoc(type: org.gradle.api.tasks.scala.ScalaDoc) {
  group = 'Documentation'
  description = 'Aggregated ScalaDoc documentation.'
  title = 'Title of documentation'
  destinationDir = new File(buildDir, "aggregated-api")

  source subprojects.collect { project ->
    project.sourceSets.main.allScala
  }

  scalaClasspath = files(subprojects.collect { project ->
    project.sourceSets.main.compileClasspath
  })

  classpath = files(subprojects.collect { project ->
    project.sourceSets.main.compileClasspath
  })
}

设置.gradle

rootProject.name = 'some project'
include 'project-a', 'project-b'

斯卡拉 

package package_a
case class A(value: Int)

斯卡拉 

package package_b
case class B(value: Int)

我能找到的唯一类似问题是“Gradle Fails to Compile Basic Sc​​ala Project”，但在这里没有帮助（关于 Gradle 1.3）。

4

2 回答 2

3

我知道这个问题已经有一段时间了，但是因为我刚刚遇到了完全相同的问题......

我通过以下方式解决了它：

task aggregatedScaladocs(type: ScalaDoc, description: 'Generate scaladocs from all child projects as if it were a single project', group: 'Documentation') {
destinationDir = file("$buildDir/docs/scaladoc")
title = "$project.name $version API"

subprojects.each { proj ->
    proj.tasks.withType(ScalaDoc).each {
        source += proj.sourceSets.main.allJava
        source += proj.sourceSets.main.allScala
        classpath += proj.sourceSets.main.compileClasspath
        excludes += scaladoc.excludes
        includes += scaladoc.includes
    }
}

}

希望它会在某个时候对某人有所帮助。

于 2017-08-31T15:39:46.327 回答
0

对于Gradle 6.x，我需要使用 @juwi 稍作修改的答案版本。

task aggregatedScaladocs(type: ScalaDoc, description: 'Generate scaladocs from all child projects as if it were a single project', group: 'Documentation') {
    destinationDir = file("$buildDir/docs/scaladoc")
    title = "$project.name $version API"
    classpath = project.files([])
    scalaClasspath = project.files([])

    subprojects.each { proj ->
        proj.tasks.withType(ScalaDoc).each {
            source proj.sourceSets.main.allJava
            source proj.sourceSets.main.allScala
            classpath += proj.scaladoc.classpath
            scalaClasspath += proj.scaladoc.scalaClasspath
            exclude proj.scaladoc.excludes
            include proj.scaladoc.includes
        }
    }
}
于 2020-02-11T10:55:41.000 回答