このタスクを使用して、Visual Studio Mobile Center でモバイル アプリ パッケージをテストします。
構文
# Mobile Center Test v0
# Test mobile app packages with Visual Studio Mobile Center.
- task: VSMobileCenterTest@0
inputs:
app: # string. Required. Binary Application File Path.
artifactsDir: '$(Build.ArtifactStagingDirectory)/MobileCenterTest' # string. Required. Artifacts Directory. Default: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
# Prepare Tests
#enablePrepare: true # boolean. Prepare Tests. Default: true.
framework: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Required when enablePrepare = true. Test Framework. Default: appium.
#appiumBuildDir: # string. Required when enablePrepare = true && framework = appium. Build Directory.
#espressoBuildDir: # string. Optional. Use when enablePrepare = true && framework = espresso. Build Directory.
#espressoTestApkPath: # string. Optional. Use when enablePrepare = true && framework = espresso. Test APK Path.
#calabashProjectDir: # string. Required when enablePrepare = true && framework = calabash. Project Directory.
#calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber Config File.
#calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run.
#calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
#uitestBuildDir: # string. Required when enablePrepare = true && framework = uitest. Build Directory.
#uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store File.
#uitestStorePass: # string. Optional. Use when enablePrepare = true && framework = uitest. Store Password.
#uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Alias.
#uitestKeyPass: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Password.
#uitestToolsDir: # string. Optional. Use when enablePrepare = true && framework = uitest. Test Tools Directory.
#signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing Information.
#xcuitestBuildDir: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Build Directory.
#xcuitestTestIpaPath: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA Path.
#prepareOpts: # string. Optional. Use when enablePrepare = true. Additional Options.
# Run Tests
#enableRun: true # boolean. Run Tests. Default: true.
credsType: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Required when enableRun = true. Authentication Method. Default: serviceEndpoint.
#serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. Mobile Center Connection.
#username: # string. Required when enableRun = true && credsType = inputs. Mobile Center Username.
#password: # string. Required when enableRun = true && credsType = inputs. Mobile Center Password.
appSlug: # string. Required when enableRun = true. App Slug.
devices: # string. Required when enableRun = true. Devices.
#series: 'master' # string. Optional. Use when enableRun = true. Test Series. Default: master.
#dsymDir: # string. Optional. Use when enableRun = true. dSYM Directory.
locale: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Required when enableRun = true. System Language. Default: en_US.
#userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other Locale.
#loginOpts: # string. Optional. Use when enableRun = true && credsType = inputs. Addtional Options for Login.
#runOpts: # string. Optional. Use when enableRun = true. Additional Options for Run.
#async: false # boolean. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
# Advanced
#cliLocationOverride: # string. mobile-center CLI Location.
#debug: false # boolean. Enable Debug Output. Default: false.
入力
バイナリ アプリケーション ファイルパスの app -
string。 必須。
リポジトリ ルートから .APK または .テストする IPA ファイル。
artifactsDir
-
アーティファクトディレクトリ
string。 必須。 既定値: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
準備ステップによって生成され、実行ステップによって使用される成果物を配置するディレクトリを指定します。 ディレクトリが存在しない場合は作成されます。
enablePrepare
-
テストの準備
boolean。 既定値: true.
trueに設定すると、テストが準備されます。
framework
-
テストフレームワーク
string。
enablePrepare = trueする場合に必要です。 使用できる値: appium、espresso、calabash、uitest (Xamarin UI テスト)、xcuitest。 既定値: appium.
タスクが使用するテスト フレームワークを指定します。
ビルド ディレクトリの appiumBuildDir -
string。
enablePrepare = true && framework = appiumする場合に必要です。
Appium テストを含むディレクトリへのパスを指定します。
ビルド ディレクトリの espressoBuildDir -
string。 任意
enablePrepare = true && framework = espressoするときに使用します。
Espresso 出力ディレクトリのパスを指定します。
espressoTestApkPath
-
テスト APK パス
string。 任意
enablePrepare = true && framework = espressoするときに使用します。
エスプレッソ テストを使用して APK ファイルへのパスを指定します。 値が設定されていない場合は、build-dir を使用して APK ファイルが検索されます。 ワイルドカードを使用できます。
calabashProjectDir
-
プロジェクトディレクトリ
string。
enablePrepare = true && framework = calabashする場合に必要です。
Calabash ワークスペース ディレクトリのパスを指定します。
calabashConfigFile
-
きゅうりコンフィグファイル
string。 任意
enablePrepare = true && framework = calabashするときに使用します。
一般的に cucumber.ymlされている、リコ構成ファイルへのファイル パスを指定します。
を実行するプロファイルを calabashProfile - する
string。 任意
enablePrepare = true && framework = calabashするときに使用します。
実行するプロファイルを指定します。 この値は、1 つの構成ファイルに存在する必要があります。
calabashSkipConfigCheck
-
構成チェック をスキップする
boolean。 任意
enablePrepare = true && framework = calabashするときに使用します。 既定値: false.
タスクを、きゅうりプロファイルなしで強制的に実行します。
ビルド ディレクトリの uitestBuildDir -
string。
enablePrepare = true && framework = uitestする場合に必要です。
ビルドされたテスト アセンブリを含むディレクトリへのパスを指定します。
uitestStoreFile
-
ストア ファイルの
string。 任意
enablePrepare = true && framework = uitestするときに使用します。
ストア ファイルへのパスを指定します。
パスワードを格納する uitestStorePass -
string。 任意
enablePrepare = true && framework = uitestするときに使用します。
ストア ファイルのパスワードを指定します。 この値を暗号化するには、[変数] タブでロックが有効になっている新しい変数を使用します。
キー エイリアスの uitestKeyAlias -
string。 任意
enablePrepare = true && framework = uitestするときに使用します。
ストア ファイルで使用される公開キーと秘密キーのペアを識別するエイリアスを指定します。
uitestKeyPass
-
キー パスワードの
string。 任意
enablePrepare = true && framework = uitestするときに使用します。
エイリアスとストア ファイルのキー パスワードを指定します。 この値を暗号化するには、[変数] タブでロックが有効になっている新しい変数を使用します。
テスト ツール ディレクトリの uitestToolsDir -
string。 任意
enablePrepare = true && framework = uitestするときに使用します。
test-cloud.exeを含む Xamarin UI テスト ツールを使用してディレクトリへのパスを指定します。
signInfo
-
署名情報の
string。 任意
framework = calabash || framework = uitestするときに使用します。
署名情報を使用してテスト サーバーに署名します。
ビルド ディレクトリの xcuitestBuildDir -
string。 任意
enablePrepare = true && framework = xcuitestするときに使用します。
ビルド出力ディレクトリへのパスを指定します。これは通常、$(ProjectDir)/Build/Products/Debug-iphoneosです。
IPA パスのテストを xcuitestTestIpaPath - する
string。 任意
enablePrepare = true && framework = xcuitestするときに使用します。
XCUITest テストを使用して *.ipa ファイルへのパスを指定します。
その他のオプションを prepareOpts - する
string。 任意
enablePrepare = trueするときに使用します。
mobile-center test prepare stepに渡す追加の引数を指定します。
enableRun
-
テストの実行
boolean。 既定値: true.
credsType
-
認証方法の
string。
enableRun = trueする場合に必要です。 使用できる値: serviceEndpoint (Mobile Center 接続)、inputs (資格情報)。 既定値: serviceEndpoint.
認証方法を指定します。 Mobile Center サービス エンドポイント接続を使用するか、Visual Studio Mobile Center に接続するための資格情報を指定します。
serverEndpoint
-
Mobile Center 接続
string。
enableRun = true && credsType = serviceEndpointする場合に必要です。
Visual Studio Mobile Center 接続のサービス エンドポイントを指定します。 作成するには、[管理] リンク をクリックし、新しいサービス エンドポイントを作成します。
username
-
Mobile Center ユーザー名の
string。
enableRun = true && credsType = inputsする場合に必要です。
ユーザー名 設定するには、Azure Mobile Center にアクセスしてください。
password
-
Mobile Center パスワード
string。
enableRun = true && credsType = inputsする場合に必要です。
Azure Mobile Center にアクセスして、パスワードを設定します。 この文字列は、ビルド/リリース定義で定義された変数を $(passwordVariable)として受け取ることができます。 変数の型は、セキュリティで保護するために secret としてマークできます。
appSlug
-
アプリスラッグ
string。
enableRun = trueする場合に必要です。
アプリのスラッグは {username}/{app_identifier}の形式です。 アプリの {username} と {app_identifier} を見つけるには、Azure Mobile Apps でアプリの一覧を見つけます。 URL は https://mobile.azure.com/users/{username}/apps/{app_identifier} という形式です。
devices
-
デバイスの
string。
enableRun = trueする場合に必要です。
このテストを実行するデバイスを識別します。 Mobile Center テスト ビーコンから新しいテスト実行を定義するときに、この文字列をコピーして貼り付けます。
series
-
テストシリーズ
string。 任意
enableRun = trueするときに使用します。 既定値: master.
テストの実行を整理するための系列名を指定します (例: master、production、beta)。
dSYM ディレクトリの dsymDir -
string。 任意
enableRun = trueするときに使用します。
iOS シンボル ファイルを含む dSYM ディレクトリへのパスを指定します。
locale
-
システム言語の
string。
enableRun = trueする場合に必要です。 使用できる値: da_DK (デンマーク語)、nl_NL (オランダ語 (オランダ))、en_GB (英語 (英国))、en_US (英語 (米国))、fr_FR (フランス語 (フランス))、fr_FRja_JP (ドイツ語)、ru_RU (日本)、es_MX (ロシア語 (ロシア))、es_ES (スペイン語 (メキシコ))、user (スペイン語 (スペイン))、 (その他)。 既定値: en_US.
言語が表示されない場合は、その他 を指定し、そのロケール (en_USなど) を入力します。
その他のロケールを userDefinedLocale - する
string。 任意
enableRun = true && locale = userするときに使用します。
2 文字の ISO-639 言語コードと、2 文字の ISO 3166 国コードを、[language]_[country]などの en_US形式で指定します。
ログインの loginOpts - 追加オプション
string。 任意
enableRun = true && credsType = inputsするときに使用します。
mobile-center login stepに渡される追加の引数を指定します。
実行の追加オプションを runOpts - する
string。 任意
enableRun = trueするときに使用します。
mobile-center test runに渡される追加の引数を指定します。
async
-
テスト結果の を待たない
boolean。 任意
enableRun = trueするときに使用します。 既定値: false.
trueに設定すると、コマンドが非同期的に実行され、テスト結果を待たずにテストがアップロードされると終了します。
モバイル センター CLI の場所を cliLocationOverride - する
string。
mobile-center コマンド ライン インターフェイス (CLI) へのパスを指定します。
デバッグ出力を有効にする debug -
boolean。 既定値: false.
--debug コマンド ライン インターフェイス (CLI) に mobile-center を追加します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。