Appium Inspectorによるアプリの検査

Appium InspectorはAppiumのコンパニオンツールで、ネイティブアプリ、モバイルアプリ、ハイブリッドアプリを対象とした信頼性の高い自動テストスクリプトを作成するのに役立ちます。アプリの画面とページ構造を表示して、基になっているUI要素とプロパティを特定できます。

Appium Inspectorは、GitHubでホストされている無料のオープンソースツールです。アプリのUIを可視化できるため、次のような操作が可能になります。

• アプリの画面とページ構造を検査する
• UI要素を選択し、そのプロパティを表示する
• XPath式を使用して要素を検索する
• 選択した要素に対してクリックなどのアクションをトリガーする
• 自動テスト用にスクリプトを記録する

前提条件

Vegaとの統合に向けたAppiumのインストールの手順が完了していることを確認してください。

アプリの検査

1. デバイスを接続します。

   Fire TV Stick：

   kepler exec vda connect <デバイスのIP>
   

   コードをコピー クリップボードにコピーしました。

   kepler exec vda devices
   

   Vega仮想デバイス

   コードをコピー クリップボードにコピーしました。

   kepler virtual-device start
   

2. 自動化ツールキットを起動します。

   コードをコピー クリップボードにコピーしました。

   vda shell touch /tmp/automation-toolkit.enable
   

3. Appiumサーバーを実行します。

   コードをコピー クリップボードにコピーしました。

   appium
   

4. Appium Inspectorを起動します。

   Macの場合： [アプリケーション] フォルダまたはSpotlightの検索結果から開きます。

5. 機能を追加します。

   必須の機能については、Appiumセッションの管理を参照してください。

6. [Start session] ボタンをクリックしてAppium Inspectorを開始します。

   

   JSON機能の例：

   コードをコピー クリップボードにコピーしました。

   {
     "platformName": "Kepler",
     "appium:automationName": "automation-toolkit/JSON-RPC",
     "kepler:device": "vda://default"
   } 
   

   Appium Inspectorは、デバイスに表示されているコンテンツのスクリーンショットを取得し、XMLソースを [App Source] パネルに表示します。

   

   表示されているコンテンツを更新するには、[Refresh Source and Screenshot] ボタンをクリックします。

その他の機能

要素の選択

[App Source] パネルで、表示されたXMLツリーから要素を選択できます。

要素のプロパティと使用可能なアクションが、[Selected Element] パネルに表示されます。

xpath式を使用した要素の検索

Appium Inspectorでは、選択中の要素のidを使用するXPathセレクターが提案されます。ただし、id値は動的に生成される場合があります。より信頼性の高い方法で要素を選択するには、代わりにtest_id属性か、roleやdescriptionなどのほかの属性を使用します。

有効なxpath式の例

• //*[@role="button"]は、role="button"属性を含む要素をすべて取得します。
• //*[contains(@description, "Music")]は、description属性にMusicを含む要素をすべて取得します。

xpath式をテストするには、[Search] ボタンを使用します。

clickのトリガー

選択されている要素に対してクリックをトリガーするには、[Tap] アイコンを使用します。

スクリプトの記録

Appium Inspectorでは、アプリとの対話操作に基づいてスクリプトを記録できます。

1. Appium Inspectorを起動し、デバイスに接続します。

2. 上部のバーにある [Record] アイコンをクリックして、記録を開始します。

   

3. 必要なアクションを実行します。

   [Search for Element] パネルで、必要なアクションを実行します。たとえば、要素を検索し、[Tap] アイコンを使用してそれらを操作します。記録中、実行したすべてのアクションがスクリプト領域に表示されます。

4. 記録を停止するには、もう一度 [Record] アイコンをクリックします。

   生成されたスクリプトは、自動テストの土台として使用したり、必要に応じて変更したりできます。この例では、記録されたアクションがsampleTestメソッドにキャプチャされています。

   スクリプトの記録言語を変更するには、[Recorder] パネルの右上隅にあるドロップダウンメニューを使用します。

トラブルシューティング

問題が発生した場合は、community.amazondeveloper.comで詳細を報告してください。

• 前へ - Appiumコマンド

---

Last updated: 2025年10月1日