Windowsマシンにコネクターをインストールする

デバイスコネクターは、デバイスをDigital Labに接続するためのスタンドアロンコンポーネントです。 コネクターをスタンドアロンコンポーネントとしてWindowsマシンにインストールし、Digital Labサーバーに接続するように構成できます。分散コネクターマシンに接続されたデバイスは、Digital Labデバイスラボの一部になります。

このトピックの内容:

始める前に

Digital Labのスタンドアロンコネクターは、フルインストールとして、またはDigital Lab (UFT Mobile) 3.0以降のコネクターの既存のインストールへのアップグレードとしてインストールできます。

開始する前に、次の前提条件が満たされていることを確認してください。

コネクターの要件	マシンが推奨システム要件に準拠していること、およびデバイスがサポートされていることを確認してください。詳細については、サポートマトリックスのコネクター要件、Digital Labへのデバイスの接続、およびインストールと構成のベストプラクティスを参照してください。
Windows 11ビルド22572以降のみ	WMIコマンドライン (WMIC) ユーティリティをインストールします。 Windows + Iキーを同時に押して、[設定] を開きます。 [アプリ] をクリックします。 [オプション機能] をクリックします。 [機能を表示] ボタンをクリックします。 Wmicを検索します。横にあるチェックボックスをオンにして、[次へ] を押します。 ［インストール］をクリックします。
新規インストールのみ	サーバーはコネクターからアクセス可能である必要があります。http/s://<Digital Lab server IP address>:<server port>に移動し、Digital Labにアクセスできることを確認します。 Digital Labサーバーが本機にインストールされていないことを確認してください。

トップに戻る

コネクターをインストールする

コネクターをインストールする前に、マシンがコネクターの要件を満たしていることを確認してください。

コネクターをインストールするには:

1. Digital Labサーバーからコネクターのアクセスキーを取得します。

   • 管理者ユーザー: アクセスキータブを選択します。[新規生成] をクリックし、名前、タイプ (コネクター)、有効期限、説明 (オプション) を入力します。次に、[生成] をクリックします。
   • 管理者以外のユーザー: 管理者にリクエストしてください。[ヘルプ] メニュー (右上) から [管理者にお問い合わせください] を選択します。

   アクセスキーの詳細については、アクセスキー管理を参照してください。

2. コネクターをダウンロードします。

   • 管理者の場合は、コネクターページでコネクターのダウンロードを選択します。適切なコネクターをダウンロードします。
   • 管理者以外のユーザーの場合は、Digital Labコンソールの右上隅にある [ヘルプ] メニューから [コネクターのダウンロード] を選択します。適切なコネクターをダウンロードします。

3. コネクターインストールファイルの内容をコンピューター上のフォルダーに抽出します。.exeファイルを見つけます。
   

4. .exeファイルをダブルクリックして、インストールウィザードを開きます。内容をお読みになり、次へをクリックしてください。

5. 次のガイドラインに従って、インストールウィザードの各ページで情報を入力するか、質問に答えてください。

   認証
   資格情報を入力します。Digital Labには、管理者から提供されたアクセスキーを入力してください。 Digital Lab SaaS: SSL有効オプションを選択する必要があります。
   プロキシ経由で接続する場合は、プロキシセクションでサーバーアドレスを選択し、必要に応じてサーバー、ポート、資格情報を指定します。
   コネクター構成
   コネクターに意味のある名前を付けます。これにより、コネクター名に基づいてデバイスを効果的にフィルタリングできます。コネクターのIPアドレス (IPが静的な場合) またはFQDNを入力するか、デフォルトを受け入れます。

インストール後の設定変更方法については、コネクターを変更するを参照してください。

トップに戻る

デバイスを準備する

次の手順を実行して、Digital Labに接続するデバイスを検出するようにWindowsマシンをセットアップします。

iOSデバイス

1. デバイスがWindowsマシンに表示されるように、コンピューターにiTunesがインストールされていることを確認してください。詳細については、Appleのドキュメントを参照してください。

   注: iOS 15以降の場合、iTunes 12.11以降が必要です。

2. まだ行っていない場合は、iOSデバイスの設定手順に従ってください。

Androidデバイス

1. デバイス用のUSBドライバーをダウンロードします。OEM (Original Equipment Manufacturer) USBドライバーへのリンクのリストについては、Android開発者向けドキュメントを参照してください。または、WebでWindows用のUSBドライバーを検索してください。

   Google Nexusデバイスの場合は、Google USBドライバーをダウンロードします。詳しくはAndroid開発者向けドキュメントを参照してください。

2. ダウンロードしたドライバーのアーカイブファイルの内容を抽出します。

3. デバイスをマシンに接続し、Android開発者向けドキュメントの「OEM USBドライバーのインストール」の説明に従って、Windowsバージョンごとにドライバーをインストールします。

   注: USBポートを介してデバイスを接続すると、セキュリティメッセージにより、USBデバッグを許可するか、接続されたコンピューターを信頼するかを尋ねられる場合があります。警告を受け入れます。

4. まだ行っていない場合は、Androidデバイスの初期設定の手順に従ってください。

トップに戻る

デバイスを接続し、接続を確認する

1. USBケーブルを介してデバイスをコンピューターに接続します。デバイスの接続時に表示される可能性のあるすべての通知、信頼、または場所のポップアップを受け入れます。
   
2. コネクターが実行されている場合、次のアイテムがコネクターマシンに接続されているデバイスに自動的にインストールされます。
   
   • リモートビューアーサービス
   • エージェントアプリケーション
     
     エージェントが実行されるまで待ってから、デバイスを操作してください。エージェントがクラッシュした場合は、デバイスのプラグを抜いてから、もう一度差し込んでください。その他のトラブルシューティング情報については、Windowsコネクターのトラブルシューティングを参照してください。

     ヒント: デバイスのプラグを抜いた場合は、5秒間待ってから再接続し、システムが安定するようにします。

3. デバイスを接続した後、エージェントアプリが起動しない場合は、デバイスが認識されているかどうかを確認してください。
   Androidデバイスを確認する

   <Windowsコネクターフォルダー>\android-sdk-windows\platform-toolsフォルダーに移動し、コマンドプロンプトでadbを実行します。

   adb devices

   接続されているすべてのデバイスが一覧表示されます。

   • デバイスがunauthorizedと表示されている場合は、デバイスを確認し、セキュリティポップアップを受け入れます。

   • デバイスがリストされていない場合、またはデバイスがリストされていない場合は、次のことを確認してください。
     

     • ハードウェアの問題。USBポートが機能していない可能性があります。
       

     • Windowsドライバーの不適切なインストール。ファイルエクスプローラーでドライバーinfファイルを選択し、右クリックメニューからインストールを選択します。
     • Androidデバイスのドライバーが正しくありません。Android開発者ドキュメントのOEM USBドライバーリストをチェックして、ドライバーの最新バージョンがあることを確認します。

   iOSデバイスを確認する

   1. コマンドプロンプトウィンドウを開きます。
   2. <Windowsコネクターフォルダー>\libimobiledevice\winフォルダーに移動します。
   3. idevice_idコマンドを実行します。

   idevice_id –l

   このコマンドの結果は、デバイスID (UDID) のリストになります。

   デバイスがUSBポートに接続されているときにデバイスがリストされていない場合は、次のことを確認してください。

   • ハードウェアの問題。USBポートが機能していない可能性があります。
     

   • iTunesのバージョンが正しくありません。最新バージョンのiTunesを使用していることを確認してください。
   • UIオートメーションが有効になっていません。開発者が署名したエージェントアプリを使用するiOS 8.x以降の場合、[設定] > [デベロッパ] > [Enable UI Automation] でUIオートメーションを有効にします。デバイスを切断し、5秒間待ってから、再接続します。

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

トップに戻る

コネクターを開始、停止、および再起動する

インストールが完了すると、セットアッププログラムはコネクターサービスを開始するように要求します。

インストール後にコネクターサービスを開始しないことを選択した場合は、サービスコンソールから、またはマシンのスタートメニューから直接、手動で開始、停止、および再起動を実行できます。

• [スタート] > [Digital Lab Connector] > [Start Digital Lab service]
• [スタート] > [Digital Lab Connector] > [Stop Digital Lab service]
• [スタート] > [Digital Lab Connector] > [Restart Digital Lab service]

トップに戻る

コネクターを変更する

サーバーまたはコネクターポートを変更するなど、コネクターの詳細を変更する必要がある場合は、構成の変更ツールを使用して変更できます。

ツールにアクセスするには、スタート > Digital Lab Connector > Modify configurationを選択します。構成ウィザードが開きます。

実行中、ウィザードはコネクターサービスを停止します。ウィザードの最後のページで、サービスを再開するように求められます。

SSLを使用するサーバーを使用していて、サーバーの詳細を変更する場合は、コネクターを再インストールする必要はありません。構成変更ツールを使用して、コネクターの詳細を更新します。テストツールのユーザーは、Digital LabへのSSLアクセスも再構成する必要があります。詳細については、SSLと証明書を参照してください。

トップに戻る

ローカリゼーションの有効化

システムアプリ (デバイス自体の実行に使用されるアプリ) を英語以外のサポートされている言語で表示するには、コネクターをインストールした後、<Windowsコネクターフォルダーへのパス>\conf\connector.propertiesに移動します。ファイル内の次の行のコメントを解除します。
ENABLE_LOCALIZATION=true

トップに戻る

Windowsコネクターのトラブルシューティング

このセクションでは、コネクターを機能させるためのヒントとガイドラインをいくつか紹介します。

トップに戻る

コネクターのアンインストール

次のいずれかの方法でコネクターをアンインストールできます。

• デスクトップのショートカットをダブルクリックして、[Digital Labサーバーのアンインストール] を選択します。
• または、設定のアプリページから、またはプログラムと機能コントロールパネルからアンインストールします。

アンインストールプロセス中に特定のアプリケーションが開いていた場合、いくつかの古いコネクターファイルが残ります。これは、将来のインストールに影響を与える可能性があります。したがって、すべてのコネクターファイルが削除されたことを確認することをお勧めします。それ以外の場合は、すべてのファイルとフォルダーを手動で削除します。デフォルトでは、C:\Program Files\UFT Digital Lab Connector\connectorにあります。

トップに戻る

パッチのインストール

最新の機能強化と修正を活用するには、現在のバージョンのDigital Labの最新パッチをインストールしてください。サーバーとコネクターのパッチは、ソフトウェアのライセンスとダウンロードからダウンロードできます。最新のパッチには、以前のパッチの内容が含まれています。以前のパッチをインストールする必要はありません。

サーバーを最新のパッチにアップグレードする場合は、以下もアップグレードする必要があります。

• すべてのコネクター

• 手動署名ツール (該当する場合)
  

  • iOSアプリに手動で署名するためのiOS Enabler。サーバーパッチをインストールすると、iOS EnablerがAgentフォルダーで利用できるようになります。パッチは、ADM Marketplaceで入手できます。

  • Androidアプリに手動で署名するためのAndroid Enabler。サーバーパッチをインストールすると、更新されたAndroid Enablerがサーバーフォルダーで利用可能になります。

パッチリリースに含まれているパッチのインストール手順に従ってください。

トップに戻る

その他の参照項目:

• Linuxマシンにコネクターをインストールする
• Macマシンにコネクターをインストールする
• デバイスの管理
• トラブルシューティングとヒント