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

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

始める前に

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

注: iOS 17は現在、Macコネクターでのみサポートされています。iOS 17デバイスの接続の詳細については、Macマシンにコネクターをインストールするの前提条件を参照してください。

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

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

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

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

トップに戻る

デバイスの初期設定

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

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

  2. [設定] > [一般] > [ソフトウェアアップデート] で自動アップデートをオフにしてください。

  3. Safariブラウザーサポートの場合: 設定 > Safari > 詳細でJavaScriptとWebインスペクターを有効にします。
  4. [画面表示と明るさ] の設定で、[拡大表示] が [拡大] ではなく [標準] に設定されていることを確認します。
  5. テストしているアプリで必要な場合は、アクティブなインターネット接続があることを確認してください。

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

  7. 特定のiOSバージョンの追加手順:
    8. iOS 15以降 iOS 15以降では、必要な場合を除いて、パスコード/TouchID/FaceIDを設定しないことをお勧めします。
    デバイスでパスコード、TouchID、またはFaceIDがオフになっていない場合、WebdriverAgent-runnerを起動すると、iOSはユーザーが構成されたセキュリティメカニズムを介して認証することを要求します。これには、デバイスを手動で操作する必要があります。
    iOS 16以降

    デベロッパーモードを有効にする必要があります。デベロッパーモードは、iOS 16以降で実行されているデバイスでは自動的に有効になります。デベロッパーモードは、デバイスにパスコードが設定されていない場合にのみ自動的に有効になります。テストに使用するデバイスにはパスコードを設定しないことをお勧めします。デバイスにパスコードがある場合は、[設定] > [プライバシーとセキュリティ] > [デベロッパモード] でデベロッパーモードオプションを有効にします。デベロッパーモードの詳細については、Apple Developerのドキュメントを参照してください。

トップに戻る

Digital Labへのデバイスの接続

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

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

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

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

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

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

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

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


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

    1. Digital Labサーバーまたはコネクターマシンに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デバイスに関する追加の考慮事項

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

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

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

トップに戻る

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

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

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

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

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

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

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

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

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

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

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

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

キーチェーンアクセスアプリで証明書が無効 (赤) として表示され、その後に “This certificate was signed by an unknown authority” というエラーが表示される場合は、Apple Worldwide Developer Relations Certificate Authorityから新しい証明書をダウンロードしてインストールする必要があります。

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

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

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

3.有効 (緑色) であり、次のエラーが表示されないことを確認します。“This certificate was signed by an unknown authority”

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

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

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

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

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

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

  2. Digital Labアイコンで、画面を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と同期する

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

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

デバイスの次の場所でクラッシュ情報を見つけます。[設定] > [プライバシー]。下にスクロールして、[分析] をタップします。

Xcode Organizerを開く

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

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

既知の問題と問題解決

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

ソフトキーボードなどの特定の要素は、物理デバイスには表示されますが、リモートデバイスのディスプレイには表示されません。これは、Appleのセキュリティ強化によるものです。これらの「見えない」要素が他の要素の上に配置され、ユーザーがそれらを操作できない場合があります。たとえば、ソフトキーボードを [ログイン] ボタンの上に配置して、ユーザーがクリックできないようにすることができます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Linux

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

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

  1. Digital Labサーバーまたはコネクターマシンに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の最新バージョンをダウンロードします。

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

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

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

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

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

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

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

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

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

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

    • 最後の手段として:

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

    • トップに戻る

    その他の参照項目: