「モバイルModules」

モバイル用のテクノロジー固有Modulesは、モバイルテクノロジーの特定のタスクを実行します。

「Desired Capabilitiesを追加する」

Desired Capabilitiesを使用することで、Appiumにおけるテストセッションの動作を制御する重要なパラメータを定義することができます。これらの設定は、Appiumサーバーに対してテストを実行する方法を指示します。

「Desired Capabilitiesを追加する」モジュールでは、既に設定したものを上書きすることなく、テスト実行に新しい機能を追加することができます。正しい実行を確保するために、このモジュールをテストケースの最初のテストステップとして配置する必要があります。

「値」

「説明」

能力

適用するDesired Capabilityを指定してください。

  • 「値」列に、対応する値を入力します。

名前と値は大文字と小文字が区別されることに注意してください。

「Androidスナックバー」

Androidアプリケーションのスナックバーを操作します。

「値」

説明

「テキスト」

スナックバーに表示されるテキストです。

「アクション」

スナックバーにボタンが含まれている場合は、そのボタンに対して実行したいアクションを指定してください。

「画面上をクリックする」

モバイルデバイスの画面の特定のポイントでタップジェスチャを実行します。

価値

「説明」

X

水平方向のクリック位置。x 座標をパーセントまたはピクセルで指定します：

  • 画面の割合として、0（左端）から100（右端）までの正の整数を入力してください。例えば、50または50％と入力します。

  • ピクセルの場合は、0（左）から最大画面解像度までの正の整数を入力し、接尾辞をpxとします。例えば、250pxと入力します。

Y

縦のクリック位置。y座標をパーセントまたはピクセルで指定します：

  • 画面のパーセンテージには、0（上）から100（下）までの正の整数を入力してください。例えば、50または50％と入力します。

  • ピクセルの場合は、0（上）から最大画面解像度までの正の整数を入力し、接尾辞をpxとします。例えば、250pxと入力します。

「モバイルデバイスからファイルをダウンロードする」

Androidデバイスからコンピュータにファイルをダウンロードします。コンピュータにファイルが既に存在する場合、システムはそれを上書きします。

「値」

「説明」

「モバイルデバイスのパス」

アップロードしたいファイルへのフルパス（ファイル名と拡張子を含む）です。

パスにはスラッシュ（/）を使用してください。

例：/sdcard/Download/abc.pdf

Samsungデバイスの場合は、ファイルパスの「Internal Storage」を「sdcard」に置き換えてください。For example, replace /Internal storage/Download/abc.txt with /sdcard/Download/abc.txt.

「デスクトップパス」

ファイルを保存したい場所へのフルパス（ファイル名と拡張子を含む）です。

Example: D:\abc.pdf

ファイルに別の名前を指定することもできます。

「スクリーンに描写する」

画面上に直接形を描きます。

「値」

「説明」

ロングタップ

描画をタップで開始するか、ロングタップで開始するかを指定します。

可能な値は以下のとおりです：

  • TRUE：ロングタップで開始します。

  • False：タップで始めます。

「継続時間」

オプションで、動作の継続時間をミリ秒単位で指定します。

値が大きいほど、動きは遅く短くなります。値が小さいほど、動きは速く、長くなります。デフォルト値は、300msです。

「ポイント->X」

開始x座標をパーセントで指定します。左端の値は0で、右端の値は100です。

「ポイント->Y」

開始y座標をパーセントで指定します。上の値は0で、下の値は100です。

「Appiumセッションを終了する」

モバイルデバイスに接続すると、その都度、Appiumは新しいセッションを開始します。セッションを円滑に実行し、残存データや問題が発生しないようにするには、そのセッションで実行したい最後のTestStepの後に「Appiumセッションを終了する」モジュールを追加してください。

「ドライバースクリプトを実行する」

JavaScriptからの複数のコマンドを束ね、Appiumサーバー上でそれらをまとめて一度に実行します。Appiumサーバーは現在のセッションでこのコードを実行し、スクリプトで指定されたすべての値を返します。JavaScriptコードの書き方に関する詳細については、Appiumドキュメントの「execute-driver-plugin」（新しいタブで開きます）および「WebdriverIO」（新しいタブで開きます）を参照してください。

「値」

「説明」

「ファイルからのドライバースクリプト」

Tosca Cloudを実行するデバイスに保存されているJavaScriptファイルの名前です。

「ファイルからのドライバースクリプト」または「インラインドライバースクリプト」の値のいずれかを指定する必要があります。

「インラインドライバースクリプト」

テストステップの値としてドライバースクリプトを入力します。

「ファイルからのドライバースクリプト」または「インラインドライバースクリプト」の値のいずれかを指定する必要があります。

結果

スクリプトによって指定されたすべての値を返します。

「AppiumセッションIDを取得する」

AppiumセッションIDをバッファに保存します。

「値」

「説明」

「バッファ名」

現在のAppiumセッションのIDを保存したいバッファの名前です。

「Perfectoの画像挿入を処理する」

Perfectoでテストを実行する際に、画像挿入処理を開始または停止します。

「値」

「説明」

「オペレーション」

画像挿入を開始または停止するかどうかを指定してください。

「リポジトリファイル」

Name of the Perfecto repository file with specific prefix, foe example PUBLIC:.

「アプリケーションID」

アプリケーションの識別子（iOSの場合はBundleID、Androidの場合はPackageName）です。

「ME3.0ハードウェアボタンを操作する」

以下のプラットフォーム特有のハードウェアボタンを操作します。

  • iOSおよびAndroid用の「ホーム」ボタン

  • Android用の「戻る」ボタン

  • Android用の「アプリ選択」ボタン

「値」

「説明」

「ボタン」

クリックしたいボタンです。可能な値は以下のとおりです。

  • ホーム

  • 戻る

  • アプリケーションセレクタ

「ME3.0デバイスの向きを設定する」

デバイスを縦向きまたは横向きで操縦するかを定義します。

「値」

説明

「オリエンテーション」

デバイスの向きです。「アクションモード」を選択して使用してください。以下が使用可能な値です。

  • ポートレート

  • 横向き

「モバイルアプリを開く」

AndroidまたはiOSデバイス上でネイティブおよびハイブリッドモバイルアプリケーションを開きます。

「値」

「説明」

アプリケーション

Androidデバイスとエミュレータの場合は、操作するアプリケーションのフルパスまたはPackageNameとActivityを指定してください。「PackageName」を「Activity」からフォワードスラッシュ（/）で区切ってください。ですが、「AppPackage」と「AppActivity」を使用することをお勧めいたします。

iOSデバイスおよびシミュレーターの場合は、操縦することを希望のアプリケーションのフルパスまたはBundleIDを指定します。ですが、「BundleID」の使用をお勧めいたします。

「BundleID」

iOS デバイスとシミュレータの場合は、操作するアプリケーションの BundleID を指定してください。

アプリパッケージ

Androidデバイスとエミュレータの場合は、操作するアプリケーションのPackageNameを指定します。

アクティビティ

Androidデバイスとエミュレータの場合は、操作するアプリケーションのActivityを指定してください。

アプリケーションパス

Tricentis Mobile Agentに接続されているデバイスの場合、アプリケーションのフルパスを指定します。操縦する。

「モバイル接続を開く」

「Appium」または「Tricentis Mobile Agent接続」を介して、モバイルデバイスへの接続を開きます。

「値」

「説明」

「接続」

使用したいモバイル接続の名前またはIDです。

「機能セット」

この接続の機能セットの名前またはIDです。

「機能上書き」

機能セットで定義された特定の値を上書きするカスタム値です。

「フォーカス制御にテキスト入力を送信する」

ユーザーのアクションをシミュレートするために、フォーカス制御にテキスト入力を送信します。

「値」

Description

「テキスト」

フォーカス制御に送信したいテキスト入力です。

「キーボードの自動非表示を設定する」

ネイティブアプリケーションにおけるキーボードの自動非表示モードを無効にします。これはテキストボックスの操作パフォーマンスに影響を与えます。

「値」

「説明」

キーボードの自動非表示

iOS のオンスクリーンキーボードの自動非表示モードを有効にするかどうかを指定します。

可能な値は以下のとおりです：

  • TRUE ：自動非表示モードを有効にします。

  • False：自動非表示モードを無効にします。

「Desired Capabilitiesを設定する」

重要なパラメータを示すことができます。これらのパラメータは、Appiumサーバーにテストセッションの動作方法を指示します。これは、お客様のテストケースの最初のテストステップでなければなりません。

「値」

「説明」

能力

適用するDesired Capabilityを指定してください。

  • 値 列に、対応する値を入力します。

名前と値は大文字と小文字を区別します。

「iOSバイオメトリクス登録を設定する」

iOSシミュレーターでFaceIDまたはTouchIDのユーザー認証を有効または無効にすることができます。

「値」

「説明」

状態

iOSシミュレータの生体認証登録を有効または無効にします。

可能な値は以下のとおりです：

  • TRUE：バイオメトリクス登録を有効にします。

  • False：バイオメトリクス登録を無効にします。

「画面上でスワイプする」

画面上で直接スワイプ操作を行います。スワイプ動作の長さは、モバイル画面サイズの3分の1に等しいです。

価値

「説明」

「方向性」

実行したいスワイプの種類です。可能な値は以下のとおりです。

  • 「SWIPELEFT」で、右から左へのスワイプ動作を実行します。

  • 「SWIPERIGHT」で、左から右へのスワイプ動作を実行します。

  • 「SWIPEUP」で、下から上へのスワイプ動作を実行します。

  • 「SWIPEDOWN」で、上から下へのスワイプ動作を実行します。

  • 「スワイプ」で、開始点のみ、終了点のみ、または両方を定義することにより、スワイプを実行します。少なくとも1点は指定しなければならないことに注意してください。

「継続時間」

ミリ秒単位のスワイプ継続時間です。

値が高いほど、スワイプは遅く、短くなります。値が低いほど、スワイプは速く、長くなります。

デフォルト値は300msです。

スタート地点

スワイプの開始座標を定義します。

異なる座標を指定することができます。一方の座標を指定した場合は、もう一方の座標の値も入力する必要があります。

開始点を指定しない場合、スワイプの移動のデフォルトは、スワイプの方向と反対側のスクリーンエッジから10%です。例えば、方向を「SWIPEUP」に設定すると、動作は下端から10%の位置で開始されます。

「スタート地点->X」

x座標をパーセントまたはピクセルで指定します。

画面のパーセンテージには、0（左端）から100（右端）までの正の整数を入力します。例えば、50または50％と入力します。

ピクセルの場合は、0（左）から最大画面解像度までの正の整数を入力し、接尾辞をpxとします。例えば、250pxと入力します。

「スタート地点->Y」

y座標をパーセントまたはピクセルで指定します。

画面のパーセンテージには、0（上）から100（下）までの正の整数を入力します。例えば、50または50％と入力します。

ピクセルの場合は、0（上）から最大画面解像度までの正の整数を入力し、接尾辞をpxとします。例えば、250pxと入力します。

終点

スワイプの終了座標を定義します。

終点座標を入力する場合は、「方向」を「スワイプ」に設定します。

一方の座標を指定した場合は、もう一方の座標の値も入力する必要があります。

終点を指定しない場合、スワイプの動きのデフォルトはスクリーンの中心であることに注意してください。例えば、方向を「スワイプ」に設定し、開始点を座標90%（x）と10%（y）にすると、動作は右上の隅から始まり、画面中央の座標90%（x）と50%（y）で垂直スワイプで終了します。

「終点->X」

x座標をパーセントまたはピクセルで指定します。

画面のパーセンテージには、0（左）から100（右）までの正の整数を入力します。例えば、50または50％と入力します。

ピクセルの場合は、0（左）から最大画面解像度までの正の整数を入力し、接尾辞をpxとします。例えば、250pxと入力します。

「終点->Y」

y座標をパーセントまたはピクセルで指定します。

画面のパーセンテージには、0（上）から100（下）までの正の整数を入力します。例えば、50または50％と入力します。

ピクセルの場合は、0（上）から最大画面解像度までの正の整数を入力し、接尾辞をpxとします。例えば、250pxと入力します。

「モバイルアプリを切り替える」

単一のテストケース中に異なるモバイルアプリケーションに切り替えます。

「値」

「説明」

「アプリケーション」

切り替えたいアプリケーションです。

  • iOSアプリケーションの場合は、「BundleID」を使用します。

  • Androidアプリケーションの場合は、そのPackageNameを使用します。Activityを指定しないでください。

「モバイルデバイスにファイルをアップロードする」

コンピュータからAndroidデバイスにファイルをアップロードします。ファイルがすでにAndroidデバイスに存在する場合、システムはそれを上書きします。

「値」

「説明」

「デスクトップパス」

アップロードしたいファイルへのフルパス（ファイル名と拡張子を含む）です。

For example: D:\abc.pdf

「モバイルデバイスパス」

ファイルを保存したい場所へのフルパス（ファイル名と拡張子を含む）です。

パスにはスラッシュ（/）を使用してください。

For example: /sdcard/Download/abc.pdf

ファイルに別の名前を指定できます。

Samsungデバイスの場合は、ファイルパスで「Internal Storage」を「sdcard」に置き換えてください。例えば、/Internal storage/Download/abc.txtを/sdcard/Download/abc.txtに置き換えます。

「Perfectoにファイルをアップロードする」

Perfectoリポジトリにファイルをアップロードします。

「値」

「説明」

「Perfectoトークン」

「Perfectoセキュリティトークン」

「ファイルパス」

Full path to the file in the format .File=<path_to_file>.

「エンドポイント」

PerfectoリポジトリのREST APIエンドポイントです。

For example: https://<your_host>.perfectomobile.com/services/repositories/media/

「宛先パス」

Name of the Perfecto destination repository file with specific prefix, for example PUBLIC:.

「ファイルを上書きする」

既存のファイルを上書きします。「True」と入力します。

「Androidの指紋認証を使用する」

Androidエミュレータで指紋認証を使用します。テストケースでこのモジュールを使用するには、まずAndroidエミュレータで指紋IDを設定する必要があります。

「値」

「説明」

指紋ID

エミュレータで設定し、ユーザー認証に使用する指紋 ID を入力します。

「iOSバイオメトリクス認証を使用する」

iOSシミュレータでFaceIDまたはTouchIDのユーザー認証を使用します。

「値」

「説明」

バイオメトリクス認証の種類

使用する生体認証の種類を指定します。

可能な値は以下のとおりです：

  • FaceID：顔認証を使用します。

  • TouchID：指紋認証を使用します。

ポジティブ認証

認証が肯定的か否定的かを指定します。

可能な値は以下のとおりです：

  • TRUE ：正の認証を使用します。

  • False：負の認証を使用します。

「Perfectoバイオメトリクス認証を使用する」

Perfectoクラウドデバイスでバイオメトリクスユーザー認証を実行します。

「値」

「説明」

「アプリケーションID」

アプリケーションの識別子（iOSの場合はBundleID、Androidの場合はPackageName）です。この値は必須です。

「認証成功」

認証が肯定的か否定的かを指定します。この値は必須です。

「エラーの種類」

オプションで、失敗した認証に関連するエラーの種類を選択してください。