ステップタイプリファレンス

これは、Qaptly Mobile Test Designer で利用可能なすべてのテストステップタイプの完全なリファレンスです。

概要

Qaptly は 9 つのステップタイプを 3 つのカテゴリに分類してサポートしています:

カテゴリ	ステップタイプ
インタラクション	Tap、Press、Swipe、Input、Key
検証	Verify(UI Hierarchy、AI Structured、AI Prompt)
制御	Wait、App Launch、Close App

インタラクションステップ

Tap

デバイス画面上の特定の場所をタップします。

ターゲットモード

座標モード

┌─────────────────────────────────┐
│ X: [0.5    ] (0-1 正規化)       │
│ Y: [0.3    ] (0-1 正規化)       │
└─────────────────────────────────┘

座標は正規化されています(0-1 範囲)
(0,0) は左上、(1,1) は右下

要素ロケーターモード

┌─────────────────────────────────┐
│ Strategy: [Text Contains ▼]     │
│ Value:    [Login        ]       │
└─────────────────────────────────┘

ロケーター戦略:

戦略	説明
Text Contains	要素がこのテキストを含む
Exact Text	要素テキストが完全に一致
Resource ID	リソース ID で一致
Class Name	クラス名で一致
Content Description	アクセシビリティラベルで一致

スクロールオプション

Auto-scroll: 表示されていない場合に要素を見つけるためにスクロール
Scroll to top first: スクロール位置をリセット
Max scroll attempts: 1-50(デフォルト: 10)

フォールバック座標

要素ロケーターを使用する場合、ロケーターが失敗した場合のフォールバック座標をオプションで設定できます。

Press

指定された期間、場所を長押しします。

パラメータ

パラメータ	範囲	デフォルト
Duration	500-10,000 ms	1,000 ms
Step	500 ms	-

Tap からのすべてのターゲットオプションが利用可能です。

Swipe

ある点から別の点へのスワイプジェスチャーを実行します。

パラメータ

┌─────────────────────────────────┐
│ Start: X1 [0.5] Y1 [0.8]        │
│ End:   X2 [0.5] Y2 [0.2]        │
│ Duration: [300] ms              │
└─────────────────────────────────┘

パラメータ	範囲	デフォルト
Duration	100-5,000 ms	プリセットによる

クイックジェスチャープリセット

Android プリセット

プリセット	説明
Notification	左上から下に引く
Quick Settings	右上から下に引く

iOS プリセット

プリセット	説明
Control Center (iOS 12+)	右上から下に引く
Control Center (iOS 11-)	下から上に引く
Notification Center	左上から下に引く
Back Gesture	左端からスワイプ

ユニバーサルプリセット

プリセット	説明
Swipe Left	左スワイプジェスチャー
Swipe Right	右スワイプジェスチャー

Input

テキスト入力フィールドにテキストを入力します。

パラメータ

┌─────────────────────────────────┐
│ Text:                           │
│ ┌─────────────────────────────┐ │
│ │ ここにテキストを入力...      │ │
│ │ (複数行をサポート)           │ │
│ └─────────────────────────────┘ │
└─────────────────────────────────┘

複数行テキストをサポート
環境変数: {{variable_name}}

Key

デバイスのハードウェアキーまたはシステムボタンを押します。

利用可能なキー

キー	説明
Back	Android の戻るボタン
Home	ホームボタン
Menu	メニュー/最近のアプリ
Volume Up	音量を上げる
Volume Down	音量を下げる
Power	電源ボタン
Enter	Enter/送信

検証ステップ

Verify

条件が満たされていることを確認します。3 つの検証方法が利用可能です。

方法 1: UI Hierarchy

UI ツリー内の要素の存在を確認します。 ターゲット設定 Tap と同じ - 座標または要素ロケーターを使用します。 プロパティを確認

プロパティ	タイプ
Class	テキスト一致
Text	テキスト一致
Resource ID	テキスト一致
Clickable	Boolean
Enabled	Boolean
Focusable	Boolean
Scrollable	Boolean
Selected	Boolean
Long Clickable	Boolean

ポーリング設定

┌─────────────────────────────────┐
│ ☑ Enable Polling                │
│ Expectation: [exists ▼]         │
│ Timeout: [15000] ms             │
│ Retry Interval: [1500] ms       │
└─────────────────────────────────┘

リトライ設定

┌─────────────────────────────────┐
│ ☑ Enable Retry                  │
│ Max Attempts: [2]               │
│ Retry Interval: [1500] ms       │
└─────────────────────────────────┘

方法 2: AI Vision Structured

Cloud Vision API を使用してスクリーンショット構造を分析します。 ワークフロー

Capture Screenshot をクリックして現在の画面を分析
Cloud VL Response(JSON)を表示
JSON レスポンスから条件を構築
リトライ設定を構成

条件ビルダー JSON レスポンスフィールドに基づいて条件を作成:

フィールドパス
演算子(equals、contains など)
期待値

方法 3: AI Vision Prompt

自然言語プロンプトで Cloud Vision API を使用します。 パラメータ

┌─────────────────────────────────┐
│ Verification Prompt:            │
│ "画面にログインボタンは         │
│  ありますか?"                   │
│                                 │
│ Expected Result: [true ▼]       │
│                                 │
│ Precision Mode:                 │
│ ○ Fuzzy Mode (best effort)      │
│ ● Precise Mode (stricter)       │
│                                 │
│ [Test Prompt]                   │
└─────────────────────────────────┘

パラメータ	説明
Prompt	自然言語の質問(最大 200 文字)
Expected Result	true または false
Precision Mode	Fuzzy(デフォルト)または Precise

制御ステップ

Wait

次のステップの前に遅延を導入します。

パラメータ

パラメータ	範囲	デフォルト
Duration	100-30,000 ms	1,000 ms
Step	100 ms	-

ユースケース

ページロードを待つ
アニメーションを待つ
ネットワークレスポンスを待つ

App Launch

デバイス上の特定のアプリケーションを起動します。

パラメータ

┌─────────────────────────────────┐
│ Search: [____________] [🔍]     │
│ ☐ Show running apps only        │
│                                 │
│ Package Name: [com.example.app] │
│ Display Name: [Example App]     │
│ Version: [1.0.0]                │
└─────────────────────────────────┘

起動オプション

オプション	説明
Clear Data	起動前にアプリデータをクリア
Wait for Ready	起動後に待つ時間(0-10s)
Force Restart	強制的に閉じて再度開く

エラーハンドリング

┌─────────────────────────────────┐
│ App Not Installed:              │
│   Action: [Stop ▼]              │
│                                 │
│ Launch Failed:                  │
│   Action: [Retry ▼]             │
│   Retry Count: [3]              │
│   Retry Interval: [2000] ms     │
│                                 │
│ Version Mismatch:               │
│   ☐ Enable                      │
│   Expected: [1.0.0]             │
│   Operator: [>= ▼]              │
│   Action: [Warning ▼]           │
└─────────────────────────────────┘

Close App

実行中のアプリケーションを閉じます。

パラメータ

┌─────────────────────────────────┐
│ App Identifier: [com.example]   │
│ [Fill from Launch]              │
│                                 │
│ ☐ Force Stop                    │
└─────────────────────────────────┘

オプション	説明
Force Stop	即座に終了(正常なクローズではなく)
Fill from Launch	最新の App Launch からパッケージをコピー

共通パラメータ

Expected Result

Web Action を除くすべてのステップは、ドキュメント用の Expected Result フィールドをサポートしています:

┌─────────────────────────────────┐
│ Expected Result:                │
│ [ページロード後にログインボタンが│
│  表示されるはずです]             │
└─────────────────────────────────┘

Delay Execution

検証ステップは遅延をサポートしています:

┌─────────────────────────────────┐
│ Delay Execution: [0] ms         │
│ (ステップ実行前に待機)          │
└─────────────────────────────────┘

ステップタイプクイックリファレンス

ステップ	アイコン	主なパラメータ
Tap	👆	ターゲット(座標/ロケーター)、UI 分析
Press	👇	ターゲット、Duration
Swipe	👉	開始/終了座標、Duration
Input	⌨️	テキストコンテンツ
Key	🔘	キー選択
Wait	⏱️	Duration
Verify	✅	方法、ターゲット、条件
App Launch	📱	パッケージ、起動オプション、エラーハンドリング
Close App	🛑	パッケージ、Force stop

関連:

​概要

​インタラクションステップ

​Tap

​ターゲットモード

​スクロールオプション

​フォールバック座標

​Press

​パラメータ

​Swipe

​パラメータ

​クイックジェスチャープリセット

​Input

​パラメータ

​Key

​利用可能なキー

​検証ステップ

​Verify

​方法 1: UI Hierarchy

​方法 2: AI Vision Structured

​方法 3: AI Vision Prompt

​制御ステップ

​Wait

​パラメータ

​ユースケース

​App Launch

​パラメータ

​Close App

​パラメータ

​共通パラメータ

​Expected Result

​Delay Execution

​ステップタイプクイックリファレンス

概要

インタラクションステップ

Tap

ターゲットモード

スクロールオプション

フォールバック座標

Press

パラメータ

Swipe

パラメータ

クイックジェスチャープリセット

Input

パラメータ

Key

利用可能なキー

検証ステップ

Verify

方法 1: UI Hierarchy

方法 2: AI Vision Structured

方法 3: AI Vision Prompt

制御ステップ

Wait

パラメータ

ユースケース

App Launch

パラメータ

Close App

パラメータ

共通パラメータ

Expected Result

Delay Execution

ステップタイプクイックリファレンス