附录：.scala 构建定义 

本页面描述了.scala构建定义的旧的风格。在以前的版本的sbt中，.scala是用来创建多项目构建定义的唯一方式，但sbt 0.13 添加了多项目.sbt 生成定义，这也是推荐的样式。

这里假设你已经阅读了之前的章节，尤其是 .sbt 构建定义和更多关于设置。

关联 build.sbt 和 Build.scala 

为了融合.sbt 和 .scala 文件在你的构建定义中，你需要理解他们是如何关联的。

下面两个文件描述了这个过程。第一，如果你的项目在 hello 文件夹内，创建 hello/project/Build.scala：

import sbt._
import Keys._

object HelloBuild extends Build {
  val sampleKeyA = settingKey[String]("demo key A")
  val sampleKeyB = settingKey[String]("demo key B")
  val sampleKeyC = settingKey[String]("demo key C")
  val sampleKeyD = settingKey[String]("demo key D")

  override lazy val settings = super.settings ++
    Seq(
      sampleKeyA := "A: in Build.settings in Build.scala",
      resolvers := Seq()
    )

  lazy val root = Project(id = "hello",
    base = file("."),
    settings = Seq(
      sampleKeyB := "B: in the root project settings in Build.scala"
    ))
}

现在，创建 hello/build.sbt：

sampleKeyC in ThisBuild := "C: in build.sbt scoped to ThisBuild"

sampleKeyD := "D: in build.sbt"

打开 sbt 终端命令窗口。敲入 inspect sampleKeyA，你将会看到：

[info] Setting: java.lang.String = A: in Build.settings in Build.scala
[info] Provided by:
[info]  {file:/home/hp/checkout/hello/}/*:sampleKeyA

然后敲入 inspect sampleKeyC，你将会看到：

[info] Setting: java.lang.String = C: in build.sbt scoped to ThisBuild
[info] Provided by:
[info]  {file:/home/hp/checkout/hello/}/*:sampleKeyC

注意 “Provided by” 显示两个 value 具有相同作用范围。那是 .sbt 文件中的 sampleKeyC in ThisBuild 等同与放置在 .scala 文件 Build.settings 列表中的一个设置。sbt 会从两个地方抽取构建范围内的设置，来创建构建定义。

然后，inspect sampleKeyB：

[info] Setting: java.lang.String = B: in the root project settings in Build.scala
[info] Provided by:
[info]  {file:/home/hp/checkout/hello/}hello/*:sampleKeyB

注意 sampleKeyB 是被作用的这个项目： ({file:/home/hp/checkout/hello/}hello) 而不是整个构建 ({file:/home/hp/checkout/hello/})。

你应该已经猜测到了，inspect sampleKeyD 等同于 sampleKeyB：

[info] Setting: java.lang.String = D: in build.sbt
[info] Provided by:
[info]  {file:/home/hp/checkout/hello/}hello/*:sampleKeyD

sbt 从 .sbt 文件附加设置到 Build.settings 和 Project.setting 的设置，换句话说，.sbt 设置拥有优先权。 尝试改变 Build.scala，使得它能设置健值 sampleC 或者 sampleD，他们已经在 build.sbt 设置过。build.sbt 中的设置应该能“赢”过 Build.sbt。

你也许会注意到另一要点：sampleKeyC 和 sampleKeyD 是可以在 build.sbt 内部获得的。这是因为 sbt 引入 Build 中的内容到 .sbt 文件中。在这种情况下，import HelloBuild._ 是被隐含引入在 build.sbt 文件中。

总结：

• 在 .scala 文件中，可以在 Build.settings 中增加设置，这些设置自动成为构建作用域。
• 在 .scala 文件中，可以在 Project.settings 中增加设置，这些设置自动成为工程作用域。
• 任何在 .scala 中的 Build 对象将会把它的内容导入到 .sbt 文件中。
• 在 .sbt 文件中的设置被 追加 到 .scala 中的设置。
• 在 .sbt 文件中的设置是在项目作用域里，除非你指定它在其他域。

交互模式中的构建定义项目 

你现在可以切换到 sbt 命令行的交互模式，让在 project/ 目录下的构建定义项目作为当前项目。可以输入 reload plugins 来达到目的。

> reload plugins
[info] Set current project to default-a0e8e4 (in build file:/home/hp/checkout/hello/project/)
> show sources
[info] ArrayBuffer(/home/hp/checkout/hello/project/Build.scala)
> reload return
[info] Loading project definition from /home/hp/checkout/hello/project
[info] Set current project to hello (in build file:/home/hp/checkout/hello/)
> show sources
[info] ArrayBuffer(/home/hp/checkout/hello/hw.scala)
>

如上所示，你可以用 reload return 离开构建定义项目，回到你平常的项目。

提醒：它总是不可变的 

认为在 build.sbt 的设置将被添加到 Build 和 Project 对象中的 settings 字段是错误的。取而代之的是，Build 和 Project 中的 settings 列表，以及 build.sbt 中的设置，被 串连到另一个不可变的列表中，然后被 sbt 使用。该 Build 和 Project 对象是“不可变配置”形成完整构建定义的一部分。

事实上，也有设置的其他来源。他们被追加顺序如下：

• 来自你的 .scala 设置文件中的 Build.settings 和 Project.settings。
• 你的用户账号全局设置；例如在 ~/.sbt/0.13/global.sbt 中你可以定义影响你 所有 项目的设置。
• 插件注入的设置，参见接下来的使用插件。
• 项目下 .sbt 文件中的设置。
• 构建定义项目（即 project 中的项目）有来自全局插件（~/.sbt/0.13/plugins/）的设置。使用插件解释了更多的内容。

后面的设置会覆盖前面的。全部的设置列表构成了完整的构建定义。