sbt笔记六 More Kinds of Setting（待续）

http://www.scala-sbt.org/release/docs/Getting-Started/More-About-Settings.html

Refresher: Settings

记住，构建定义建立一个Setting列表，而后这个列表用于转换sbt的构建描述（它是键值对的映射）。一个Setting是一个将sbt早先的映射做为输入、一个新的映射做为输出的转换。这个新映射做为sbt的新状态。

不一样的setting经过不一样的方式转换这个映射。早些时候，你已经读到:=方法了。

:=建立的Setting在新的，改变了的映射中设置了固定的，常量的值。例如，若是你用setting name := "hello"来转换一个映射，新的映射有一个字符串"hello"存储在name键。

Settings must end up in the master list of settings to do any good（看不懂）（在build.sbt中的行都自动结束在list中，可是在.scala文件中你能够错误地建立一个Setting却没有放到sbt可以发现的地方（but in a .scala file you can get it wrong by creating a Setting without putting it where sbt will find it））

追加到原先的值：+=和++=

用:=替换是最简单的转换，可是key也有其余的方法，若是SettingKey[T]中的T是一个序列，也就是说，key的值类型是一个序列，你能够向序列追加值，而不是替换它。

• +=能够向序列追加单个元素。
• ++=能够与另外一个序列链接。

例如，Compile做用域中的sourceDirectories键有一个Seq[File]的值。默认状况下，它的值包含src/main/scala。若是你也想编译source文件夹下的源码，能够添加这个文件夹：

sourceDirectories in Compile += new File("source")

或者，用sbt包中更便利的file()函数：

sourceDirectories in Compile += file("source")

（file()仅建立一个新的File。）

能够用++=同时添加多个文件夹：

sourceDirectories in Compile ++= Seq(file("sources1"), file("sources2"))

Seq(a, b, c, ...)是Scala中建立序列的标准语法。

完整替换默认源码文件夹，无疑要用:=：

sourceDirectories in Compile := Seq(file("sources1"), file("sources2"))

转换一个值（Transforming a value）：~=

若是想向前追加Compile中的sourceDirectories，或过滤掉默认文件夹中的一个，要怎么作呢？

你能够建立一个依赖于先前值的Setting。

• ~=将一个函数应用到setting先前的值，并建立一个相同类型的新值。

修改Compile中的sourceDirectories，能够以下方式使用~=：

// filter out src/main/scala
sourceDirectories in Compile ~= { srcDirs => srcDirs filter(!_.getAbsolutePath.endsWith("src/main/scala")) }

在这里，srcDirs是匿名函数的入参，而且Compile中的sourceDirectories会被传入匿名函数。这个函数的结果将做为Compile中sourceDirectories的新值。

一个简单的例子：

// make the project name upper case
name ~= { _.toUpperCase }

若是key是SettingKey[T]或TaskKey[T]类型，则传入的函数必须是T => T类型的。这个函数将key的值转换为类型相同的另外一个值。

基于另外一个key的值，计算一个值：<<=

~=根据key先前的值来定义一个新值。但若是你想根据另外一个key的值来定义一个新值呢？

• <<=容许你用另一个任意的key的值，来计算一个新的值。

<<=有一个Initialize[T]类型的参数。一个Initialize[T]的实例是一个计算，他将一个key集合所关联的值做为输入，并返回一个T类型的值（基于其余的值）。它初始化了一个T类型的值。

给定一个Initialize[T]，<<=返回一个Setting[T]（就像:=，+=，~=等）。

微不足道的Initialize[T]：用<<=依赖于另外一个key

全部的key都扩展自Initialize特质。因此key就是最简单的Initialize：

// useless but valid
name <<= name

看成为一个Initialize[T]，一个SettingKey[T]计算它当前的值。因此name <<= name将name的值，设为name已有的值。

若是你要将一个key设为另外一个key，这就比较有用。两个key必须拥有相同的值类型。

// name our organization after our project (both are SettingKey[String])
organization <<= name

若是值类型不一致，你须要从Initialize[T]转换成另外一个类型，就像Initialize[S]。这在Initialize的apply方法中完成，像这样：

// name is a Key[String], baseDirectory is a Key[File]
// name the project after the directory it's inside
name <<= baseDirectory.apply(_.getName)

在Scala中apply很特别，这意味着你能够用函数语法调用这个对象；因此能够这么写：

name <<= baseDirectory(_.getName)

它用_.getName函数转换baseDirectory的值，函数_.getName获得一个File并返回String。getName是标准java.io.File对象的方法。

Setting依赖

在setting name <<= baseDirectory(_.getName)中，name有一个baseDirectory的依赖。若是把上文放在build.sbt中，而且运行sbt交互控制台，而后输入inspect name，你就会看到（局部）：

[info] Dependencies:
[info]  *:base-directory

这就是sbt如何知道一个setting依赖于另外一个setting。牢记一些setting是描述任务的，因此这种方式也建立任务间的依赖。

例如，若是你运行inspect compile，你将看到它依赖于另外一个key compile-inputs，而且若是你运行inspect compile-inputs，它依次依赖于其余的key。跟随依赖链而后奇迹发生了。例如当你输入compile，sbt会自动执行update。它可以工做是由于，compile计算所需的值，须要sbt先执行update计算。

经过这种方式，全部sbt中的构建依赖都是自动的，而不是明确地定义。若是你在另外一个计算中使用一个key的值，那么这个计算就依赖于那个key。这很管用！

复杂的Initialize[T]：用<<=依赖多个key

为了支持多个key的依赖，sbt为Initialize对象元组添加apply和identity方法。在Scala中，元组写成(1, "a")（它的类型是(Int, String)）。

2013-1-28 22:40

2012-1-28 不要问为何这篇没有内容，我不会告诉你我把它扔家里了。 家里电脑没有啊，为何找不到了呢，我明明记得这篇我看过的，难道是光看没写下来吗？好吧，再找时间写吧。 找到了，哈哈，不过就完成了一半，先粘上来吧，别不当心又找不到了。前面好几篇都忘了原文，这篇把原文连接加上，而后赶忙睡觉去，扛不住了。