原文：CrazyFunBuild

WebDriver 是一个庞大的工程。如果我们试着把所有的东西都放在一个单独的构建文件里，它最终会变得难于管理。我们知道会这样。因为我们已经尝试过了。所以我们把单独的 Rakefile 分成一系列 build.desc 文件。它们描述构建的一部分。

让我们看一个 build.desc 文件。这是测试主要的 build.desc 部分：

java_test(name = "single",
  srcs = [
    "SingleTestSuite.java",
  ],
  deps = [
    ":tests",
    "//java/server/src/org/openqa/selenium/server",
    "//java/client/test/org/openqa/selenium/v1:selenium-backed-webdriver-test",
    "//java/client/test/org/openqa/selenium/firefox:test",
  ]  ])

它突出了大部分关键思想。首先，它声明了 target, 在这种情况下有一个单独的 java_test target. 每一个 target 有一个 name 属性。

Target Names

Build.desc 文件的位置和名字相结合用来产生 rake 任务。所有的任务名字是以“ // ”为前辍，后面跟前所包含的 build.desc 文件相对于 Rakefile 的目录路径，然后是一个“：”，最后是 build.desc 里面 target 的名字。看一个例子就很容易理解：）

 由此 产生的 rake 任务例子 //java/client/test/org/openqa/selenium:single

简写 Target Names

作为一种快捷方式，如果一个 target 是以包涵在 build.desc 文件的目录命名的，你可以省略 rake 任务名字冒号后 面 的部分。这样 //java/server/src/org/openqa/selenium/server 等同于 //java/server/src/org/openqa/selenium/server:server .

隐含的Targets

构建规则支持隐含的 targets, 并提供正常构建 target 一个相关的扩展。例子包括生成源代码的档案，或者运行测试。这些通过附加一个冒号和隐含的 target 的名字给构建规则的全称而得到声明。这样我们可以使用 "//java/client/test/org/openqa/selenium:single:run" 来运行 tests 。

 下面 描述的每一个规则都有一个和他们相关的隐含 target.

Outputs

每一个 target 在“ build.desc ”文件中指定只生成一个唯一的输出。这很重要。请注意它。一般，所有的输出文件以对应的任务名被放在 build 目录下。如： "//java/org/openqa/selenium/server" 会以这样输出 "build/java/org/openqa/selenium/server.jar" 。 构 建规则应该输出名字和它们生成文件的位置。

Dependencies

看一下在上面“ single ” target 里的“ deps ”部分。“ tests ”是指在当前“ build.desc ”文件下的一个 target, 在这种情况下，它是指上面的“ java_library ”。你可以看出它将涉及多个全路径。例如 "//java/server/src/org/openqa/selenium/server" 这涉及在一个crazy fun build.desc 文件里 面的 另一个target 。

Browsers

Py_test 和js_test 规则对多浏览器运行相同的tests 有特殊的处理。相关的特殊浏览器meta 信息放在 rake-tasks/browsers.rb 中。一般在 target 名字后追加 _browsename （浏览器名字）来使用它 ; 如果没有 _browsename 后辍，那 tests 将在所有浏览器中运行。

举个例子，如果我们有一个 js_test 规则 //foo/bar, 我们将通过 target //foo/bar_ff:run 在 firefox 中运行或者我们可以通过 target //foo/bar:run 对所有浏览器有效。

Build Targets

   一个你能使用的有效 targets 简单描述。

Common Attributes

所有构建 target 都需要下面属性

常用属性

java_library

l  Output: 如果“ srcs ”属性文件被设置， JAR 文件以“ name ”属性被命名。

l  隐含 Targets: run ( 如果 "main" 属性指定 ), project, project-srcs, uber, zip

l  必须的 Attributes: “ name ”并至少有一个 "srcs" 或 "deps"

java_test

....（下面的和上面的都差不多就不译了，：P）