selenium webdriver学习 18 – 构建webdriver

悠悠小仙仙

准备环境
对所有版本的webdriver:

• Java JDK 5或以上（如果没有安装从oracle的网站上下载）
• 源代码（如果没有，导出源代码,可参考：selenium webdriver学习（十七））
  

另外，interntetExplorerDriver需要一些额外的组件并且只能构建在windows系统上。

• Visual Studio 2010 Professional及以上
• “msbuild”需要加入到PATH路径
  

构建基于Rake,一个著名的Ruby构建工具。我们提供你在构建此项目的所有gems，虽然这并不是推荐以这种方式来构建。绑定JRuby jar,通过“go”包装调用，不需要其它设置就包括了所有的依赖关系。
构建
构建脚本决定哪部分webdriver被构建。当有本地组件构建，构建组件将在返回二进制预构建文件之前尝试去组织他们。假如你已经把源代码放在$WEBDRIVER_HOME目录下，现在：
cd $WEBDRIVER_HOME   # 保存Rakefile文件的目录
go
# 或者在UNIX系统上：
./go
这不仅将完全编译源代码，而且还会运行所有需要运行的tests。如果都通过，则你已经成功构建了WebDriver!
在CrazyFunBuild一节中,有关于如何构建webdriver系统更加详细的说明.
默认情况下，构建输出有一些简洁。一个java编译阶段的日志保存在”build/build_log.xml”。你也可以
通过增加“log=true”去构建从而得到更详细的输出。如：
./go //java/client/test/org/openqa/selenium/support:test:run log=true
最后，你能得到更详细的日志通过修改Rakefile文件和注释掉下面的行：
verbose false
测试日志被保存在”build/test_logs”文件里。
提示
构建selenium server
你将得到一个这样的长方式：
go //java/server/src/org/openqa/selenium/remote/server:server:uber //java/client/src/org/openqa/selenium:client-combined:project
它将构建出单独的”selenium server” jar 和客户端。构建输出将告诉你输出文件放在哪里。
你也能这样替代第二目标：
//java/client/src/org/openqa/selenium:client-combined:uber
隐含目标“uber” 构建一个单独的“uber jar”包涵所有编译的java和第三方依赖。“project”隐含目标和“uber”类似，但不包括第三方依赖。
源代码
//java/server/src/org/openqa/grid/selenium:selenium:project-srcs 将给你一些源代码.
构建Android driver
看 Android Wiki
有用的目标
所有下面的都要用“go”执行。
对于所有的：
目标       目的
clean      删除所有构建文件
对于java：
目标                                      目的
test_java                               运行所有适用的java test
test_htmlunit                       运行所有的HtmlUnitDriver tests
test_ie                                    运行所有的InterExplorerDriver tests
test_firefox                           运行所有的FirefoxDriver tests
selenium-server-standalone          构建单独的server
//java/client/test/org/openqa/selenium:single:run     运行SingleTestSuite
有用的参数：
参数                                目的
haltonerror                   标识决定“go”遇到错误时是否停止。默认为true.
hatltonfailure                标识决定“go”遇到失败时是否停止。默认为true.
method                          如果设置，仅指定的test被执行
onlyrun                          如果设置，仅指定的类被执行
log              标识指定日志是否在控制台输出，而不是在文件中输出。默认为flase
suspend                        如果设置，暂停JVM直到一个调试程序在运行tests之前链接。结合调试很有用。默认为flase
debug                             当启动JVMs运行tests时，启用java远程调试器。结合调试很有用。默认为flase。默认调试端口为5005
offline                             如果设置，不用尝试从网络下载任何组件（如：the gecko sdk）默认为flase。
leaverunning                如果设置，浏览器将不会在最后一个test关闭。
headless                只在android模拟器上可用。如果设置，android模拟器窗口将不会打开（并且test运行不需要X屏幕）
对于Javascript:
目标                                目的
//jsapi:debug:run                   运行test服务器（有用）
calcdeps                重新计算依赖一旦谷歌规定或者需求改变
常见问题
什么也没有编绎
确认你的JAVA_HOME正确设置。另外确保你能在命令行执行“rake”“java”，“jar”和“javac” 等命令。
如果你是在Windows系统上，你将需要去执行“devenv”.你也要安装JDK。如果C++组件没有在Windows系统上正常构建，确保你有实际可用的VS2010版本的msbuild(也许事实并不如此，即使你在一个VS2010命令提示符)
所有Firefox Tests失败
有时候我们在firefox driver讨论中改变java代码如何扩展协议。为什么所有的firefox tests失败主要原因是因为用户已经安装了一个叫“WebDriver”的firefox 配置。它必须被删除。
下面是可能有用的解决问题的步骤：
1、确认你有最新版本的代码（SVN 更新）
2、删除WebDriver 配置。最简单的方法是用firefox -ProfileManager启动firefox.
虽然在早期的webdriver里它是必须的，但现在已不需要手动安装webdriver扩展。
事实上，那样做可能成功难于追踪错误的罪魁祸首。强烈推荐你不要安装手动安装它。
构建有效，但是十分慢
有报告涉及构建缓慢的问题。每一个运行的测试用一个DNS解析来确认另一个主机名。如果你的网络没有配制正确，则这个
查询可能会很慢。为改进这一点，可修改在 org.openqa.selenium.environment.webserver.Jetty7AppServer的 getAlternateHostName方法并硬编码它去返回一个字符串来解决你的机子不是“localhost”.
我已经按上面的步骤操作了，但所有firefox tests还是失败。
做下面的检查：

• firefoxDriver 仅支持firefox 3及以上。检查在PATH路径里面firefox的版本是不是版本3及以上。
• driver 假设你的firefox安装在你系统的默认位置。如果firefox不在你的默认位置，你需要设置VM属性webdriver.firefox.bin 或者修改firefox在PATH里的路径。
• 在一些平台如linux，firefox以shell脚本启动。如果用另一个脚本封装这个shell脚本的Firefox的安装位置，FirefoxDriver不能正常工作。考虑调用源始的firefox脚本。
  

当做预构建时需要重新构建？

• 大多数对原子的改变将导致一个新的cpp/IEDriver/Generated/atoms.h文件。如果情况属实，在windows系统的Visual Studio提示符里，IEDriver预构建要重新编绎。
• iPhone driver 和 chromeDriver由于这些变化将要受到影响，但在这里说实话，你不可能去做上面的事情。
• 在cpp下对C++的任何改变要么需要IEDriver,firefox-driver,或者两者都要重新构建。
  

啦啦啦啦哈