---
# System prepended metadata

title: <div class="center">Robot Framework 安裝與測試</span>

---

<style>
.blue{
    color: blue;
}
.yahei{
    font-family:Microsoft JhengHei;
    font-size:18px;
}
.center{
    text-align:center;
}
.textnormal{
font-size:19px;
}

.text{
font-size:16px;
}
</style>


# <div class="center">Robot Framework 安裝與測試</span>

<div class="textnormal">Robot Framework是一個開源的自動化測試框架，在安裝RIDE後可以透過GUI介面來進行測試活動。
===
</div>
 
<div>

![](https://i.imgur.com/9FmaGfm.jpg)
</div>
===
### **使用Robot Framwork 需安裝以下工具：**
<div class="yahei"> 

* [Python3.6](https://www.python.org/downloads/)
* PIP Python套件管理工具
* [Robot framework](https://robotframework.org/) 

</div>
  
### **本篇針對Web GUI進行測試，所以需安裝以下套件：**

* <span class="blue"> wxPython </span> - Python的GUI工具包，必須安裝以使用RIDE
* <span class="blue"> RIDE </span> - Robot Framework GUI介面編輯器
* <span class="blue"> selenium2library </span>- 用於Robot Framework的Web測試庫
* <span class="blue"> Web driver - chromedriver</span> - 提供瀏覽器相關自動操作 
<br>

### **Robot Framework 擴展庫：**
####     <span style="color:red">可透過 pip install robotframework-*****安裝 </span>
- <span style="color:red;font-size:19px;">[appiumlibrary](https://github.com/serhatbolsu/robotframework-appiumlibrary)</span> - 用於Android和iOS測試的庫
- <span style="color:red;font-size:19px;">[robotframework-browser](https://github.com/MarketSquare/robotframework-browser) </span>- Web測試庫
- <span style="color:red;font-size:19px;">[debuglibrary](https://robotframework.org/#libraries) -</span> Debug調試庫
- <span style="color:red;font-size:19px;">[screencaplibrary](https://github.com/mihaiparvu/ScreenCapLibrary)</span> - 截圖和錄像的庫
- <span style="color:red;font-size:19px;">[DatabaseLibrary](https://github.com/Hi-Fi/robotframework-dblibrary)</span> - 用於DB的測試庫（基於Python的庫）
- 其他官方Library [擴展庫](https://robotframework.org/#libraries) (External)

## 安裝步驟：
### 1.安裝Python套件：

![](https://i.imgur.com/Jbf8HpX.png)

### 2.安裝完後在 命令提示字視窗 輸入
```
python --version
```
### 3.若有提示版本訊息表示安裝成功
![](https://i.imgur.com/bFuh08n.png)

## 安裝Robot Framework

### 1.在 命令提示字視窗 輸入
```
pip install robotframework
```
### 2. 安裝完畢後 確認是否安裝
```
python -m robot --version
```
### 3.若有提示版本訊息表示安裝成功
![](https://i.imgur.com/17MsL9R.png)

## 安裝 測試庫 及 其他套件

### 1.在 命令提示字視窗 輸入
```csharp=
//安裝GUI工具
pip install -U wxPython
```

```csharp=
//安裝RIDE介面
pip install robotframework-ride
```

```csharp=
// 安裝Web 測試庫
pip install robotframework-selenium2library
```
### 2.若以上皆有顯示 Successfully，表示安裝成功。

## 安裝 [Web driver - chrome](https://chromedriver.chromium.org/downloads)

### 1. 選擇<span style ="color:red">對應本機Chrome版本</span>安裝
![](https://i.imgur.com/P9fQfnl.png)

### 2. 將下載的文件解壓縮，並分別放到<span style ="color:red">Python、Chrome</span>的安裝目錄下。
#####  <span style ="color:red">PS：若有安裝Anaconda的，也需放到其目錄下。</span>
![](https://i.imgur.com/qzy37GF.png)

![](https://i.imgur.com/AMUUI6W.png)

### 3. 設定/新增 系統環境變數 至 Chrome
![](https://i.imgur.com/UvlGs3g.png)


## 開始測試簡單範例

- 新增名為 test 的文字檔，輸入以下程式並保存
- <span style="color:red"> 更改副檔名為.robot </span>
```csharp=
*** Settings ***
    Library           Selenium2Library

    *** Test Cases ***
    Open Google
        Open Browser    https://zh.wikipedia.org/     chrome
```
- 在 命令提示字元 輸入 開始執行
```
robot test.robot
```
 ### 自動執行測試命令：
![](https://i.imgur.com/MA5WYDn.png)

![](https://i.imgur.com/V8K1Sg2.png)

### <span style="color:red">以上簡單的打開 維基百科網頁 測試就完成了！</span>

# 透過Ride 介面 創建測試項目

### 1. 在 命令提示字元 中 輸入  以打開Ride介面 
```
ride.py
```
![](https://i.imgur.com/JfDsGaM.png)

### 2. 新增測試專案
- <span style="color:red; font-size:18px;">File > 輸入專案名稱 > Type類型 與 Format類型，皆為預設。</span>
 ![](https://i.imgur.com/HicdoNg.png)
 
- <span style="color:red; font-size:18px;">加入 Selenium2Library 函式庫。</span>
![](https://i.imgur.com/cXK3x5q.png)

- <span style="color:red; font-size:17px;">若顯示為黑色，表示匯入成功；若顯示為紅色，表示Selenium2Library 庫不存在。</span>
- <span style="color:red;font-size:18px;">確認是否安裝相關的庫，檢查拼寫是否正確。</span>
![](https://i.imgur.com/ksIAAQx.png)

- <span style="color:red;font-size:18px;">在專案名稱右鍵 新增 TestCase。 </span>
![](https://i.imgur.com/jNFABej.png)

- <span style="color:red;font-size:18px;">輸入專案測試的名稱。</span>
![](https://i.imgur.com/vLJoOHP.png)

- <span style="color:red;font-size:18px;">可在 Edit 表格中輸入指令。</span>
![](https://i.imgur.com/3Wpd448.png)

- <span style="color:red;font-size:18px;">也可在Text Edit進入純文字編輯模式 。</span>
![](https://i.imgur.com/mlFPu5E.png)

- <span style="color:red;font-size:18px;">開始測試 & 成功狀態 </span>

![](https://i.imgur.com/cRVEdW2.png)

- <span style="color:red;font-size:18px;">錯誤狀況</span>

![](https://i.imgur.com/zXH4DbT.png)


- <span style="color:red;font-size:18px;">Report - 運行結束後，點即可查看報告。</span>
- <span style="color:red;font-size:18px;"> Log - 用於查看詳細的測試log。 </span>
- <span style="color:red;font-size:18px;">測試編譯結果一Pass一Fail，
只要有一個fail則會顯示紅色橫線高亮提醒，
全過才會顯示綠色。 </span>
<br>
<br>
<br>
## 參考文獻
> https://blog.csdn.net/huashao0602/article/details/53394784 RF常用庫
>https://www.coderbridge.com/series/1192363370c740e380a5437440013cd5 初探 RF 
>https://www.jianshu.com/p/9dcb4242b8f2 RF安裝與設置
>https://zhuanlan.zhihu.com/p/105611027 RF官方手冊 中文
>https://dotblogs.com.tw/grayyin/2018/01/04/155405 RF安裝RIDE 介面
>https://www.itread01.com/content/1522579203.html RF安裝部署詳細教程
>https://www.itread01.com/content/1549666275.html 兩小時入門RF
>https://robotframework.org/Selenium2Library/Selenium2Library.html
Selenium2Library 程式庫