使用說明

測試前設定：

1. 安裝Appium studio (https://experitest.com/appium-studio/)

2. 新增測試手機至Appium studio並啟動手機 (請參考Getting started)

3. 下載SeeTest_iOS.jar及TestScript.xlsm

測試腳本建立說明：

1. 於C:\建立TUTK_QA_TestTool資料夾 (C:\TUTK_QA_TestTool)

2. TUTK_QA_TestTool中分別建立TestTool資料夾與TestReport資料夾

3. 將TestScript.xlsm放至TestTool資料夾 (C:\TUTK_QA_TestTool\TestTool\TestScript.xlsm)(檔名及副檔名請勿更改)

4. 開啟TestScript.xlsm並允許啟動巨集 (已建立APP&Device、ExpectResult及說明工作表)

5. APP&Device工作表輸入BundleID、測試手機UDID、測試手機OS版本、待測試腳本(以_TestScript結尾的工作表)SeeTest_iOS.jar路徑，範例如下圖：

6. 建立腳本(建立案列Case)：新增一工作表，工作表名稱須以_TestScript為結尾 (e.g. Login_TestScript)，目前支援指令如下: (大小寫有分，使用方式請參考TestScript.xlsm內說明工作表)

    CaseName=>測試案列名稱(各案列開始時第一個填寫項目，必填!!!)
   
    ByXpath_Click=>搜尋元件xpath並點擊元件
   
    ByXpath_Result=>搜尋元件xpath並比對ExpectResult內容
   
    ByXpath_SendKey=>搜尋元件xpath並輸入數值或字串
    
    ByXpath_Swipe=>上下滑動畫面
   
    ByXpath_Wait=>等待並搜尋元件xpath
   
    HideKeyboard=>關閉鍵盤
   
    Home=>點擊手機Home鍵
   
    LaunchAPP=>啟動APP&Device工作表指定的Packageanme之Avtivity
   
    Orientation=>切換手機Landscape及Portrait模式
   
    Power=>點擊手機電源鍵
   
    QuitAPP=>關閉APP&Device工作表指定的Packageanme之Avtivity
   
    ResetAPP=>重置APP(清除APP暫存紀錄)並重新啟動APP
   
    ScreenShot=>螢幕截圖
   
    Sleep=>閒置APP n秒鐘
    
    Swipe=>上下滑動n次
    
    ByXpath_Swipe_Vertical=>上下滑動n次
    
    ByXpath_Swipe_Horizontal=>左右滑動n次
   

範例腳本如下圖：

7. ExpectResult工作表輸入各測試案例的期望結果

    7.1 A欄第二列處往下填入案列名稱 (CaseName)
    
    7.2 與案列名稱同列處輸入期望結果
   

ExpectResult範例如下圖：

測試腳本語法檢查：

1. 執行TestScript.xlsm增益集工具進行語法與資訊檢查，如下圖：

2. 各功能說明：

    2.1 檢查資訊：確認APP&Device工作表所有欄位是否正確
    
    2.2 檢查案例語法：確認各案例結束後均執行QuitAPP方法
    
    2.3 檢查案例輸入值：確認所有命令及參數是否正確
    
    2.4 檢查期望結果：確認案例之期望字串是否列於ExpectResult工作表，當然非所有案列都需列ExpectResult
    
    2.5 執行腳本：開始執行指定的工作表腳本，建議執行腳本前請確認前4項功能無誤
    
    註：2.2、2.3及2.4功能僅檢查以_TestScript為結尾且未隱藏的工作表 
   

3. 功能異常排除：

    3.1 移除增益集自訂工具列，如下圖：
   

   

    3.2 存檔並關閉TestScript.xlsm
    
    3.3 重新開啟TestScript.xlsm
   

Excel 測試報告

1. 開啟C:\TUTK_QA_TestTool\TestReport\TestReport.xlsm

2. 根據手機UDID自動建立TestReport工作表，如下圖： (e.g. abc123ABC123_TestReport)

範例測試結果如下圖：

experitest 測試報告

開啟C:\TUTK_QA_TestTool\TestReport\index.html，範例如下圖：