Gradle Scala 插件(2)-木庄网络博客

除非显式配置了一个 task 的 scalaClasspath ，否则 Scala（基础）插件会尝试推断该 task 的 classpath。以如下方式进行：

如果在 classpath 中找到 scala-library Jar ，并且该项目已经在至少一个仓库中声明了它，那么相应的 scala-compiler 的仓库依赖将添加到 scalaClasspath中。
其他情况，该 task 将执行失败，并提示无法推断 scalaClasspath。

公约属性

Scala 插件没有向 project 添加任何的公约属性。

source set 属性

Scala 的插件向 project 的每一个 source set 添加了下列的公约属性。你可以在你的构建脚本中，把这些属性当成是 source set 对象中的属性一样使用。

表 25.4. Scala 插件 - source set 属性

属性名称	类型	默认值	描述
`scala`	SourceDirectorySet (read-only)	非空	该source set 中的 Scala 源文件。包含在 Scala 源目录中找到的所有的`.java`文件，并排除所有其他类型的文件。
`scala.srcDirs`	`Set<File>`.	`name`/scala]	源目录包含该 source set 中的 Scala 源文件。此外可能还包含用于联合编译的 Java 源文件。
`allScala`	FileTree (read-only)	非空	该source set 中的所有 Scala 源文件。包含在 Scala 源目录中找到的所有的`.scala`文件。

这些属性由一个 ScalaSourceSet 的约定对象提供。

Scala 的插件还修改了一些 source set 的属性：

表 25.5. Scala 插件 - source set 属性

属性名称	修改的内容
`allJava`	添加在 Scala 源目录中找到的所有`.java`文件。
`allSource`	添加在 Scala 的源目录中找到的所有源文件。

Fast Scala Compiler

Scala 插件包含了对 fsc，即 Fast Scala Compiler 的支持。fsc 运行在一个单独的进程中，并且可以显著地提高编译速度。

启用 Fast Scala Compiler

build.gradle

compileScala
    scalaCompileOptions.useCompileDaemon = true
    // optionally specify host and port of the daemon:
    scalaCompileOptions.daemonServer = "localhost:4243"
}

注意，每当 fsc 的编译类路径的内容发生变化时，它都需要重新启动。(它本身不会去检测编译类路径的更改。）这使得它不太适合于多项目的构建。

在外部进程中编译

当 scalaCompileOptions.fork 设置为 true 时，编译会在外部进程中进行。fork 的详细情况依赖于所使用的编译器。基于 Ant 的编译器 (scalaCompileOptions.useAnt = true) 将为每个 ScalaCompile 任务 fork 一个新进程，而默认情况下它不进行 fork。基于 Zinc 的编译器 (scalaCompileOptions.useAnt = false) 将利用 Gradle 编译器守护进程，且默认情况下也是这样。

外部过程默认使用JVM 的的默认内存设置。如果要调整内存设置，请根据需要配置scalaCompileOptions.forkOptions ：

调整内存设置

build.gradle

tasks.withType(ScalaCompile) {
    configure(scalaCompileOptions.forkOptions) {
        memoryMaximumSize = '1g'
        jvmArgs = ['-XX:MaxPermSize=512m']
    }
}

增量编译

增量编译是只编译那些源代码在上一次编译之后有修改的类，及那些受这些修改影响到的类，它可以大大减少 Scala 的编译时间。频繁编译代码的增量部分是非常有用的，因为在开发时我们经常要这样做。

Scala 插件现在通过集成 Zinc 来支持增量编译，它是 sbt 增量 Scala 编译器的一个单机版本。若要把 ScalaCompile 任务从默认的基于 Ant 的编译器切换为新的基于 Zinc 的编译器，需要将 scalaCompileOptions.useAnt 设置为 false：

激活基于 Zinc 编译器

build.gradlev

tasks.withType(ScalaCompile) {
    scalaCompileOptions.useAnt = false
}

除非在 API 文档中另有说明，否则基于 Zinc 的据编译器支持与基于 Ant 的编译器完全相同的配置选项。但是，要注意的是，Zinc 编译器需要 Java 6 或其以上版本来运行。这意味着 Gradle 本身要使用 Java 6 或其以上版本。

Scala 插件添加了一个名为 zinc 的配置，以解析 Zinc 库及其依赖。如果要重写 Gradle 默认情况下使用的 Zinc 版本，请添加一个显式的 Zinc 依赖项（例如zinc "com.typesafe.zinc:zinc:0.1.4"）。无论使用哪一个 Zinc 版本，Zinc 都是使用在scalaTools配置上找到的 Scala 编译器。

就像 Gradle 上基于Ant 的编译器一样，基于 Zinc 的编译器支持 Java 和 Scala 代码的联合编译。默认情况下，在 src/main/scala 下的所有 Java 和 Scala 代码都会进行联合编译。使用基于 Zinc 的编译器时，即使是 Java 代码也将会进行增量编译。

增量编译需要源代码的相关性分析。解析结果进入由 scalaCompileOptions.incrementalOptions.analysisFile 所指定的文件（它有一个合理的默认值）。在多项目构建中，分析文件被传递给下游的 ScalaCompile 任务，以启用跨项目的增量编译。对于由 Scala 插件添加的 ScalaCompile 任务，无需对这一点进行配置。对于其他的 ScalaCompile 任务，需要根据类文件夹或 Jar archive 的代码中，是哪一个的代码被传递给 ScalaCompile 任务的下游类路径，把ScalaCompileOptions.incrementalOptions.publishedCode 配置为指向它们。注意，如果publishedCode 设置不正确，上游代码发生变化时下游任务可能不会重新编译代码，导致编译结果不正确。

由于依赖分析的系统开销，一次干净的编译或在代码有了较大的更改之后的编译，可能花费的时间要长于使用基于 Ant 的编译器。对于 CI 构建和版本的构建中，我们目前推荐使用基于 Ant 的编译器。

注意现在 Zinc 基于守护进程模式的 Nailgun 还不支持。相反，我们打算加强 Gradle 自己的编译器守护进程，使得在跨 Gradle 调用时继续存活，利用同一个 Scala 编译器。这将会为 Scala 编译带来另一个方面上的明显加速。