test-suite

2024.10

true

Test Suite ユーザーガイド

デリバリー:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 2024年11月11日

トラブルシューティングシナリオ

問題が発生した場合は、以下のトラブルシューティングシナリオを検討してください。

モバイルデバイスオートメーション

以下のトピックでは、モバイルデバイスオートメーションの問題と解決策について説明します。

ワークフローやアクティビティでエラーが発生する

説明: Studio のワークフローで予期しないエラーが発生し、インストール済みのアクティビティパッケージのバージョンが表示されません。

原因: プロジェクト内で、UI.Automation アクティビティパッケージのメジャーバージョンが Mobile.Automation アクティビティパッケージのメジャーバージョンと一致していません。たとえば、インストールされている UI.Automation パッケージのメジャーバージョンが 22.10.x で、インストールされている Mobile.Automation パッケージのメジャーバージョンが 22.4.x である場合です。

解決策: プロジェクトにインストールされている UI.Automation アクティビティパッケージと Mobile.Automation アクティビティパッケージのメジャーバージョンが一致していることを確認します。たとえば、v22.10.x の UI.Automation.Activities は v22.10.x の Mobile.Automation.Activities とのみ組み合わせます。

重要: UI.Automation および Mobile.Automation アクティビティパッケージでは、常に利用可能な最新のパッチを使用してください。たとえば、ｖ22.10 の UI.Automation または Mobile.Automation がインストールされている場合は、v22.10 で利用可能な最新のパッチをダウンロードします。

wd/hub/ session のルートが見つからない

条件: Appium 2.0 を使用している場合。

説明: /wd/hub/session のルートが見つかりません。

解決策: Appium セッションを開始する前に、パラメーター --base-path /wd/hub を手動で追加します。

非標準のすべての機能にベンダープレフィックスが必要

条件: Appium 2.0 を使用している場合。

説明: 非標準のすべての機能には、ベンダープレフィックスを付ける必要があります。

解決策: 次のように、すべての機能にプレフィックス appium: を手動で追加します。

コマンドプロンプトまたはターミナルで、「--default-capabilities "{\"systemPort\": 8201}"」ではなく、「--default-capabilities "{\"appium:systemPort\": 8201}"」と入力します。
モバイルデバイスマネージャーの [デバイスを追加] タブで、希望する追加機能の名前の前にプレフィックス appium: を手動で追加します。

automationName を空白にできない

条件: Appium 2.0 を使用している場合。

説明: automationName 機能は空白にできません。

解決策: appium: をプレフィックスとして追加します。たとえば、appium:automationName です。

インストールされているドライバーが見つからない

条件: Appium 2.0 を使用している場合。

説明: 指定した機能をサポートするためのインストール済みドライバーが見つかりませんでした。

Appium 2.0 では、必要なドライバーが自動的にはインストールされません。別途ダウンロードする必要があります。

解決策: お使いのプラットフォームに必要なドライバーをインストールします。

Android デバイスの場合は、コマンド appium driver install uiautomator2 を使用して、uiautomator2 ドライバーをインストールします。
iOS デバイスの場合は、コマンド appium driver install xcuitest を使用して、xcuitest ドライバーをインストールします。

Android

以下のトピックでは、Android デバイスの問題と、対応する解決策について説明します。

`InvalidArgumentException` が原因でケーパビリティの接続が失敗する

説明: ローカルデバイスとアプリケーション間の接続が、ケーパビリティで予期される形式との不一致に起因する InvalidArgumentException のために失敗することがあります。この問題は、Appium が Boolean 値を予期しているのに対し、ケーパビリティが String として入力されている場合に発生します。内容を示すエラーメッセージには以下が含まれます。

Failed to create session. 
A new session could not be created. 
Details: io.appium.uiautomator2.common.exceptions.InvalidArgumentException: 
Invalid '<capability name>' setting value type. 
Got java.lang.String. Expected: java.lang.BooleanFailed to create session. 
A new session could not be created. 
Details: io.appium.uiautomator2.common.exceptions.InvalidArgumentException: 
Invalid '<capability name>' setting value type. 
Got java.lang.String. Expected: java.lang.Boolean

解決策: ローカルデバイスから次のアプリをアンインストールします。

io.appium.uiautomator2.server
io.appium.uiautomator2.server.test

`WebDriverException` が原因でアクティビティが失敗する

説明: Android デバイスを自動化するモバイルオートメーションワークフローを実行すると、WebDriverException が発生することがあります。このエラーは通常、「

Parameters were incorrect. We wanted {\"required\":[\"text\"]} and you sent [\"value\"]", "FaultCode":"WebDriverException"}

」と表示されます。

解決策: UiAutomator 2 の現在のバージョンをアンインストールします。その後、次のコマンドを指定の順序で使用して、新しいバージョンをインストールします。

appium driver uninstall uiautomator2
appium driver install uiautomator2@2.29.0。2.29.0 はインストールするバージョンです。利用可能な任意のバージョンに置き換えることができます。

プロキシが原因で Appium のインストールが失敗する

説明: コマンド npm install -g appium (Appium 1.x の場合)、または npm install -g appium@next (Appium 2.0 の場合) の実行が失敗します。この問題は、コマンドをプロキシの背後で実行していることが原因で発生します。このエラーでは、次のメッセージが表示されます。

npm ERR! network This is a problem related to network connectivity.
npm ERR! network In most cases you are behind a proxy or have bad network settings.
npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. 
See: 'npm help config'npm ERR! network This is a problem related to network connectivity.
npm ERR! network In most cases you are behind a proxy or have bad network settings.
npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. 
See: 'npm help config'

解決策: プロキシを使用するように npm (Node Package Manager) を設定します。以下の手順を実行します。

お使いのプロキシサーバーのアドレスとポート番号を取得します。
- [インターネットオプション] に移動します。
- [接続] タブを開きます。
- [LAN の設定] を選択し、[アドレス] および [ポート] フィールドの内容をコピーします。
Node.js のコマンドプロンプトに戻り、次の形式のコマンドを実行します。
- HTTP プロキシの場合: npm config set http://your_proxy_address:your_port_number
- HTTPS プロキシの場合: npm config set https://your_proxy_address:your_port_number
コマンド npm install -g appium (Appium 1.x の場合)、または npm install -g appium@next (Appium 2.0 の場合) を再度実行します。

指定した Web コンテキストにアクセスできない

説明: 指定した Web コンテキストにアクセスできませんでした。Android WebView がデバッグ可能であることを確認してください。Web コンテキストへのアクセスの詳細については、「Remote debugging WebViews」をご覧ください。

解決策:

認識されない Web コンテキストで、WebView をネイティブセレクターとして使用します。
セレクターが Web アプリケーションでは機能するもののアプリケーションでは機能しない場合、そのアプリケーションでは WebView のデバッグは有効化されません。この場合、「Get started with remote debugging Android WebViews」および「Remote debugging WebViews」をご覧ください。

デバイスが認可されていない

説明: デバイスが認可されていません。

解決策: 次の手順を実行します。

コマンド adb devices を使用して、存在するデバイスを確認します。
スマートフォンでのデバッグを取り消します。
コマンド adb kill-server、adb start-server をこの順序で使用して、adb サーバーを再起動します。
デバイスを再接続し、そのデバイスでの接続に同意します。

起動画面からの開始時にブラウザーオートメーションが起動する

説明: Android デバイスが、指定したアプリではなくブラウザーオートメーションを起動するため、エラーが発生します。

解決策: 代わりに Web ブラウザーで開始します。

Android アプリが起動しない

説明: 作成した Android アプリがモバイルデバイスマネージャーで起動しません。

解決策:

アプリケーション上でホバーし、[編集] をクリックします。
[アプリのパッケージ] フィールドと [アプリのアクティビティ] フィールドにアプリの情報を追加します。

iOS

以下のトピックでは、iOS デバイスの問題と解決策について説明します。

iOS 13 で WebView 要素をクリックできない

説明: WebView 要素をクリックしてもセレクターが機能せず、要素を自動化できません。

解決策: シミュレーターを最新バージョンの iOS と Appium 2 で使用します。

iOS 物理デバイスの起動に失敗する

説明: iOS 物理デバイスの起動に失敗します。

解決策: 次の手順を実行します。

デバイスで証明書が信頼されていることを確認します。デバイス上で [設定] > [一般] > [プロファイルとデバイス管理] に移動し、メールのエントリ (例: Apple Development: username@email.com) をタップ後、証明書を信頼します。会社のアカウントを使用しているデバイスでは、この操作は不要です。
ポート 8100 にアクセスできないというエラーが発生する場合は、Appium をいったん閉じて (ctrl + c) 再起動します。
別のエラーが発生する場合は、「Appium XCUITest Driver Real Device」を参照することをお勧めします。