selenium webdriver学习 19 – 我们的构建文件CrazyFunBuild (译)

悠悠小仙仙

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

1. <font size="4">java_test(name = "single",
   
2. srcs = [
   
3. "SingleTestSuite.java",
   
4. ],
   
5. deps = [
   
6. ":tests",
   
7. "//java/server/src/org/openqa/selenium/server",
   
8. "//java/client/test/org/openqa/selenium/v1:selenium-backed-webdriver-test",
   
9. "//java/client/test/org/openqa/selenium/firefox:test",
   
10. ]  ])</font>

复制代码

它突出了大部分关键思想。首先，它声明了 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

• Output: 如果“ srcs ”属性文件被设置， JAR 文件以“ name ”属性被命名。
• 隐含 Targets: run ( 如果 “main” 属性指定 ), project, project-srcs, uber, zip
• 必须的 Attributes: “ name ”并至少有一个 “srcs” 或 “deps”
  

java_test

八戒你干嘛

很棒！我们的楼主