selenium webdriver 学习构建webdriver

Mario洁

准备环境

对所有版本的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:cli
ent-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属性webd
river.firefox.bin 或者修改firefox在PATH里的路径。
• 在一些平台如linux，firefox以shell脚本启动。如果用另一个脚本封装这个shell脚本的Firefox的安装位置，Fi
refoxDriver不能正常工作。考虑调用源始的firefox脚本。
当做预构建时需要重新构建？
• 大多数对原子的改变将导致一个新的cpp/IEDriver/Generated/atoms.h文件。如果情况属实，在windows系
统的Visual Studio提示符里，IEDriver预构建要重新编绎。
• iPhone driver 和 chromeDriver由于这些变化将要受到影响，但在这里说实话，你不可能去做上面的事情。
• 在cpp下对C++的任何改变要么需要IEDriver,firefox-driver,或者两者都要重新构建。