1.3 安裝說明

本章的說明涵蓋了所有Robot Framework安裝和卸載的方法，以及在不同操作系統(tǒng)上安裝的前提條件。如果你本地安裝有pip,那么就很容易安裝Robot Framework。如下：

    pip install robotframework 

1.3.1 介紹

Robot Framework是用Python實(shí)現(xiàn)的，同時(shí)支持Jython(JVM)和IronPython(.NET)。在安裝框架之前，前提條件就是安裝其中一種Python解釋器。

下面列出了安裝Robot Framework不同的方式，并在后續(xù)的章節(jié)中加以詳細(xì)的說明。

用pip安裝

用pip安裝Robot Framework是官方推薦的方式。在最新的Python, Jython和IronPython版本中已經(jīng)包含了這種標(biāo)準(zhǔn)的包管理器。
如果你已經(jīng)安裝了pip, 你可以簡(jiǎn)單的執(zhí)行以下這句命令:

    pip install robotframework

用源碼安裝

這種方式獨(dú)立于操作系統(tǒng)和Python解釋器。你可以從PyPI網(wǎng)站上下載源碼發(fā)布包進(jìn)行解[壓亦或是從Github上克隆Robot Framework倉庫。

獨(dú)立的JAR發(fā)布包

如果你用Jython執(zhí)行測(cè)試就足夠的話，最簡(jiǎn)單的方式就是從Maven中央倉庫上下載獨(dú)立的JAR包robotframework-[version].jar
JAR發(fā)布包同時(shí)包含了Jython和Robot Framework，因此僅僅需要安裝Java就可以了。

手動(dòng)安裝

如果你有特殊需求或者其他的方式都不起作用，那么你可以手動(dòng)安裝。

注意
在Robot Framework 3.0以前，也有Python 32位版本和64位版本兩個(gè)單獨(dú)的Windows安裝程序。但是在Windows上自帶pip的Python2.7.9和更新的版本以及Python 3則需要更多的安裝程序。
因此我們決定不在提供Windows安裝程序了。在Windows系統(tǒng)上我們同樣推薦pip安裝方式。

1.3.2 前提條件

Robot Framework支持Python(包括Python 2和Python 3), Jython(JVM), IronPython(.NET)以及PyPy.
在安裝Robot Framework之前，必須先安裝你選擇的Python解釋器。

一般來說，選擇哪種解釋器通常根據(jù)你的測(cè)試庫和測(cè)試環(huán)境決定。一些測(cè)試庫使用的工具和模塊僅僅在Python下工作，而另一些測(cè)試庫需要使用Java工具，這就需要有Jython環(huán)境，或者需要.NET環(huán)境，那就需要安裝IronPython。
也有一些測(cè)試庫和工具能夠在所有解釋器平臺(tái)上正常運(yùn)行。

如果你沒有特殊的環(huán)境要求，那么推薦使用Python解釋器來運(yùn)行Robot Framework。因?yàn)镽obot Framework是用原生Python實(shí)現(xiàn)的，所以運(yùn)行的自然比Jython和IronPython要快(特別是在啟動(dòng)時(shí)間上)。
同時(shí)在類Unix系統(tǒng)上，Python解釋器是自帶的，隨時(shí)可用。還有一個(gè)替代方案就是，運(yùn)行獨(dú)立的JAR發(fā)布包，它僅僅依賴Java環(huán)境作為前提條件。

Python 2 or Python 3

Python 2 和Python 3通常來說是同一種編程語言，但是它們之間卻不是完全的相互兼容。兩者之間主要的區(qū)別是Python 3中所有的字符串都是Unicode編碼的，而在Python 2中默認(rèn)是字節(jié)編碼。
但是也有其他幾個(gè)向后兼容的改變。最后一個(gè)Python 2版本是Python 2.7, 于2010年發(fā)布, 將會(huì)支持到2020年。點(diǎn)擊鏈接Should I use Python 2 or 3?查看更多關(guān)于兩者之間的異同，該使用哪個(gè)版本，
以及如何寫出兼容兩個(gè)版本的代碼等等。

Robot Framework 3.0 是第一個(gè)支持Python 3的版本， 當(dāng)然，它也支持Python 2版本。同時(shí)我們也計(jì)劃一直支持到Python 2官方的結(jié)束支持時(shí)間。我們希望開發(fā)Robot Framework生態(tài)系統(tǒng)的測(cè)試庫和測(cè)試工具的開發(fā)者能夠考慮支持Python 3, 像我們的核心框架一樣。

Python 安裝

在大部分類Unix系統(tǒng)，如Linux和OS X已經(jīng)默認(rèn)自帶了Python解釋器了，所以無需安裝。如果你是在Windows系統(tǒng)或者自己需要安裝Python, 可以去官方網(wǎng)站http://python.org，這里可以下載合適的版本以及了解更多關(guān)于Python的相關(guān)信息。

Robot Framework 3.0支持Python 2.6, 2.7, 3.3和更新的版本。但是RF3.1 已經(jīng)計(jì)劃不支持Python 2.6了。如果你需要使用老版本Python的話，Robot Framework 2.5-2.8支持Python 2.5, Robot Framework 2.0-2.1 支持Python 2.3和2.4。

在安裝完P(guān)ython以后，你可能需要設(shè)置PATH環(huán)境變量, 以使Python本身以及robot 和rebot執(zhí)行器能夠在命令行中執(zhí)行。

小貼士
最新的Python Windows安裝程序在安裝過程中允許設(shè)置PATH路徑。這個(gè)功能默認(rèn)是禁用的, 但可以通過在自定義安裝Python界面中添加python.exe到Path中來啟動(dòng)。

Jython 安裝

使用Java實(shí)現(xiàn)的測(cè)試庫或者工具需要Robot Framework運(yùn)行在Jython上。反過來又需要有Java運(yùn)行時(shí)環(huán)境(JRE)或者Java開發(fā)工具集(JDK)。安裝這兩種Java發(fā)行包已經(jīng)超出了本章的范圍了，但是你可以通過http://java.com來獲取更多信息。

安裝Jython是很容易的，第一步就是在網(wǎng)站http://jython.org獲取安裝程序。安裝程序是可執(zhí)行的JAR包，可以在命令行中執(zhí)行,如java -jar jython_installer-<version>.jar。依賴于系統(tǒng)設(shè)置，你或許可以通過雙擊文件來運(yùn)行安裝程序。

Robot Framework 3.0 支持Jython 2.7, 因此需要Java 7或更新的運(yùn)行時(shí)環(huán)境。如果需要舊的Jython或者Java版本，那么Robot Framework 2.5-2.8支持Jython 2.5(需要Java 5以及更新版本)；
Robot Framework 2.0-2.1支持Jython 2.2。

安裝完Jyhton之后，你可能仍需要配置PATH環(huán)境變量，以使Jython本身以及robot 和rebot執(zhí)行器能夠在命令行中執(zhí)行。

IronPython 安裝

IronPython 運(yùn)行Robot Framework運(yùn)行在.NET平臺(tái),可以與C#或者其他.NET語言和API進(jìn)行交互。僅支持IronPython 2.7。

當(dāng)使用IronPython，需要額外安裝elementtree模塊1.2.7預(yù)覽版本。這是因?yàn)?code>elementtree模塊利用IronPython發(fā)布出現(xiàn)了問題。
你可以下載源碼安裝包到本地，解壓，然后在解壓目錄下打開終端，執(zhí)行ipy setup.py install進(jìn)行安裝。

安裝完IronPyhton之后，你可能仍需要配置PATH環(huán)境變量，以使Jython本身以及robot 和rebot執(zhí)行器能夠在命令行中執(zhí)行。

配置PATH

PATH環(huán)境變量列出了操作系統(tǒng)執(zhí)行命令的位置，為了確?？梢詮慕K端上執(zhí)行Robot Framework, 推薦將Robot Framework的執(zhí)行器路徑添加到PATH環(huán)境變量中去。通常也將解釋器本身添加到PATH中，以使Python執(zhí)行方式更加簡(jiǎn)單。

當(dāng)在類Unix系統(tǒng)使用Python時(shí)，Python本身和它的相關(guān)腳本會(huì)自動(dòng)地添加到PATH路徑中去，無需額外操作。但在Windows系統(tǒng)和其他解釋器的情況下，還需要分別設(shè)置PATH環(huán)境變量。

小貼士
最新的Python Windows安裝程序在安裝過程中允許設(shè)置PATH路徑。這個(gè)功能默認(rèn)是禁用的, 但可以通過在自定義安裝Python界面中添加python.exe到Path中來啟動(dòng)。
這樣會(huì)同時(shí)將Python安裝路徑和腳本目錄添加到PATH環(huán)境變量中去。

添加什么目錄到PATH

添加什么目錄到PATH環(huán)境變量中取決于你本地的操作系統(tǒng)和解釋器類型。首要位置就是解釋器的安裝目錄(如，C:\Python27)，其次就是解釋器安裝執(zhí)行腳本的目錄。
在Windows系統(tǒng)上，Python和IronPython均將腳本安裝到自身安裝目錄的Scripts子目錄下。無論在什么系統(tǒng)上，Jython統(tǒng)一安裝到bin目錄下(如，C:\jython2.7.0\bin)。

注意Scripts和bin目錄并不是在解釋器自身安裝的時(shí)候創(chuàng)建的，在安裝Robot Framework和Python第三方模塊的時(shí)候，才會(huì)創(chuàng)建該目錄。

在Windows系統(tǒng)上配置PATH

在Windows系統(tǒng)上你可以根據(jù)以下步驟來配置PATH環(huán)境變量。注意具體的設(shè)置名稱可能在不同的Windows版本上會(huì)出現(xiàn)不一致，但基本的方法是一樣的。

• 打開控制面板>系統(tǒng)>高級(jí)>環(huán)境變量。有系統(tǒng)環(huán)境變量和用戶環(huán)境變量，它們的區(qū)別是用戶環(huán)境變量?jī)H僅對(duì)當(dāng)前的用戶生效，而系統(tǒng)環(huán)境變量則對(duì)所有的用戶起作用。
• 編輯已存在的PATH值，選擇編輯，然后添加;<InstallationDir>;<ScriptsDir>到已存在的值的末尾去(如. ;C:\Python27;C:\Python27\Scripts)。
  注意分號(hào)(;)很重要, 它用于分隔不同的值項(xiàng)。添加一個(gè)新的PATH值，選擇新增，然后同時(shí)設(shè)置變量名和值, 只一次前面不需要分號(hào)了。
• 點(diǎn)擊確定按鈕,保存修改并退出對(duì)話框。
• 啟動(dòng)新的命令行終端使修改生效。

注意，如果你的操作系統(tǒng)安裝了多個(gè)版本的Python的話，執(zhí)行robot或rebot執(zhí)行器命令的時(shí)候，會(huì)首先選擇PATH變量中最靠前的命令路徑來執(zhí)行，而不管該命令安裝在哪個(gè)Python版本中。
為了避免這種情況，你可以選擇始終以直接執(zhí)行robot模塊的方式，如C:\Python27\python.exe -m robot。

注意，你也不應(yīng)該為添加到PATH環(huán)境變量中的路徑加上雙引號(hào)(如，"C:\Python27\Scripts")，雙引號(hào)可能會(huì)在Python中引起一些問題。在設(shè)置PATH環(huán)境變量的路徑值是也沒必要添加雙引號(hào)，即使路徑中可能包含空格。

在類Unix系統(tǒng)上配置PATH

在類Unix系統(tǒng)上，你可能需要編輯系統(tǒng)層面或者用戶層面的配置文件。至于編輯何種文件則依據(jù)于具體的操作系統(tǒng)。你需要查詢操作系統(tǒng)文檔來獲取更多信息。

配置https_proxy

如果你是用pip安裝，并且使用代理的話，你需要設(shè)置https_proxy環(huán)境變量。https_proxy環(huán)境變量在安裝pip本身和使用pip安裝Robot Framework以及其他Python包的時(shí)候都需要。

和配置PATH類似，配置https_proxy環(huán)境變量，根據(jù)不同的系統(tǒng)，方式也不盡相同。但是https_proxy變量的值必須是代理的URL地址，如http://10.0.0.42:8080。

1.3.3 用pip安裝

Python標(biāo)準(zhǔn)的包管理方式是pip, 但是也有其他的替代方案如Buildout和easy_install。
本節(jié)只覆蓋了pip安裝的部分，其他的包管理方式也能安裝Robot Framework。

最新的Python, Jython和IronPython版本已經(jīng)內(nèi)置了pip模塊。后續(xù)的章節(jié)我們?cè)敿?xì)討論那些版本包含pip以及如何使用pip。如果你需要安裝pip，可查看pip項(xiàng)目主頁以了解最新的安裝說明.

小貼士
只有Robot Framework 2.7和更新的版本可以用pip安裝。如果你需要用舊的版本，你必須選擇其他的安裝方式。

為Python安裝pip

從Python 2.7.9開始，標(biāo)準(zhǔn)的Windows安裝程序就默認(rèn)安裝和激活了pip了。假設(shè)你已經(jīng)設(shè)置好PATH或者HTTP代理了，你可以在安裝完P(guān)ython后執(zhí)行命令
pip install robotframework。

對(duì)于非Windows系統(tǒng)或者是早期的Python版本，你需要自己手動(dòng)安裝pip。你可以利用系統(tǒng)的包管理工具，在linux上使用apt或者是yum來進(jìn)行安裝。
同時(shí)你也可以在pip主頁上找到手動(dòng)安裝的說明。

如果你安裝有多個(gè)包含pip模塊的Python版本的話，那么優(yōu)先執(zhí)行PATH環(huán)境變量中第一個(gè)在搜索路徑發(fā)現(xiàn)的pip命令。一個(gè)替代的方式是直接在執(zhí)行pip命令的時(shí)候選擇Python的版本：

    python -m pip install robotframework
    python3 -m pip install robotframework

為Jython安裝pip

Jython 2.7已經(jīng)自帶了pip，但是需要先執(zhí)行下面的命令啟用它：

    jython -m ensurepip

Jython將pip安裝到<JythonInstallation>/bin目錄下。
執(zhí)行運(yùn)行pip install robotframework有可能會(huì)使用其他的pip版本, 這取決于PATH環(huán)境變量中pip命令的路徑地址順序。
一個(gè)替代的方式是直接用Jython運(yùn)行pip模塊:

    jython -m pip install robotframework

為IronPython安裝pip

IronPython 從2.7.5版本開始自帶pip。和Jython類似，需要先進(jìn)行激活：

    ipy -X:Frames -m ensurepip

注意命令行選項(xiàng) -X:Frames在激活和使用pip的時(shí)候都需要。

IronPython將pip安裝到<IronPythonInstallation>/Scripts目錄下。
執(zhí)行運(yùn)行pip install robotframework有可能會(huì)使用其他的pip版本, 這取決于PATH環(huán)境變量中pip命令的路徑地址順序。
一個(gè)替代的方式是直接用IronPthon運(yùn)行pip模塊:

    ipy -X:Frames -m pip install robotframework

IronPython 2.7.5以前的版本，官方不支持pip。

使用pip

一旦安裝好了pip，設(shè)置好https代理以后，在命令行使用pip就非常簡(jiǎn)單了。最簡(jiǎn)單的方式就是使用pip從Python Package Index (PyPI)上來查找和下載包。
它也可以安裝已經(jīng)下載的安裝包。最常用的使用方法如下所示，pip官方文檔提供了更多詳細(xì)的信息：

    # Install the latest version
    pip install robotframework

    # Upgrade to the latest version
    pip install -upgrade robotframework

    # Install a specific version 
    pip install robotframework==2.9.2

    # Install separately downloaded package (no network connection needed.)
    pip install robotframework-3.0.tar.gz

    # Uninstall
    pip uninstall robotframework

注意pip1.4和更新的pip版本默認(rèn)情況下只會(huì)安裝穩(wěn)定的包版本。如果你需要安裝alpha,beta或者rc版本,你需要特別指定，或者使用--pre選項(xiàng)。

    # Install 3.0 beta 1
    pip install robotframework==3.0b1

    # Upgrade to the latest version even if it is a pre-release
    pip install --pre --upgrade robotframework

1.3.4 用源碼安裝

這種安裝方法可以在所有系統(tǒng)和解釋器環(huán)境下使用。從源碼安裝可能有一點(diǎn)可怕，但是過程其實(shí)是非常簡(jiǎn)單明了的。

獲取源碼

你通?？梢韵螺d.tar.gz格式的源碼發(fā)布包來獲取源碼。在PyPI上可以獲取更新的包。
但是Robot Framework 2.8.1和更早的版本只能從舊的Google Code下載頁面獲取了。
一旦你下載了源碼包以后，你就需要解壓到某個(gè)路徑，完成后，創(chuàng)建了目錄為robotframework-<verion>。這個(gè)目錄包含了安裝的源碼和腳本。

另一種獲取源碼的方式是直接從Github倉庫中克隆該項(xiàng)目。
默認(rèn)情況下，獲取的是最新的代碼, 但是你可以很容易切換到不同的發(fā)布版本和Tag標(biāo)簽。

安裝

Robot Framework源碼安裝是采用標(biāo)準(zhǔn)的Python setup.py安裝腳本。安裝腳本在解壓后的源碼目錄中, 你可以在命令行下使用任意一種解釋器進(jìn)行安裝：

    python setup.py install 
    jython setup.py install
    ipy setup.py install

setup.py安裝腳本允許接收多個(gè)參數(shù)。例如，安裝到非默認(rèn)路徑不需要管理員權(quán)限。它也可以用于創(chuàng)建不同的發(fā)行包。
執(zhí)行python setup.py --help來獲取更多信息。

1.3.5 獨(dú)立的JAR發(fā)行包

Robot Framework也提供了獨(dú)立的JAR發(fā)行包，包含了Jython和Robot Framework，僅僅依賴Java環(huán)境。這種方式不需要進(jìn)行安裝，只需要一個(gè)包就可以了。
但是一個(gè)缺點(diǎn)就是在通常的Python解釋器下不能工作。

這個(gè)包的命名是robotframework-<version>.jar, 在Maven中央倉庫上可以獲得。
下載完包以后，你可以以下的方式執(zhí)行測(cè)試：

    java -jar robotframework-3.0.jar mytests.robot
    java -jar robotframework-3.0.jar --variable name:value mytests.robot

如果你想使用后處理命令或者使用其他內(nèi)置工具的話，你需要將命令名作為第一個(gè)參數(shù)傳遞給JAR文件：

    java -jar robotframework-3.0.jar rebot output.xml
    java -jar robotframework-3.0.jar libdoc MyLibrary list

可以通過不帶任何參數(shù)執(zhí)行JAR文件來獲取更多信息。

除了Python標(biāo)準(zhǔn)庫和Robot Framework模塊外，這個(gè)獨(dú)立的JAR發(fā)行包從2.9.2版本開始，也包含了依賴項(xiàng)PyYAML來處理yaml格式的變量文件。

1.3.6 手動(dòng)安裝

如果你不想采用任何自動(dòng)化的方式來安裝Robot Framework的話，你也可以按照以下步驟來手動(dòng)安裝：

• 獲取源碼, 所有的源碼在robot目錄下, 如果你從源碼發(fā)布或者版本控制系統(tǒng)檢出的話，你可以從src目錄找到源碼, 你也可以從早先安裝路徑制獲取源碼。
• 拷貝源碼到你想要的路徑。
• 按照自己的方式執(zhí)行測(cè)試。

1.3.7 驗(yàn)證安裝

在成功安裝以后，可以通過在命令行中終端上用--version選項(xiàng)來運(yùn)行執(zhí)行器去獲取Robot Framework版本以及Python解釋器版本：

    $robot --version
    Robot Framework 3.0 (Python 2.7.10 on linux2)

    $rebot --version
    Rebot 3.0 (Python 2.7.10 on linux2)

如果運(yùn)行執(zhí)行器腳本失敗的話，提示錯(cuò)誤信息是命令沒找到或者不識(shí)別的話，最好先檢查一下PATH環(huán)境變量是否配置正確。如果PATH沒有問題的話，
再去閱讀相關(guān)章節(jié)的說明, 如果還是沒有解決的話，可以通過因特網(wǎng)或者是robotframework-users郵件組等方式來尋求幫助。

1.3.8 卸載

最簡(jiǎn)單的卸載Robot Framework的方式就是使用pip命令:

    pip uninstall robotframework

用pip卸載的好處就是即使你是用源碼安裝的，也同樣可以卸載。如果你沒有安裝pip的話，或者是手動(dòng)安裝到自定義的路徑，那么你需要知道你的文件安裝到哪里，然后手動(dòng)刪除它們。

如果你在PATH環(huán)境變量中設(shè)置了相關(guān)路徑，你需要撤銷這些操作。

1.3.9 升級(jí)

如果你使用pip的話，升級(jí)新版本，可以使用參數(shù)--upgrade選項(xiàng)或者是指定的版本:

    pip install --upgrade robotframework
    pip install -U robotframework
    pip install robotframework==2.9.2

但使用pip安裝時(shí)，它會(huì)自動(dòng)卸載先前安裝的版本。如果你是源碼安裝的話，覆蓋安裝通常也是安全的。
如若遇到了問題，請(qǐng)?jiān)侔惭b之前先卸載舊的版本可能會(huì)解決。

當(dāng)升級(jí)Robot Framework時(shí)，可能會(huì)遇到新版本對(duì)舊版本不兼容的情況，從而影響到已存在的測(cè)試或者是測(cè)試設(shè)施。但是這些問題在臨近的小版本之間影響微乎其微，
如2.8.7或2.9.2, 而在大版本之間如2.9和3.0之間可能會(huì)比較常見。向后不兼容的影響以及不推薦的特性在發(fā)行說明中已經(jīng)詳細(xì)說明了。
在升級(jí)到新的里程碑版本的時(shí)候，了解它的新特性和一些改變會(huì)是很好的方式。

1.3.10 執(zhí)行Robot Framework

使用robot和rebot腳本

從Robot Framework 3.0開始，用腳本命令robot來執(zhí)行測(cè)試,用rebot腳本來執(zhí)行結(jié)果的后處理。

    robot tests.robot
    rebot output.xml

這兩個(gè)腳本命令都是隨著Robot Framework安裝程序一起被安裝的。如果PATH配置正確的話，可以直接從命令行終端上執(zhí)行。
它們是用Python實(shí)現(xiàn)的，但是在Windows上，它們是批處理腳本。

舊的Robot Framework版本不含robot命令，而rebot命令只在Python解釋器中。
在其他解釋器中替代的是pybot，jybot, ipybot來執(zhí)行測(cè)試, jyrebot, ipyrebot來處理結(jié)果。這些腳本目前仍然可以運(yùn)行，但是不推薦使用，不排除在將來會(huì)將它們移除。

執(zhí)行已安裝的robot模塊

還有一種替代的方式運(yùn)行測(cè)試是用Python的-m command line option命令行方式直接執(zhí)行robot模塊或者其子模塊robot.run。
這種方式在多版本Python并存的環(huán)境中很有用。

    python -m robot tests.robot
    python3 -m robot.run tests.robot
    jython -m robot tests.robot
    /opt/jython/jython -m robot tests.robot

對(duì)python -m robot方式的支持是Robot Framework 3.0的新功能，在舊的版本中只支持python -m robot.run。后者必須在Python 2.6的環(huán)境下運(yùn)行。

結(jié)果后處理使用相同的方式。模塊改為robot.rebot。

    python -m robot.rebot output.xml

執(zhí)行已安裝的robot目錄

如果你知道robot安裝目錄的話，你可以在安裝目錄中直接執(zhí)行robot命令或者是run.py文件:

    python path/to/robot/ tests.robot
    jython path/to/robot/run.py tests.robot

執(zhí)行robot目錄是Robot Framework 3.0的新功能。舊版本功能僅僅支持執(zhí)行robot/run.py文件。

結(jié)果后處理使用同樣的方式robot/rebot.py執(zhí)行:

    python path/to/robot/rebot.py output.xml

如果你是手動(dòng)安裝的，這種執(zhí)行方式非常方便。