Appium機能

OpenText Functional Testing Lab機能は、標準のAppium機能を拡張します。このトピックでは、いくつかの一般的な機能に関する情報を提供します。

: **OpenText Functional Testing Lab固有のAppium機能には、接頭辞「FTLab」を使用してください。下位互換性のために、接頭辞「dl」または「uftm」は引き続きサポートされます。

例: userNameには、FTLab:userNameを使用します。

機能必須FTLabプレフィックスが必要**説明
oauthClientId/
userName
Check mark * Check mark

OpenText Functional Testing Labでテストを実行するために必要な実行タイプのアクセスキー/ユーザー名。

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

oauthClientSecret/ passwordCheck mark *Check mark* oauthClientId/ userNameのコメントをご覧ください。
tenantIdCheck markCheck mark

共有スペースを有効にして作業する場合は、9桁の共有スペースIDを含めてください。これは、ラボコンソールのツールバーにあります。詳細については、共有スペースへの接続を参照してください。デフォルトの共有スペースIDは999999999です。

tenantIdは数値または文字列として送信できます。

app-- 

サポートされません。デバイスにアプリをインストールするには、Androidの場合はappPackageappActivityを使用し、iOSの場合はbundleIdを使用します。

appiumVersionX markCheck mark

テストに使用するAppiumメジャーバージョンを定義します。デフォルトはAppiumバージョン2です。Appiumバージョン1を使用するには、この機能をv1.xに設定します。

appPackage (Android)Check mark 

アプリの詳細カードにパッケージIDと表示されているアプリを識別するパッケージ名。たとえば、「com.Advantage.aShopping」です。

アプリがデバイスにまだインストールされておらず、データベースにアプリが存在する場合は、テスト手順を実行する前に自動的にインストールされます。

appActivity (Android)Check mark 

起動するAndroidアクティビティの名前。アプリの詳細カードに起動アクティビティとして表示されます。
アプリがデバイスにまだインストールされておらず、データベースに存在する場合は、テスト手順を実行する前に自動的にインストールされます。

appCounterX markCheck markアプリの特定のアップロードをデバイスにインストールします。値には、数値、数値文字列、またはlatestを指定できます。

指定したアップロードがラボに存在せず、すでにデバイスにインストールされている場合は、インストールされているアプリが起動します。

アプリのアップロードの詳細については、アプリの管理の「アプリオプション」 - 「詳細ウィンドウ」を参照してください。

bundleId (iOS)Check mark 

アプリの詳細カードにパッケージIDとして表示される一意の識別子であるアプリのバンドルID。例: 「com.mf.iShopping」

アプリがデバイスにまだインストールされておらず、データベースにアプリが存在する場合は、テスト手順を実行する前にアプリがデバイスに自動的にインストールされます。

installPackagedAppX markCheck markテスト用にパッケージバージョンのアプリをインストールします。認証、写真、バーコード、QRコードシミュレーションなどのシミュレーションを使用する場合は、この機能を含めてください。シミュレーションの詳細については、Appiumシミュレーションを参照してください。

deviceHostingType

X markCheck mark"PrivateOnPremise"、"Public"、"PrivateHosting"

deviceType

X mark "real" または "emulator"
platformNameX mark "Android" または "iOS"
platformVersionX mark 

OSのバージョン。列挙記号を指定します。例: <、>、<=、>=、=

例: "platformVersion", ">5.0.1"

deviceNameX mark 

物理またはエミュレートされたデバイス名。OpenText Functional Testing Labコンソールに表示されるメーカー、モデル、論理名を指定できます。

デバイス名が指定されていない場合、スクリプトは指定された機能にデフォルトのデバイスを使用します。この機能は、udidと組み合わせて、またはその代わりに使用してください。

製造者、モデル名、または論理名でデバイスを指定する場合は、これらのガイドラインを使用してください。

  • デフォルトでは、検索エンジンはあいまい検索を実行し、文字列の一部に一致する最初のデバイスを返します。これは、最適な一致ではない場合でも同様です。
  • デバイス名が別のデバイス名のサブストリングである場合は、あいまいさを避けるために、udidなどの他の機能を使用してください。
  • 正確な文字列に一致させるには、二重引用符を使用した絞り込み検索を使用します。たとえば、"\"Apple iPhone 5c (GSM+CDMA)\""は、その正確なメーカーとモデル名のデバイスを探します。(エスケープ文字として円記号を使用していることに注意してください。)
udidX mark 

OpenText Functional Testing Labによって割り当てられたデバイスのUDID識別子。

UDIDが指定されていない場合、スクリプトは指定された機能にデフォルトのデバイスを使用します。この機能は、deviceNameと組み合わせて、またはその代わりに使用してください。

browserNameCheck mark * 

Webアプリケーションをテストする場合、iOSの場合は「Safari」、Androidの場合は「Chrome」、「Chromium」、「Browser」など、テスト対象のブラウザー。

アプリをテストするときは、この機能を省略するか、空の文字列に設定してください。ただし、Node.JS wdでアプリをテストする場合は、この機能を追加して空の文字列に設定する必要があります。

sourceX markCheck mark

デバイスのソースラボ。

  • OpenTextがホストするデバイスを使用する場合は、値HOSTEDを使用するか、FTLab|HOSTEDを使用します (オンプレミスデバイスとOpenTextでホストされたデバイスの両方の場合)。

  • ADFデバイスの場合は、AWSを使用します。

ソースが指定されていない場合は、デフォルト値FTLabが使用されます。

AutomationNameX mark 

iOS

Macマシンを必要とせずにiOSデバイスでテストを実行できます。iOSで使用される自動化方法はXCUITestです。

Android OS 8.0以降

UiAutomator2はデフォルトの自動化エンジンです。uiautomator2ドライバーは、GoogleのUiAutomator2テクノロジーを使用して、デバイスまたはエミュレーターでの自動化を可能にします。デフォルトを上書きしてUiAutomator1を使用するには、値を「android」に設定します。

 

mcWorkspaceNameX markCheck mark

特定のワークスペースにアップロードされたアプリケーションを指定できます。

fullResetX mark 

テストの前後にアプリをアンインストールします。この機能を使用すると、アプリはテスト前にアンインストールされ、テスト用にインストールされ、テストが終了すると再度アンインストールされます。iOSデバイスの場合、fullResetがtrueに設定されている場合は、resetOnSessionStartOnlyをfalseに設定する必要があります。

bundleID (iOS) またはappPackageとappActivity (Android) 機能を使用する場合にのみサポートされます。

noResetX mark この機能を使用する場合、まだインストールされていない場合にのみ、デバイスにテスト用にアプリがインストールされます。
bundleID (iOS) またはappPackageとappActivity (Android) 機能を使用する場合にのみサポートされます。
ビデオX markCheck mark

テストのビデオを記録するにはtrueに設定します。

テストセッションの記録を生成するには、管理設定でビデオ記録も有効にする必要があります。詳細については、管理設定のファイルストレージ設定を参照してください。
OpenText Core SDP: ビデオ記録設定は常に有効になっています。

ビデオのダウンロード方法の詳細については、テスト結果を参照してください。

collectMetricsX markCheck mark

デフォルトでは、デフォルト値はtrueに設定されています。メトリクスの収集を無効にするには、機能をfalseに設定します。 capabilities.setCapability ("FTLab:collectMetrics", false)

メトリクスはダウンロード用のcsvファイルで提供されます。メトリクスには次のものが含まれます。

  • エポックタイム: エポック (Unix) 時間として表されるサーバー上の時刻

  • 現地時間

  • テスト時間: メトリクス収集の開始からの経過時間 (HH: mm: ss.SSS)。

  • CPU (%): テスト実行中にアプリによって消費されたCPU。

  • メモリ (KB): テスト実行中にアプリによって消費されたメモリ。

  • 空きメモリ (KB): テスト実行中のデバイスの空きメモリの量。

  • 熱状態 (iOS 1~4、Android 0~6): iOSおよびAndroid 10以降でサポートされています。iOSデバイスの4つの熱状態の詳細については、Apple Developerのドキュメントを参照してください。Androidデバイスの6つの熱状態の詳細については、Androidのドキュメントを参照してください。

  • 空きディスク領域 (KB)

    • WiFi

      • 状態 (0/1): 切断済みまたは接続済み。

      • 信号強度: 1~5のスケール。

        AndroidのWiFiメトリクスを収集するために有効にする設定の詳細については、Androidモバイルデバイスの接続を参照してください。

        iOS: SSIDはサポートされていません。

トップに戻る

その他の参照項目: