Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
ロケーター戦略とは、テストの自動化中にアプリ内のユーザーインターフェイス (UI) 要素を検索して特定するために使用される方法です。**これらの戦略は、ボタン、テキストフィールド、その他のUIコンポーネントなど、画面上の特定の要素を見つける方法をAppiumに指示する検索パターンとして機能します。

サポートされている戦略

Appium Vegaドライバーでは、UiSelectorとXMLパス言語 (XPath) がサポートされています。その他のセレクター戦略は、このリリースではサポートされていません。

UiSelector

ネイティブの自動化フレームワークを利用してUI要素を特定する、プラットフォーム固有のロケーター戦略。VegaでUiSelectorを優先: この方法は、テストにおいて、同等のXPathクエリよりも約10倍速く要素を解決できました。また、検索範囲をサブツリーに絞り込むことのできる唯一の方法です(親内の要素を検索するを参照)。 UI Component Compositor (UCC) ツリーの要素の属性とキーが一致するargsオブジェクトを含むJSON文字列を渡します。 使用例:

受け入れられる引数キー

複数の要素の検索

複数要素の形式を使用して一致したものをすべて返させ、テストコードでフィルター処理します。

親内の要素を検索する

既知の親要素内の子を見つけるには、親要素に対してfindメソッドを呼び出します。これにより、親に絞り込んだ検索 (findElementFromElement) が行われます。XPathはこの位置では機能しないため、UISelectorが検索範囲をサブツリーに絞り込む唯一の方法です。

XPath

XMLのような構造内の要素のナビゲーションと選択を可能にするクエリ言語。 使用例:

サポートされているXPath構文

Appium Vega Driverは、オプションの述語を含む単一ノードテストをアプリの要素ツリーと照らし合わせて評価します。このツリーには、子孫が<child>のノードである<root>要素があります。 本ドライバーは以下の構文をサポートしています。
本ドライバーは複合パスやマルチステップパスをサポートしていません。次の構文は使用しないでください。
検索範囲をサブツリーに絞り込むには、複合XPathの代わりにUiSelectorを使用してください。

セレクター戦略の比較

ベストプラクティス

  1. 適切な戦略の選択
    • プラットフォーム固有のテストにはUiSelectorを使用します。
    • クロスプラットフォームの互換性が求められる場合はXPathを使用します。
    • パフォーマンスが重要な場合はUiSelectorを選択します。
  2. 要素の特定
    • 可能な場合は一意の識別子を使用します。
    • 絶対パスを使用しないようにします。
    • セレクターはできるだけシンプルにします。
    • セレクターの信頼性を定期的に検証します。
  3. パフォーマンスに関する考慮事項
    • 複雑なXPathクエリはテストの実行時間に影響する可能性があります。
    • 頻繁に使用する要素をキャッシュします。
    • 可能な場合はアプリ固有のIDを使用します。
  4. メンテナンスに関するヒント
    • ロケーター戦略を文書化します。
    • ロケーターを定期的に確認します。
    • UIの変更に合わせて更新を行います。
    • クロスプラットフォームの互換性を保ちます。
    • テストコードで意味のわかる名前を使用します。

最終更新日 2025年10月31日