iOSモバイルデバイスの接続

iOSデバイスはUFT Mobileサーバーまたはコネクターマシンに接続できます。

始める前に

UFT Mobileにデバイスを接続する前に、お使いのデバイスがサポートされているを確認し、以前のバージョンのUFT Mobileを使用してインストールされたすべてのアプリを削除してください。

エージェントアプリに再署名する

エージェントアプリは、UFT Mobileで使用する各デバイスにインストールする必要のある標準のiOSアプリです。これらは、デバイスとUFT Mobileの間の通信チャネルを提供します。

エージェントアプリは、Apple Developerアカウントの開発証明書と、同じアカウントに属する開発プロビジョニングプロファイルを使用して再署名する必要があります。これらは、開発者のIDと、アプリの配布が許可されているデバイスのリストを提供します。

これらのアプリに再署名する方法の詳細については、エージェントアプリに再署名するを参照してください。

トップに戻る

デバイスの初期設定

初めてデバイスを接続する場合は、UFT Mobileに接続する各デバイスで以下の手順を実行してください。これらは1回限りの設定です。初期接続が設定されると、デバイスは「プラグアンドプレイ」になります。

  1. 設定 > 表示と明るさ > オートロックで最大時間を設定します。iOS 11.1以降で動作するデバイスを使用する場合は、必ずSIMカードまたはダミーのSIMカードをデバイスに挿入してください。または、自動ロックオプションを30秒に設定します。

  2. 不要なポップアップを回避するために、プリファレンス(iCloudなど)を設定します。

  3. テストしているアプリで必要な場合は、アクティブなインターネット接続があることを確認してください。

  4. iOS 11.1以前: UIオートメーションを使用する場合は、UIオートメーションが有効になっていることを確認してください ([設定] > [デベロッパ] > [UI Automation])。デバイスの接続後にこの手順を実行する場合は、デバイスを再起動するか、デバイスを取り外してから再度接続する必要があります。

  5. iOS 15以降: iOS 15以降では、必要な場合を除いて、パスコード/TouchID/FaceIDを設定しないことをお勧めします。
    デバイスでパスコード、TouchID、またはFaceIDがオフになっていない場合、WebdriverAgent-runnerを起動すると、iOSはユーザーが構成されたセキュリティメカニズムを介して認証することを要求します。これには、デバイスを手動で操作する必要があります。
  6. Safariブラウザーサポートの場合: 設定 > Safari > 詳細でJavaScriptとWebインスペクターを有効にします。
  7. ディスプレイと明るさの設定で、ディスプレイのズームがズームではなく標準に設定されていることを確認します。

トップに戻る

デバイスをUFT Mobileに接続する

まだ行っていない場合は、開発証明書を使用してエージェントアプリに再署名したことを確認してください。詳しくは、エージェントアプリに再署名するをご覧ください。

デバイスは、USBケーブルを介してUFT Mobileサーバーまたはコネクターマシンに接続できます。セルラーネットワークをサポートするiOSデバイスの場合、SIMカードがデバイスに含まれている必要があります。コネクターマシンにデバイスを接続する場合は、Linuxマシンにコネクターをインストールする、WindowsマシンにコネクターをインストールするまたはMacマシンにコネクターをインストールするを参照してください。

デバイスをUFT Mobileサーバーに接続するには:

  1. USBケーブルを使用してデバイスをサーバーマシンに接続します。

    2. 注: 一部のデバイスでは、デバイスを接続すると、通知、信頼、または場所のポップアップが表示される場合があります。これらのポップアップを受け入れます。

  2. エージェントがデバイスで実行されるまで待ちます。

    3. エージェントがデバイスで起動しない場合は、デバイスが認識されていることを確認してください。

    1. Linuxフォルダーに移動します。
      サーバーマシン:<サーバーインストールフォルダーへのパス>/server/libimobiledevice/linux/デフォルト: /opt/UFTMobile/server/libimobiledevice/linux/
      コネクターマシン:<コネクターインストールフォルダーへのパス>/Connector/libimobiledevice/linux/デフォルト: /opt/UFT Mobile/connector/libimobiledevice/linux/
    2. idevice_id –lを実行します


    このコマンドの結果は、デバイスID(UDID)のリストになります。コマンドが空の結果またはエラーメッセージを返す場合は、次のことを試してください。

    1. UFT Mobileサーバーまたはコネクターマシンにrootとしてログインします。
    2. 「usbmuxd」のプロセスIDを見つけます
      ps aux | grep '[u] sbmuxd'
    3. プロセスを強制終了します。
      kill –9 <processID>
    4. usbmuxdを再度開始します。
      usbmuxd
    5. idevice_id –lを再度実行して、サーバーがデバイスを認識しているかどうかを確認します。

    1. コマンドプロンプトウィンドウを開き、次のフォルダーに移動します。
      サーバーマシンに接続されているデバイス:<Windowsサーバーフォルダーへのパス>server\libimobiledevice\winまたは
      スタンドアロンコネクターに接続されているデバイス: <Windowsコネクターフォルダーへのパス>\libimobiledevice\win
    2. 次のコマンドを実行します。idevice_id –l

    このコマンドの結果は、デバイスID(UDID)のリストになります。デバイスがUSBポートに接続されているときにデバイスがリストされていない場合、これは次のことを意味している可能性があります。

    • USBポートが機能しない (ハードウェアの問題)
    • iTunesがインストールされていないか、コネクターコンピュータで最新バージョンのiTunesを使用していません。この場合、iTunesの最新バージョンをダウンロードする必要があります。

iOSデバイスに関する追加の考慮事項

まだ行っていない場合は、デバイスの [設定] > [開発者] > [UIオートメーションを有効にする] でUIオートメーションを有効にします。デバイスを切断し、5秒間待ってから、再接続します。

エンタープライズ証明書で署名されたアプリ(モバイルデバイス管理(MDM)ソリューションを使用しない)をインストールするユーザーは、アプリを初めてインストールするときにエンタープライズ開発者を信頼するように求められます。プロファイルを信頼するには、設定 > 一般 > デバイス管理に移動し、エンタープライズ開発者プロファイルを選択して信頼します。これらのアクションは、UFT Mobileを使用して、デバイス上でリモートで実行できます。

エンタープライズ署名付きアプリを初めてインストールするすべてのユーザーは、インターネット接続も必要になります。エンタープライズ開発者プロファイルがデバイスで信頼されると、それらが開かれているデバイスがインターネットに接続されている場合、同じプロファイルを持つ追加のアプリを再度信頼する必要はありません。テスト対象のアプリケーションのエンタープライズ開発者プロファイルが信頼されていない場合、エージェントはアプリを開くことができず、1009エラー: 「AUTと通信できません」はになります。

トップに戻る

iOSデバイスのトラブルシューティング

iOSデバイスのベストプラクティス

SIMカードがインストールされていない場合、XCUITESTを実行すると、SIMなしのポップアップが原因で、デバイスのプラグアンドプレイでクラッシュが発生する可能性があります。このクラッシュを回避するには、ダミーのSIMカード(推奨)を使用するか、iOS 11.1以降の次のガイドラインに従うことができます。

  1. デバイスのシステム設定で、デバイスの自動ロックを30秒に設定します。
  2. iOSエージェントで、UFTMアイコンを2回タップします。

  3. VNCタブを選択します。

  4. デバイスのロック(デバイスのシステムの自動ロック設定でも発生する可能性があります)を回避するために、デバイスロックの回避オプションを1分に設定します。
    注: この設定を接続されているすべてのiOSデバイスに適用するには、管理設定 > iOSオプションで設定を構成します。これにより、接続されている各デバイスで手動で設定を構成する必要がなくなります。

  5. アプリケーション起動アラートの却下も有効にすることを強くお勧めします。設定が無効になっていてシステムアラートが発生すると、デバイスロックの回避機能の機能がブロックされ、デバイスがロックされる可能性があります。
    注: この設定を接続されているすべてのiOSデバイスに適用するには、管理設定 > iOSオプションで設定を構成します。これにより、接続されている各デバイスで手動で設定を構成する必要がなくなります。

すでにデバイスにインストールされているアプリをインストールする場合は、必ずインストールしたアプリと同じ開発者証明書を使用してください。証明書が一致しない場合、インストールは失敗します。たとえば、デバイス上のアプリが証明書Aで署名されている場合、証明書Bで署名された同じアプリをインストールすることはできません。

デバイス上のアプリがEnterprise証明書で署名されており、開発者証明書で署名された同じアプリをインストールする場合も同様です。

回避策: 証明書が一致しない場合は、最初にデバイスに既にインストールされているアプリを削除してから、他の証明書を使用してアプリをデバイスに再インストールします。

注: エンタープライズ証明書で署名されたパッケージ化されていないハイブリッドアプリはサポートされていません。

Macintoshでアプリにコード署名するときは、AppleがKeychain Accessアプリによって信頼できる機関として認識されるように、Appleの信頼できる機関の証明書をインストールする必要があります。Appleの信頼できる機関の証明書がインストールされていない場合、Appleによって発行された証明書は無効として表示されます。詳しくはApple Developerのドキュメントを参照してください。

キーチェーンアクセスアプリで証明書が無効(赤)として表示され、その後に「この証明書は不明な機関によって署名されました」というエラーが表示される場合は、Apple Worldwide Developer Relations Certificate Authorityから新しい証明書をダウンロードしてインストールする必要があります。

次のように証明書をインストールします。

1.Apple Developerサポートサイトから証明書をダウンロードしてください。

2.証明書をダブルクリックします。

3.有効(緑色)であり、次のエラーが表示されないことを確認します。「この証明書は不明な機関によって署名されました」。

デバイスが画面をロックするか、一定の間隔を置いてスリープするように設定されている場合、これは再生に影響を与える可能性があります。

接続されているすべてのiOSデバイスがロックされないようにするには、管理設定 > iOSオプションで [自動ロックを禁止する] 設定を構成します。これにより、接続されている各デバイスで手動で設定を構成する必要がなくなります。

または、デバイスの画面がロックされないように手動で設定するには、スリープの表示設定が「なし」に設定されていることを確認してください。

デバイスがスリープ状態を続けて画面をロックする場合は、回避策を適用して、デバイスに疑似アクションを送信し、デバイスがスリープ状態にならないようにし、デバイスのロックを解除したままにすることができます。この回避策で使用される疑似アクションは、音量アップおよび音量ダウンコントロールです。テストの手順には影響しませんが、デバイス画面に一定の間隔でコントロールが短時間表示されます。

このアクションを設定するには:

  1. デバイスで、エージェントアプリケーションを開きます。

  2. UFTMアイコンで、画面を2回タップします。高度な開発者バーが画面の下部に表示されます。

  3. 右下のボタンVNCをクリックして、VNCサーバーの詳細設定を表示します。
  4. デバイスロックの回避機能の右側の値の列をクリックします。
  5. 疑似アクションをデバイスに送信する間隔を1～5分から選択します。

デバイスのクラッシュログは、いくつかの方法で取得できます。

方法 ファイルの場所
Linux サーバー/コネクターマシンでファイルを探す
  1. ディレクトリをlinuxディレクトリに変更します。
    サーバーマシンに接続されているデバイス:
    <Linuxサーバーフォルダーへのパス>/server/libimobiledevice/linux
    スタンドアロンコネクターに接続されているデバイス:
    <Linuxコネクターフォルダーへのパス>/connector/libimobiledevice/linux
  2. 次のコマンドを実行します。
    ./idevicesyslog –u <UDID>
Windows サーバー/コネクターマシンでファイルを探す
  1. コマンドプロンプトウィンドウを開き、次のフォルダーに移動します。
    サーバーマシンに接続されているデバイス: <Windowsサーバーフォルダーへのパス>\server\libimobiledevice\win
    スタンドアロンコネクターに接続されているデバイス: <Windowsコネクターフォルダーへのパス>connector\libimobiledevice\win
  2. 次のコマンドを実行します。
    idevicesyslog –u <UDID>
Macコネクターマシンでファイルを探す
  1. ディレクトリをlinuxディレクトリに変更します。
    cd /opt/UFTMobile/connector/libimobiledevice/mac
  2. 次のコマンドを実行します。
    ./idevicesyslog –u <UDID>
iTunesと同期する

iOS Mojave (10.14) のみ:
iTunesと同期して、ファイルをマシンにコピーします。ファイルは次の場所にコピーされます。

  • Windows: C:\Users\<USERNAME>\AppData\Roaming\Apple Computer\Logs\CrashReporter\MobileDevice\<DEVICE_NAME>
  • Mac: ～/Library/Logs/CrashReporter/MobileDevice/<DEVICE_NAME>
デバイスから共有する

デバイスの次の場所でクラッシュ情報を見つけます。

  • iOS 7.x: 設定 > 一般 > 情報 > 診断と使用法 > 診断および使用法データ
  • iOS 8.x/iOS 9.x/iOS 10.2: 設定 > プライバシー > 診断と使用法 > 診断と使用法データ
  • iOS 10.3以降: 設定 > プライバシー。下にスクロールして、[分析]をタップします。

Xcodeオーガナイザーを開きます

(macOSとXcodeが必要です)
  1. デスクトップマシンでXcodeを起動します。
  2. Xcodeオーガナイザーウィンドウを開きます。(ウィンドウメニュー > オーガナイザー、またはCmd-Shift-Shift-2。)
  3. 左側のサイドバーでデバイスを見つけて、デバイスログを選択します。

iOSでアプリのパッケージバージョンを記録すると、レコーダーはホームナビゲーションステップの後に2つの方向ステップを生成します。

既知の問題と問題解決

iOSデバイスのタイムゾーンは、コネクターマシンのタイムゾーンと一致している必要があります。タイムゾーンが調整されていない場合は、空のテキストファイルがダウンロードされます。

Appleのセキュリティ強化により、リモートスクリーンビューアを使用してデバイスでパスワードを入力すると、仮想キーボードが表示されず、セキュリティで保護されたパスワードフィールドにテキストが表示されません。物理デバイスでは、キーボードとパスワードの視覚的インジケーター (ドット) の両方が表示されます。テキスト/キーボードが表示されていなくても、期待どおりにテキストが送信されます。

オプションデバイスにテキストを送信を使用した場合も同じ動作が見られます。表示されていなくても送信されます。

パッケージ化されたiOSアプリの記録と再生では、accessibilityIdではなく、accessibilityLabelプロパティと値をオブジェクト認識に使用します。テストロジックがaccessibilityIdプロパティと値を使用して特定のオブジェクトを区別し、パッケージアプリのテストを計画している場合は、次のようにデバイスを設定します。

  1. デバイスで、エージェントアプリケーションを開きます。

  2. エージェントのロゴで、画面を2回タップします。高度な開発者バーが画面の下部に表示されます。

  3. 画面右下のVNCボタンをクリックして設定を表示します。
  4. パッケージアプリのaccessibilityIdを使用をオンに切り替えます。

SIMカードまたはダミーのSIMカードをデバイスに挿入します。

または、デバイスとデバイス上のエージェントアプリを次のように手動で構成します。

  1. デバイスで、[設定] > [ディスプレイと明るさ] > [自動ロック]を選択し、タイミングを30秒に設定します。
  2. デバイスでエージェントアプリを開きます。
  3. UFT Mobileアイコンを2回タップします。開発者向けオプションのタブバーが下部に表示されます。
  4. VNCアイコンをタップし、デバイスロックの回避を1分に設定します。

注: この設定を接続されているすべてのiOSデバイスに適用するには、管理設定 > iOSオプションで設定を構成します。これにより、接続されている各デバイスで手動で設定を構成する必要がなくなります。

起動またはレコードの開始後にアプリが常にクラッシュする場合、またはアプリケーションのインストールオプション (実際のオプション名は使用しているツールによって異なる場合があります) を選択してもアプリを起動できない場合は、次のいずれかを実行します。

  1. アンインストールまたは削除オプションを使用してテストを実行します。

    ツール オプション名
    UFT One [モバイル] タブ > [記録と実行環境設定] ダイアログボックスで [アンインストール] チェックボックスを選択します。
    TruClient [UFT Mobile設定] タブ > [TruClientの全般設定] ダイアログボックス > [実行後にアプリケーションを削除]
    Sprinter UFT Mobileのアプリケーションタブにあるアンインストールボタン。

  2. 再パッケージ化されたAUTをデバイスにインストールし、[再起動]オプションのみを使用します。

    ツール オプション名
    UFT [モバイル] タブ > [記録と実行環境設定] ダイアログボックスで再起動します。
    TruClient UFT Mobile設定タブ > [TruClientの全般設定] ダイアログボックスでアプリケーションを再起動します。
    Sprinter UFT Mobileの [アプリケーション] タブにある [再起動] ボタン

エージェントがデバイスで起動しない場合は、デバイスがサーバーまたはコネクターマシンによって認識されていることを確認します。

Linux

  1. 移動:
    サーバーマシンに接続されているデバイス
    /<サーバーのインストールへのパスフォルダー>/server/libimobiledevice/linux/
    または
    スタンドアロンコネクターに接続されているデバイス
    /<コネクターインストールフォルダーへのパス>/connector/libimobiledevice/linux/
  2. idevice_id –lを実行

このコマンドの結果は、デバイスID(UDID)のリストになります。コマンドが空の結果またはエラーメッセージを返す場合は、次のことを試してください。

  1. UFT Mobileサーバーまたはコネクターマシンにrootとしてログインします。
  2. 「usbmuxd」のプロセスIDを見つけます
    ps aux | grep '[u] sbmuxd'
  3. プロセスを強制終了します。
    kill –9 <processID>
  4. usbmuxdを再度開始します。
    usbmuxd
  5. idevice_id –lを再度実行して、デバイスが認識されているかどうかを確認します。

Windows

  1. コマンドプロンプトウィンドウを開き、次のフォルダーに移動します。
    サーバーマシンに接続されているデバイス:<Windowsサーバーフォルダーへのパス>server\libimobiledevice\winまたは
    スタンドアロンコネクターに接続されているデバイス:     <Windowsコネクターフォルダーへのパス>\libimobiledevice\win
  2. 次のコマンドを実行します。idevice_id –l

このコマンドの結果は、デバイスID(UDID)のリストになります。デバイスがUSBポートに接続されているときにデバイスがリストされていない場合、これは次のことを意味している可能性があります。

  • USBポートが機能しない (ハードウェアの問題)
  • iTunesがインストールされていないか、コネクターコンピュータで最新バージョンのiTunesを使用していません。iTunesの最新バージョンをダウンロードします。

デバイスが正しく接続されている場合は、エージェントランチャーアプリを手動で起動してみてください。信頼できないアプリ開発者の通知が表示された場合:

  1. 信頼をクリックします。
  2. デバイスを切断します。
  3. 5秒間待ってから、デバイスを再接続します。

テストを通じてエンタープライズ認定アプリ(UFT Oneなど)を起動しようとすると、Appleがユーザーにデバイス上のアプリを手動で承認するように要求するため、アプリを初めて起動したときに起動が失敗する場合があります。承認を求めるエラーメッセージは、テストツールのインターフェイス(UFT Oneなど)には表示されません。ただし、アプリを手動で起動すると表示されます。

解決策：アプリを手動で起動し、その証明書を承認します。次に、テストを通じて起動します。

XCUITestデバイスで記録する場合、URLナビゲーションは記録されませんでした。
回避策: URLへのナビゲーションがテストの最初のステップである場合は、JavaScriptインジェクションが完了していることを確認するために少なくとも5秒待ちます。アドレスバーを1回クリックしてキーボードを開きます。ダブルクリックしたり、[クリア]ボタンを押したりしないでください。PCキーボード(デバイスではなく)を使用して完全なURLを入力し、Enterキーを押します。

日付ピッカーを使用して日付を選択する場合は、必ず30秒以内に選択してください。時間選択の期間が30秒を超えると、エージェントはタイムアウトになります。この問題は、iOSデバイス上の非パッケージアプリにのみ適用されます。

デバイスが期待どおりに機能しない場合は、すべての設定をリセットしてみてください。たとえば、リモートアクセスが機能しない、タップが応答しない、アプリがインストールされないなどの場合は、元のデフォルト設定に戻します。

  • 一般 > リセット > すべての設定をリセットを選択します。
  • デバイスの初期設定の手順に従ってください。

    • iOS 11.1デバイスに接続するMacコネクターの場合: UFT Mobileに接続できない場合は、./ideviceadddocumentの実行時にコネクターログでエラーを確認してください。これは、信頼の問題を示しています。

  • デバイスを再接続し、iTunesを開いて、デバイスで信頼を押します。

    • エージェントがデバイスでの作業を停止した場合は、次の手順を実行します。

  • USBケーブルを抜いてデバイスを取り外します。
  • 5秒待ってから、USBケーブルでデバイスを再接続します。

    • それでも問題が解決しない場合:

  • エージェントアプリとすべてのテスト対象アプリケーション(AUT)をデバイスから削除します。
  • デバイスで開いているすべてのアプリを閉じます。
  • 5秒待ってから、デバイスをUSBポートに再接続します。

    • 最後の手段として:

  • デバイスを再起動します。エージェントが再インストールされます。
  • デバイス上のシステムポップアップをすべて受け入れます。
  • USBケーブルを外してデバイスのプラグを抜きます。5秒待ってから、デバイスを再接続します。

    • トップに戻る

    その他の参照項目：