selenium webdriver学习19我们的构建文件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 都需要下面属性
属性名字 类型 含意
Name string 用来生成 rake target 和（常常）产生目录的名字

常用属性
属性名字 类型 含意
Srcs array 为这一 target 而构建原始代码
Deps array 这一 target 的先决条件

java_library
l Output: 如果“ srcs ”属性文件被设置， JAR 文件以“ name ”属性被命名。
l 隐含 Targets: run ( 如果 "main" 属性指定 ), project, project-srcs, uber, zip
l 必须的 Attributes: “ name ”并至少有一个 "srcs" 或 "deps"
java_test
属性名称 类型 含意
Deps Array 同上
Srcs Array 同上
Resources Array