跳轉到主要內容
這是 Qaptly 行動測試設計中所有可用測試步驟類型的完整參考。

概覽

Qaptly 支援 9 種步驟類型,分為三個類別:

互動步驟

Tap

點擊裝置螢幕上的特定位置。

目標模式

座標模式
  • 座標已正規化 (0-1 範圍)
  • (0,0) 為左上角,(1,1) 為右下角
元素定位器模式
定位器策略:

捲動選項

  • 自動捲動: 如果元素不可見則捲動以尋找
  • 先捲動到頂部: 重設捲動位置
  • 最大捲動嘗試次數: 1-50 (預設: 10)

備用座標

使用元素定位器時,可選擇性設定備用座標,如果定位器失敗則使用。

Press

長按位置持續指定時間。

參數

所有來自 Tap 的目標選項都可用。

Swipe

執行從一點到另一點的滑動手勢。

參數

快速手勢預設值

Android 預設值 iOS 預設值 通用預設值

Input

在文字輸入欄位中輸入文字。

參數

  • 支援多行文字
  • 環境變數: {{variable_name}}

Key

按下裝置硬體按鍵或系統按鈕。

可用按鍵


驗證步驟

Verify

驗證是否滿足條件。有三種驗證方法可用。

方法 1: UI 層次結構

驗證 UI 樹中元素的存在。 目標配置 與 Tap 相同 - 使用座標或元素定位器。 檢查屬性 輪詢配置
重試配置

方法 2: AI Vision 結構化

使用 Cloud Vision API 分析截圖結構。 工作流程
  1. 點擊 擷取截圖 以分析當前螢幕
  2. 查看 Cloud VL 回應 (JSON)
  3. 從 JSON 回應建立條件
  4. 配置重試設定
條件建立器 根據 JSON 回應欄位建立條件:
  • 欄位路徑
  • 運算子 (等於、包含等)
  • 預期值

方法 3: AI Vision 提示

使用 Cloud Vision API 搭配自然語言提示。 參數

控制步驟

Wait

在下一步之前引入延遲。

參數

使用案例

  • 等待頁面載入
  • 等待動畫
  • 等待網路回應

App Launch

在裝置上啟動特定應用程式。

參數

啟動選項 錯誤處理

Close App

關閉執行中的應用程式。

參數


常見參數

預期結果

除 Web Action 外的所有步驟都支援用於記錄的 預期結果 欄位:

延遲執行

驗證步驟支援延遲:

步驟類型快速參考


相關: