argent-create-flow

Argent フローを作成する

Argent フローは、.argent/flows/<name>.yaml に保存される、リプレイ可能な一連の手順です。

保存済みの QA テストケース、チケット、または受け入れ基準の場合は、まず argent-qa-flows を読み込んでください。決定的なセットアップ、受け入れの証拠、2 パスの証明が追加されます。

関連するリファレンスを読む

• フローを作成または変更する前に、ライブでの作成を最後まで読んでください。
• YAML を整えたり、組み立てたり、手動で確認したりする場合は、フロー YAMLを読んでください。Vega の場合は、リモートツールまたはキーボードツールを記録する前に、そのプラットフォームの制限を読んでください。
• フローは実機の iPhone（kind が "device" の iOS list-devices エントリ）で実行されますが、リプレイ時に自動で実機へバインドされることはありません。シミュレーターが起動していない場合も同様です。電話の udid を device（CLI の --device）に渡してください。また、実行できるのは connected の電話のみです。pinch／rotate のステップは、ライブツールと同様に実機では失敗します。ハードウェア上では、フローツリーは describe ツリーです。ID とロールは同じで、UIView 階層はありません。ハードウェアの仕様については argent-ios-device-interact を参照してください。
• キャプチャ時の警告、未加工の座標、利用できないツリー、タイミングのずれた遷移、オーバーレイ、またはリプレイの失敗については、信頼性と復旧を読んでください。

絶対に守るべきルール

1. 最初のウォークスルーを記録します。 初回起動またはアプリ内操作の前に、レコーダーを開始してください。事前に練習した手順を再構成してはいけません。
2. 状態が現れた時点でチェックを記録します。 await-ui-element をライブで記録し、その後、整える段階で変換してください。echo が記録するのは意図や診断コンテキストであり、アプリの動作や判定ではありません。スクリーンショットは人が確認する証拠であり、実行可能な判定ではありません。要素が存在しないことを確認するには、まず同じセレクターを visible として記録し、要素を取り除く操作を行ってから、hidden として記録してください。
3. セマンティックターゲットを使用します。 厳密な ID を優先し、次に安定したテキストまたはアクセシビリティラベルを使ってください。画面外の要素には scroll-to を使用してください。未加工座標に関する警告はすべて、ただちに座標フォールバックゲートを通じて解決してください。
4. 画面が変わるたびに、その変化を証明します。 遷移先だけを対象とする ID チェックを記録してください。整える段階では、その後に await: { idle: true } を追加してください。静止していることは画面の同一性を証明しません。また、idle は警告付きで成功する場合があります。
5. 実行した動作だけを整えます。 記録したステップの意味を変えずに変換してください。不足している操作や構造チェックは、ライブで記録してください。記録せずに追加できるのは、計画済みの snapshot:、ナビゲーションの await: { idle: true }、およびドキュメントに記載された Chromium のパッケージング用 launch: のみです。
6. スクリプトはユーザーが要求した場合にのみ使用します。 フロー YAML：ローカルスクリプトを読んでから、各スクリプトを flow-add-script で記録してください。
7. 最終的な YAML を最初から最後までリプレイします。 通常のフローでは、中断のない全体パスを 1 回実行する必要があります。argent-qa-flows では、連続して 2 回実行する必要があります。

安定したセレクター

安定したセレクターはアプリのコードによって固定されており、アカウント、データ、時間、件数、順序、およびフローがサポートするすべてのロケールと環境が変わっても維持されます。settings-screen のような ID を優先してください。Today、Item 4、ユーザー名、カウンター、タイムスタンプなどの値を条件にしてはいけません。

フロー専用のセレクタースコープ

整える段階では、繰り返し現れる要素を区別するために within、after、next を使用してください。フレームを基準とするセマンティクスと失敗ケースについては、フロー YAML：関係スコープを読んでください。

ワークフロー

1. フローの種類を選択します。
   • e2e： echo: または script: 以外で最初に現れるステップが launch: です。フローがプロセスの起動を制御します。
   • fragment： 先頭に launch はありません。正確な executionPrerequisite を宣言してください。
2. ライブでの作成に従い、開始し、検証済みのステップを一度に 1 つずつ記録し、完了後に整え、監査してリプレイします。
3. ファイル、リプレイコマンド、結果、前提条件または副作用、および座標や未加工ジェスチャーに関するすべての例外を報告します。

事前記録

3 回以上のインタラクションを繰り返す前に、ユーザーに伝えて記録を開始してください。その実行を記録し、後で再生してください。完了した操作経路を遡って記録することはできません。

修正

再生に失敗した場合は、信頼性と復旧に従ってください。最初の相違点を調べ、根拠のある最小単位を修正し、監査して、フロー全体を再生してください。修正サイクルが 2 回失敗したら停止してください。合格させるために、要求されたチェックを決して緩めないでください。