Eggplant コマンドラインオプション
このページでは、Eggplantコマンドを使用してコマンドラインからEggplant Functionalスクリプトを実行するときに使用できるさまざまなオプションについて説明します。このコマンドはEggplant Functional GUIを起動します。runscriptコマンドを使用してこれらのオプションのいずれかを実行すると、Eggplant Functional GUIが起動することに注意してください。runscriptコマンドについて詳しくは、Runscript コマンドオプションを参照してください。
これらのコマンドに関する詳細情報は、コマンドラインからの実行を参照してください。
コマンドラインからこれらのコマンドを実行するときにrunscriptまたはEggplantコマンドで渡すオプションを説明するために、引数という用語を使用しています。他にもオプションやフラグという用語があります。
スクリプトへの入力として渡す値を指すために、パラメータという用語を使用しています。コマンドラインから実行するときにスクリプトにパラメータを渡す方法についての詳細は、パラメータの渡し方を参照してください。
-アラートオンエラー
使用
ブール値。 (はい/いいえ) スクリプトの実行が失敗した場合にアラートを表示するかどうかを指定します。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/appTests.suite/Scripts/test3.script -AlertOnError yes
Windows
"C:\Program Files\eggPlant\eggPlant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MyTests.suite\scripts\test3.script" -AlertOnError yes
Linux
Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -AlertOnError yes
このパラメータは、Eggplant Functional一般設定の接続が失敗したときにアラートを表示するを上書きします。
-AlertOnFailedConnections
使用
Boolean. (Yes/No) Specifies whether to show an alert when a connection fails.
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/appTests.suite/Scripts/test3.script -AlertOnFailedConnections yes
Windows
"C:\Program Files)\eggPlant\eggPlant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MyTests.suite\scripts\test3.script" -AlertOnFailedConnections yes
Linux
Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -AlertOnFailedConnections yes
このパラメータは、Eggplant Functional一般設定のスクリプト実行が失敗したときにユーザーに警告するを上書きします。
-AutoShowRunWindow
使用
ブール値。 (はい/いいえ) スクリプトの実行時に実行ウィンドウを前方に移動するように指定します。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -AutoShowRunWindow yes
Windows
"C:\Program Files\Eggplant\Eggplant.bat" -AutoShowRunWindow yes
Linux (bash shell)
Eggplant -AutoShowRunWindow yes
-AutoShowRunWindowフラグは、Eggplant Functional一般設定のスクリプトが実行されたときに実行ウィンドウを前面に表示するを上書きします。
-デフォルトドキュメントディレクトリ
使用
ディレクトリへのパス。 ヘルパー スイートのパスなど、スイートへの相対ファイル パスの開始ディレクトリを指定します。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -DefaultDocumentDirectory ~/Documents/EggplantDocs
Windows
"C:\Program Files\Eggplant\eggPlant.bat" -DefaultDocumentDirectory "C:\Users\Elizabeth\Documents\eggPlantTests"
Linux
Eggplant ~/Documents/appTests.suite/Scripts/test1.script -DefaultDocumentDirectory ~/Documents
これは、Eggplant Functional一般設定のデフォルトスイートディレクトリと同じです。
-open
使用
スイートまたはスクリプトへのパス。 -open 引数は、スイートを開いた状態でコマンドラインから Eggplant Functional を起動します。 -open 引数を使用して、特定のスイートへのパスを含めます。 -open 引数を使用して特定のスクリプトを開くこともできます。これを行うには、特定のスクリプトへのパスを含めます。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -open ~/Documents/appTests.suite
/Applications/eggPlant.app/Contents/MacOS/Eggplant -open ~/Documents/appTests.suite/scripts/testscript.script
Windows
"C:\Program Files\eggPlant\Eggplant.bat" -open "C:\Users\Alex\Documents\appTests.suite"
"C:\Program Files\eggPlant\Eggplant.bat" -open "C:\Users\Alex\Documents\appTests.suite\scripts\testscript.script"
Linux
Eggplant -open ~/Documents/appTests.suite
Eggplant -open ~/Documents/appTests.suite/scripts/testscript.script
-param (-p)
使用
単一のパラメータ。 -param 引数はパラメータをスクリプトに渡します。 -param はスクリプト名の前後に使用できます。 -param 文字列はスクリプト内の各パラメータの前に置く必要があることに注意してください。 -p 形式は、同じパラメータの省略形です。相互に交換して使用できます。
-param引数（最後に「s」が付かないもの）は、古い-paramsパラメータと同じではありません。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -param "SUT1" -param "phonebook.txt"
Windows
"C:\Program Files\eggPlant\Eggplant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MyTests.suite\scripts\test1.script" -param "SUT1" -p "phonebook.txt"
Linux
Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -p "SUT1" -p "phonebook.txt"
-paramValue (-pv)
使用
単一のパラメータ式。 -paramValue 引数 (またはその省略形 -pv) は、リスト、プロパティ リスト、または他の複雑なパラメータ値をスクリプトに追加します。 SenseTalk 値関数は、指定された値をスクリプトに渡す前に適用されます。
-paramValueと-paramを自由に混在させて呼び出すことができます。-paramまたは-pの後に続く値は、スクリプトにリテラル文字列として渡されます。paramValueまたは-pvの後に続く値は、SenseTalk式として評価され、評価された値がスクリプトに渡されます。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant ~/Documents/appTests.suite/Scripts/test1.script -paramValue "[SUT1,SUT2]" -paramValue "{x:34, y:125}"
Windows
"C:\Program Files\eggPlant\Eggplant.bat" "C:\Users\Alex\Documents\MyTests.suite\scripts\test1.script" -p "SUT1" -pv "[1,2,3,5,9]"
Linux
Eggplant ~/MyTests.suite/Scripts/test1.script -paramValue "the international time" -pv '{name:"Joe User", id:"143G-2", password:"top secret"}'
-QuitAfterRun
使用
ブール値。 (はい/いいえ) 指定されたスクリプトまたはスイートのスケジュールを呼び出し、Eggplant Functional を終了します。終了をキャンセルするには、Eggplant Functional を開き、メイン メニューから Eggplant を選択し、次に Quit を選択します。次に、Cancel Quit ボタンをクリックします。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/Docs.suite/Scripts/myTests/test2.script -QuitAfterRun yes
Windows
"C:\Program Files\Eggplant\Eggplant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MySuite.suite\Scripts\test2.script" -QuitAfterRun yes
Linux
Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script ~/Documents/appTests.suite/Scripts/test2.script -QuitAfterRun yes
-ドキュメントを再度開く
使用
ブール値。 (はい/いいえ) Eggplant Functional を起動するときに、最後に開いていたスイートとスクリプトを再度開くかどうかを指定します。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -ReopenDocuments No
Windows
"C:\Program Files\Eggplant\Eggplant.bat" -ReopenDocuments no
Linux
Eggplant -ReopenDocuments no
このパラメータは、Eggplant Functionalの一般設定前回のセッションからスイートを再開するを上書きします。
-接続の復元
使用
ブール値。 (はい/いいえ) Eggplant Functional の起動時に最後のセッションからの接続を復元するかどうかを指定します。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -RestoreConnection yes
Windows
"C:\Program Files\Eggplant\Eggplant.bat" -RestoreConnection yes
Linux
Eggplant -RestoreConnection yes
このパラメータは、Eggplant Functionalの一般設定前回のセッションからの接続を再開するを上書きします。
-RunOnLaunch
使用
スクリプトまたはスイート スケジュールへのパス。 Eggplant Functional の起動時に、指定されたスクリプトまたはスイート スケジュールを呼び出します。
例
Mac
/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/Alex_Tests.suite/Schedule1
Windows
"C:\Program Files\Eggplant\Eggplant.bat" -RunOnLaunch "C:\Users\Alex\Documents\Eggplant\MySuite.suite\Schedule1"
Linux
Eggplant -RunOnLaunch ~/Documents/appTests.suite/scripts/test1.script
-スケールリモートスクリーン
使用
ブール値。デフォルト: オフ。 ScreenScaleRatio 設定で別途指定されていない限り、モバイル (iOS または Android) デバイスのリモート画面を元のサイズの 50% に拡大縮小します。コマンドラインフラグとしても渡されます。 VNC 接続で のみ使用できます。
コマンドラインで一度設定すると、この設定は、その接続のEggplant Functional接続リスト項目に永続化されます。これは、scaleRemoteScreenをオフに設定する別のコマンドライン呼び出しを実行するか、Eggplant Functional接続インターフェイスのScreen Scale Ratioチェックボックスの選択を解除することで、再設定することができます。
例
Mac
/Applications/Eggplant.app/Contents/MacOS/Eggplant -RunOnLaunch ~/Desktop/MySuite.suite/Scripts/ToRunFromCLI.script -scaleRemoteScreen yes -host 10.1.11.111 -port 5902 -password securePassword
Windows
“C:\Program Files\Eggplant\Eggplant.bat” -RunOnLaunch “C:\Users\Dave\My Documents\MySuite.suite\Scripts\ToRunFromCLI.script” -scaleRemoteScreen yes -screenScaleRatio 3 -host 10.1.11.150 -port 5901 -password securePassword
Linux
eggplant -RunOnLaunch ~/Documents/TestSuite.sute/Scripts/ToRunfromCLI.script -scaleRemoteScreen yes -screenScaleRatio 2 -host 10.1.11.182 -port 5902 -password securePassword
-画面スケール比
使用
整数値 N。 画面のスケール比 1:N を決定します。N はユーザーが指定した整数値です。この設定は、ScaleRemoteScreen 設定で使用されるスケールを変更します。デフォルトの N 値は 2 (リモート画面を 50% に拡大縮小します) です。
例
Mac
/Applications/Eggplant20.app/Contents/MacOS/Eggplant -RunOnLaunch ~/Desktop/Elizabeth.suite/Scripts/ToRunFromCLI.script -scaleRemoteScreen yes -scaleScreenRatio 3 -host 10.1.11.120 -port 5901 -password securePassword
Windows
“C:\Program Files\Eggplant\Eggplant.bat” -RunOnLaunch “C:\Users\Dave\My Documents\MySuite.suite\Scripts\ToRunFromCLI.script” -scaleRemoteScreen yes -screenScaleRatio 4 -host 10.1.11.111 -port 5902 -password securePassword
Linux
eggplant -RunOnLaunch ~/Documents/TestSuite.sute/Scripts/ToRunfromCLI.script -scaleRemoteScreen yes -screenScaleRatio 3 -host 10.1.11.210 -port 5901 -password securePassword