Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
Appium Vegaドライバーは、以下のWorld Wide Web Consortium (W3C) WebDriverコマンドをサポートしています。**

find_element

find_elementfind_elementコマンドは、指定されたセレクター戦略に一致する最初のUI要素を特定します。
Appium Vega XPath ドライバーで使用するには、ロケーターストラテジーを使用できます。By.xpath()

引数

一般的なXPath式のコンポーネント

XPathXPath式は次の部分から構成されます。
  • 軸 - 子孫、祖先、後続など、検索の方向を指定します。
  • ノードテスト - 要素、属性、text()など、選択するノードタイプを指定します。
  • 述部 - 属性値、位置、カスタム関数などのさまざまな条件に基づいて、選択されたノードをフィルタリングします。
それぞれの構成部分を含むXPathXPath式の例を次に示します。

find_elements

find_elementsfind_elementsコマンドは、複数のUI要素を特定します。さまざまなロケーター戦略をサポートし、要素の配列を返します(配列は空になる場合もあります)。このコマンドは以下の目的で使用します。
  • リスト全体に対する反復処理
  • 複数のコントロールの検証
最適なパフォーマンスと信頼性を実現するため、特定のロケーター戦略と適切なタイムアウトを使用してください。複雑なUIシナリオには、階層型XPathXPathなどの高度な手法を使用します。

引数

find_elementとfind_elementsの比較

親要素のコンテキスト内で子要素を見つけるには、子要素を含む囲み要素を探します。

click

clickclickコマンドは、特定の要素の中心点をクリックする操作をシミュレートします。さまざまなロケーター戦略が用意されていますが、要素をIDによってクリックすることで、確実で保守しやすいアプローチになります。

引数

clickclickコマンドは先に特定済みの要素に対して動作するため、引数は必要ありません。

既知の制限事項

デバイスが実際のテレビやモニターではなくビデオキャプチャカードに接続されている場合、click()click()コマンドが失敗することがあります。自動化ツールキットとディスプレイコンポジターの間で行われる座標変換が原因で、タッチイベントが誤った座標で発生することがあるためです。 回避策:
  • 代わりに十字キーによるナビゲーション (setFocus+ pressKeyCode 付きDPAD_CENTER) を使用してください。element.click()

send_keys

send_keyssend_keysコマンドは、文字列引数を受け取り、要素へのテキスト入力をシミュレートします。

引数

ベストプラクティス:

  • ターゲット要素にフォーカスがあり、入力を受け取る準備ができていることを確認する。
  • キーを送信する前に要素のフォーカスを確認する。キーを送信する前に、click()click ()などのコマンドを使用して要素を選択する。
  • 一部のデバイスやアプリでは高速または同時の入力によって問題が発生する可能性があるため、キー送信の間に短い遅延を追加する。

get_attribute

get_attributeget_attributeコマンドは、UI要素から指定した属性の値を取得します。

引数

属性の一覧

get_element_text

get_element_textget_element_text - UI要素に表示されているテキストコンテンツを取得します。非表示のテキストを除き、ユーザーに表示されているテキストを返します。

引数

get_element_textコマンドは先に特定済みの要素に対して動作するため、引数は必要ありません。

ベストプラクティス:

  • テキストの取得を試みる前に、要素が存在することを確認してください。
  • 空のテキストが返される可能性を適切に処理してください。
  • アサーションではテキストの書式や特殊文字を考慮してください。
  • 必要に応じて適切な待機戦略と共に使用してください。

press_keycode

press_keycodepress_keycodeコマンドは、デバイスで特定のハードウェアキーを押す操作をシミュレートします。アプリの状態やテストフローに影響する可能性があるため、注意して使用してください。数字のキーコードのみを受け入れます(16進コードには対応していません)。

引数

tap

taptapコマンドは、画面上の特定の座標セットをタップする操作をシミュレートします。このコマンドはタッチ操作を正確に制御できますが、注意が必要です。

引数

ベストプラクティス:

taptapではきめ細かい制御が可能ですが、テストの安定性と保守性を保つためには、要素ベースの対話操作を優先することをお勧めします。要素ベースの方法が実用的でない場合にのみ使用してください。

is_enabled

is_enabledis_enabledコマンドは、UI要素の現在の状態を確認します。有効(対話可能)の場合はtruetrue、無効(対話不可能)の場合はfalsefalseを返します。
有効な状態の要素は、ユーザーによる対話操作が可能です。ただし、有効になっても対話操作性が保証されるわけではありません。要素は有効な状態として機能していても、可視状態でない場合や、操作を妨げるその他の要因が存在する場合があります。インタラクティビティを検証するには、is_enabled``is_displayedのような他のコマンドと組み合わせてください。

引数

is_enabledis_enabledコマンドは先に特定済みの要素に対して動作するため、引数を受け取りません。

ベストプラクティス:

  • is_enabledis_enabledは、要素に対するさまざまな状態チェックの一部として使用してください。
  • is_enabled要素の相互作用を判断するのに頼らないでください。
  • 要素の状態を確認する前に待機戦略を実装してください。

is_displayed

is_displayedis_displayedコマンドは、UI要素が画面に表示されているかどうかを確認します。表示されている場合は戻り、true``false非表示の場合は戻ります。
要素は、画面の境界内に表示されているときに表示状態になります。

引数

is_displayedコマンドは先に特定済みの要素に対して動作するため、引数を受け取りません。

ベストプラクティス:

  • is_displayedis_enabledは、要素に対するさまざまな状態チェックの一部として使用してください。

implicitly_wait

implicitly_waitimplicitly_waitコマンドは、使用できない要素を検索するときにドライバーが待機する時間を設定します。このコマンドはテストの安定性を高めますが、注意して使用してください。複雑なシナリオの場合は、implicitly_wait``explicit waitsを組み合わせて信頼性と実行速度のバランスを取ってください。
詳細な実装については、Set Implicit Wait Timeout(英語のみ)を参照してください。

引数

ベストプラクティス:

  • implicitly_waitテストの開始時に設定します。
  • 必要に応じて、適切なデフォルト(たとえば、0ms)にリセットします。

get_window_rect

get_window_rectget_window_rectコマンドは、画面全体のサイズを基準として、現在のアプリウィンドウのサイズと位置を取得します。 例: Python
Java
値の説明は以下のとおりです。
  • xx - ウィンドウの左の座標
  • yy - ウィンドウの上の座標
  • widthwidth - ウィンドウの幅
  • height-ウィンドウの高さ

引数

引数は必要ありません。

ベストプラクティス:

さまざまな画面サイズとレイアウトを処理する堅牢なテストスクリプトを作成するには、get_window_rectget_window_rectをほかのコマンドと組み合わせて使用します。

get_page_source

get_page_sourceget_page_sourceコマンドは、アプリの現在のページソースを取得します。ページソースは、基盤となるUI構造を表します。 Python
Java

引数

get_page_sourceコマンドには引数は必要ありません。

get_screenshot

get_screenshotget_screenshotコマンドは、現在のアプリの状態をbase64エンコードされた文字列としてキャプチャします。このコマンドを使用するときは、ユーザーのプライバシーに配慮してください。デジタル著作権管理(DRM)コンテンツをキャプチャしないでください。 Python
Java
すべてのメソッドと例の一覧については、Appiumのドキュメント(英語のみ)を参照してください。

引数

このコマンドには引数は必要ありません。

install_app

install_appこのコマンドは、デバイスにアプリをインストールします。VPKGファイルパスは、ホスト(Appiumサーバー)のファイルシステム上で使用できる必要があります。テストの開始時にこのコマンドを使用して、環境セットアップを自動化します。 例: Python:
Java:

引数

activate_app

activate_appactivate_appコマンドは、指定されたアプリをデバイス上で起動するかフォアグラウンドに移動します。このコマンドは、アプリの切り替えのシナリオをテストしたり、ほかのテストアクションを実行する前に特定のアプリがアクティブであることを確認したりするために役立ちます。 例:(注:画面の出力に関する日本語表記は説明のために提供しています。実際には英語で表示されます。) Python:
Java:

引数

ベストプラクティス

appIdアプリを正しく起動するには、vpm list applicationsを実行してください。

terminate_app

terminate_appこのコマンドは、現在実行中のアプリを停止します。このコマンドは、強制終了時のアプリの動作をテストする場合や、テストケース間でクリーンな状態を保証する場合に使用します。 例:

引数

remove_app

remove_appこのコマンドは、デバイスからアプリをアンインストールします。 例:

引数

execute_script

execute_scriptこのコマンドは、シェルコマンドを実行するか、API を呼び出しますjsonrpc。 デバイス上でシェルコマンドを実行するには appium_driver.execute_script("shell", "echo hello world") # Appiumパブリックインターフェイスで公開されていないjsonrpcjsonrpc APIを呼び出すには: appium_driver.execute_script("jsonrpc: getScreenContext", "")

push_file

push_filepush_fileコマンドを使用すると、ファイルをデバイスに直接転送できます。ファイルのコンテンツをbase64でエンコードされた文字列として提供する必要があります。これは、テストデータ、構成ファイル、そのほかテストの実行中に必要なファイルをアップロードするユースケースに役立ちます。 Python:
Java:

引数

pull_file

pull_fileこのコマンドを使用すると、デバイスから直接ファイルを転送できます。このコマンドは、ファイルのコンテンツをbase64でエンコードされた文字列として返します。これは、テスト結果、構成ファイル、そのほかテストの実行中や実行後に必要なファイルをダウンロードするユースケースに役立ちます。 Python:
Java:

引数

D-Padナビゲーション

execute_scriptこの関数は、を介して Linux 入力イベントコードを送信しますjsonrpc: injectInputKeyEvent method。この機能により、アプリはユーザー入力イベントをプログラムでシミュレートして自動化とテストができます。 この関数は指定されたコマンドとキーイベントをスクリプト内で実行し、方向パッド入力用に設計されたアプリでのD-Padナビゲーションを可能にします。 次の表は、入力イベントコードの一覧です。Python: 定義されているキーコードの包括的な一覧については、入力イベントコード(英語のみ)を参照してください。入力イベントコードのリファレンスは、アクセスしやすく使いやすいキーボードエクスペリエンスを作成するために役立ちます。特定のキーコードのサポートは、デバイスタイプと入力構成によって異なります。非標準のキーボードレイアウトや動作について、キーボード入力処理をテストしてください。 次のコマンド形式を使用します。injectInputKeyEvent
たとえば、下に移動するには次のコマンドを使用します。

最終更新日 2026年8月21日