sboselenium 0.7.2

浏览器引擎

如果您正在使用docker运行测试，则无需担心这部分。

如果您不使用docker，要使用特定的浏览器运行测试，则需要存在浏览器驱动程序。要使用Selenium驱动Chrome，您需要安装Chrome本身和chromedriver

1. 从http://chromedriver.storage.googleapis.com/index.html下载正确的ChromeDriver 2. 将二进制文件，chromedriver，放置在您的路径上的某个位置（例如：/usr/local/bin/chromedriver）

在Mac OS X上，如果您已安装Homebrew，则可以运行brew install chromedriver。

要在iPhone模拟器中测试Mobile Safari，您首先需要执行以下操作

• 安装Xcode

• 从Xcode首选项对话框的“下载”标签页中安装“命令行工具”和iOS模拟器组件之一（可能是最新的一个）

• 下载并运行 Appium

• 勾选“使用移动Safari”复选框

• 如果您想测试iPad形态，请勾选“强制设备”复选框，并确保在旁边选择“iPad”

• 点击“启动”按钮

要测试Opera或Safari，您需要下载Selenium独立服务器 jar文件，并在下述SELENIUM_JAR_PATH设置中配置其路径。

请注意，所有这些浏览器以及更多都可以使用Sauce OnDemand进行测试；下面将提供详细信息。

本地运行测试

可以通过“selenium”管理命令运行测试

./manage.py selenium --settings=myapp.selenium_settings

运行默认的sbo-selenium测试集

./manage.py selenium

或指定要运行的测试，而不是使用设置文件中指定的默认值

./manage.py selenium myapp.tests.selenium.test_module:TestClass.test_method myotherapp/tests/selenium --settings=myapp.selenium_settings

为Selenium测试保留单独的设置文件不是必需的，但在实践中，您可能希望使用与开发不同的设置（例如，确保DEBUG=False）。如果您不想每次都输入设置参数，简单的shell脚本应该可以解决问题。

#!/bin/sh
./manage.py selenium $@ --settings=myapp.selenium_settings

测试运行器使用的所有常规方法都应正常工作

directory/of/tests
python.module
python.module:TestClass
python.module:TestClass.test_method

（请注意，当实际测试定义在该包的模块中时，指定一个包，如myapp.tests.selenium，并不会工作。）

默认情况下，测试在由SELENIUM_DEFAULT_BROWSER指定的浏览器中运行。您可以使用-b或--browser参数来更改此设置

./manage.py selenium -b firefox
./manage.py selenium --browser=safari

有效的浏览器名称是“chrome”，“firefox”，“htmlunit”，“ios”，“opera”，“phantomjs”和“safari”（“ipad”，“iphone”和“ipod”被视为“ios”的同义词，形式因子在Appium中选择）。

如果您想指定一个特定的Selenium服务器作为命令执行器（无论是运行在本机、特定远程服务器、Docker容器等），可以使用--command-executor参数。

./manage.py selenium -b firefox --command-executor=http://127.0.0.1:4444/wd/hub

注意，如果您在Docker容器、远程主机等中使用命令执行器，您不应该依赖localhost或127.0.0.1作为DJANGO_LIVE_TEST_SERVER_ADDRESS，并且必须将用于访问服务器的IP地址添加到ALLOWED_HOSTS。您可以是指定真实的IP地址（很少理想）或尝试通过以下代码推断它：

import socket
IP_ADDRESS = socket.gethostbyname(socket.gethostname())
ALLOWED_HOSTS = ['localhost', IP_ADDRESS]
DJANGO_LIVE_TEST_SERVER_ADDRESS = '{}:9090'.format(IP_ADDRESS)

您还可以指定运行测试的次数（例如，如果您有一个由于某些原因偶尔失败的测试，并且想要运行几次以提高遇到错误的机会）。

./manage.py selenium -n 5

在Docker容器中运行测试

作为方便，您可以使用--docker参数自动在Docker容器中启动一个独立的Selenium服务器，用于chrome或firefox测试。为此，终端必须已经配置为可以使用docker命令。测试运行结束后，容器将自动停止。默认情况下，它使用来自https://hub.docker.com/r/selenium/的2.53.0镜像，并暴露在4444端口，但可以通过上述Django设置进行自定义。

./manage.py selenium --settings=myapp.selenium_settings --docker
./manage.py selenium --docker

注意，如果您通过docker-machine或类似方式在虚拟机上运行Docker容器，并使用tox，您需要允许某些环境变量通过将以下内容添加到tox.ini中适当的环境来传递到tox环境中：

passenv =
    DOCKER_*
    HOME

在Sauce Labs上运行测试

不是在本地浏览器中运行测试，而是在Sauce Labs托管的虚拟机中的浏览器上运行测试。sbo-selenium中对这种支持的设计旨在与Jenkins Sauce OnDemand插件良好配合。要在Jenkins中运行测试，只需安装该插件并配置它以用于您要运行的作业。在本地计算机上，您需要设置上述SELENIUM_SAUCE_* Django设置，并使用一些命令行参数，包括之前提到的-b浏览器名称设置。

• --platform - 要使用的操作系统名称和版本。

• --browser-version - 要使用的浏览器版本号。

这些的有效值可以在Sauce Labs网站上找到。

还有一个--tunnel-identifier参数，可以用来利用一个命名的Sauce Connect隧道；如果您打算同时针对同一账户运行多个Connect实例（如多个Jenkins从节点），这将特别有用。有关这些隧道是什么以及何时使用它们的更多信息，请参阅Sauce Labs关于该主题的文档。