Dev Access CLIツール

Dev Accessコマンドラインインターフェイスツールを使用すると、デバイスをOpenText Functional Testing Labデバイスラボから、Android用のADBまたはiOS用のiDevice上に構築されたIDEおよびその他の開発およびデバッグツールにルーティングできます。

デバイスにDev Accessを使用する場合、デバイスにはOpenText Functional Testing Labのリモートビューからのみアクセスでき、OpenText統合テストツールからはアクセスできません。

注: Dev Accessを使用する前に、マシンのコネクターを停止してください。詳細については、コネクターを開始、停止、および再起動するを参照してください。

サポートされているデバイス

Dev Accessは、iOS 17デバイス、OpenTextがホストするパブリックデバイス、ADFデバイス、WeTestデバイス、仮想デバイス、エミュレーター、シミュレーターではサポートされていません。

トップに戻る

Dev Access CLIツールのAndroidの前提条件

Dev Access CLIツールのAndroidの前提条件に従います。

Android ADBコンポーネントがマシン上に存在している必要があります。マシンにOpenText Functional Testing Labコネクターがインストールされている場合、デフォルトのADBの場所はC:\Program Files\Functional Testing Lab for Mobile and Web Server Connector\connector\android-sdk-windows\platform-toolsです。
ADBの基礎知識が必要です。詳しくはAndroid開発者向けドキュメントのAndroid Debug Bridgeを参照してください。
ポート5037が使用可能である必要があります。このポートは、OpenText Functional Testing Labサーバーまたはコネクターによって使用される可能性があるため、Dev Accessを実行する予定のマシンでこれらのサービスを必ず停止してください。

トップに戻る

Dev Access CLIツールのセットアップ

IDEにルーティングするデバイスごとに、次の手順を実行する必要があります。

IDEで動作するようにデバイスを設定するには:

[デバイスラボ] > [デバイス] ページに移動します。
- カードモードで、デバイスのカードにカーソルを合わせ、[Dev Access] ボタンをクリックします。
- リストモードで、デバイスを選択し、Dev Accessをクリックします。
[Dev Accessのダウンロード] ダイアログボックスでは、デバイスにアクセスするマシンのオペレーティングシステムを選択するように求められます。オペレーティングシステムを選択し、ダウンロードをクリックしてデバイストンネルファイルを取得します。
アーカイブファイルの内容を、書き込み権限のあるマシン上の場所に抽出します。
バッチファイルを実行します。
- Windowsの場合は、dev-access.batファイルをダブルクリックします。
- LinuxおよびMacでは、sudoコマンドを使用して、ターミナルウィンドウからdev-access.shスクリプトを実行します。このスクリプトを実行するには、アクセス許可が必要です。
コンソールが開き、OpenText Functional Testing Labへの開発者アクセスの資格情報の入力を求められます。実行キーをまだ持っていない場合は、生成します。詳細については、アクセスキーの生成と管理を参照してください。
実行キーを貼り付けてEnterキーを押すか、login -c "your execution key"と入力して、再度ログインします。
コンソールがあなたを歓迎します。

デバイスとの対話

コンソールが開いてOpenText Functional Testing Labサーバーに接続した後、Dev Access CLIコマンドを使用してデバイスおよびサーバーと対話できます。コマンドのリストを表示するには、--helpまたは-hと入力します。

Androidデバイスの場合、接続すると、仮想ADBを介して作業し、マシンに直接接続されているデバイスの場合と同じように、コマンドを送信してデバイスをデバッグします。

デバイスを操作するには:

トンネリングファイルを生成したデバイスを見つけます。コンソールにlist devicesと入力し、トンネルファイルを作成したデバイスのIDをコピーします。
コンソールで、start <id>と入力します。警告が表示された場合は、configコマンドを使用して正しい値を設定してください。詳細については、Dev Access CLIコマンドを参照してください。ラボコンソールのデバイスのカード (またはリストビューの行エントリ) は、デバイスがロックされており、Dev Accessを使用してIDEにルーティングされていることを示します。
デバイスの操作:
- ADBツールを使用するAndroidデバイスの場合: (Dev Accessコンソール以外の) 追加のコマンドラインウィンドウを開き、標準のADBコマンドを発行します。サポートされているADBコマンドの部分的なリストについては、AndroidのDev Access CLIツールの既知の問題を参照してください。
  
  注: ADB実行可能ファイルへのパスにスペースが含まれている場合は、抽出されたフォルダーにあるdev-access.propertiesファイルでパスを定義します。バックスラッシュのエスケープ文字としてバックスラッシュを使用します。たとえば、android.adb.exec=C\:\\adb 3\\adb.exe。
- Android Studioを使用するAndroidデバイスの場合:
  1. 単一のAndroidデバイスでDev Accessを起動した場合は、コマンドプロンプトを開き、adb logcatを実行します。
  2. 複数のAndroidデバイスでDev Accessを開始した場合は、adb devicesを実行します。使用するデバイスのシリアル番号をコピーします。adb -s <serial number> logcatを実行します。
  3. Android Studioからアプリをビルド、実行、デバッグします。
- iOSデバイスの場合、デバイスを見つけて、通常の方法で操作します。

ローカルデバイスに戻すには、CLIツールを閉じます。

トップに戻る

Dev Access CLIコマンド

次の表に、Dev Accessコンソールから使用できる最も一般的なコマンドを示します。-helpまたは-hと入力して、使用可能なコマンドを一覧表示します。

パラメーターが必要なコマンドの詳細については、パラメーターなしでコマンドを入力してください。

コマンド	詳細
login	OpenText Functional Testing Labサーバーにログインします。これを行うには、実行キーが必要です。例: `login -c "myexecutionkey"`
logout	OpenText Functional Testing Labサーバーからログアウトします。このコマンドにはパラメーターがありません。
list	指定されたパラメーターに基づいて情報をリストします。 devices: プラットフォーム、名前、OSバージョン、デバイスID、およびステータスとともにすべてのデバイスを一覧表示します。このコマンドを使用して、startまたはstopコマンドで使用するデバイスIDを取得します。 platforms: 利用可能なデバイスプラットフォームを一覧表示します。たとえば、android、iOSなどです。 configs: URLホストやポートなど、サーバーとデバイスの構成情報を一覧表示します。
start	指定されたデバイスを起動します。list devicesまたはlist configsコマンドから取得したデバイスIDを使用します。例: `start 56980739ab78`
stop	指定されたデバイスを停止し、他のユーザーのために解放します。例: `stop 56980739ab78`
clear	Dev Accessコンソールをクリアします。このコマンドにはパラメーターがありません。
config	次の構文を使用して、情報を構成できます。 `config [-s] -n =<name> [-p =<platform>] -v =<value>` -s: 今後の使用に備えて、指定した名前(-n)で設定を保存します。 -p: 設定を行うプラットフォーム: androidまたはios。 -n: 適用する構成名、または「-s」オプションの場合は適用する構成名。可能な構成は次のとおりです。 adb.version - ADBクライアントバージョン adb.port - リッスンするモックADPポート adb.autokill - 実行中の既存のADBスレッドを強制終了します (true/false) adb.exec - ADBインストールパス -v: -nパラメーターの設定値。例: `–n adb.autokill –v true` `–n adb.version –v 38` `–n adb.port –v 5038` `–n adb.exec –v c:/folder/adb.exe` たとえば、コンソールがADBのバージョンがサーバーのバージョンと一致しないことを警告する場合は、configコマンド: `config -n adb -v 39`を使用して変更します。
exit	Dev Accessセッションを終了します。このコマンドにはパラメーターがありません。

androidのconfigコマンドとデフォルト値の詳細については、config -p android -nと入力してください。

トップに戻る

AndroidのDev Access CLIツールの既知の問題

特定のadbコマンドは、Dev Access CLIツールではサポートされていません。サポートされていないadbサーバーコマンドの部分的なリストは、ppp、reverse port forwarding、disable/enable - verity、remount、reboot、sideload、root、unroot、usb、およびtcpipです。詳しくはAndroid開発者のウェブサイトを参照してください。
デバイスにDev Access CLIを使用する場合、OpenText Functional Testing Labのリモートビューからのみアクセスでき、UFT、OpenText Functional Testing for Developersなどのテストツールからはアクセスできません。
デバイスにDev Access CLIを使用する場合、サーバーの組み込みAppiumを介してデバイスにアクセスすることはできませんが、Dev Access CLIサービスに基づいて外部Appiumサーバーからアクセスできます。

トップに戻る

iOSでのDev Access CLIツールの既知の問題

現在、Dev Access機能は、ローカルMacマシン上のXcode IDEに対してのみ認定されています。他のサードパーティIDEは機能する可能性がありますが、動作は多くの場合最適ではありません。
リモートアクセスが弱い接続または遅い接続を介している場合、Xcodeで必要なシンボルとデバイスサポートファイルを取得するのが難しい場合があります。デバイスをDev Accessモードで使用する前に、必要なデバイスサポートフォルダーを手動で取得することをお勧めします。
Dev Access CLIを使用すると、コンピューターに接続されているローカルiOSデバイスにアクセスできなくなります。これは、それらがOpenText Functional Testing Labリモートデバイスに置き換えられるためです。
Dev Access CLIセッションの停止に失敗した場合は、デバイスラボタブのデバイスページからデバイスのロックを手動で解除してください。

トップに戻る

その他の参照項目: