VSMobileCenterTest@0 - Mobile Center Test v0 タスク

このタスクを使用して、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 - Artifacts ディレクトリ
string. 必須です。 既定値: $(Build.ArtifactStagingDirectory)/MobileCenterTest

準備ステップによって生成され、実行ステップで使用される成果物を配置するディレクトリを指定します。 ディレクトリが存在しない場合は作成されます。


enablePrepare - テストの準備
boolean. 既定値: true

に設定すると true、テストが準備されます。


framework - Test Framework
string. enablePrepare = true の場合に必要です。 使用できる値: appium、、、 calabashuitest (Xamarin UI テスト)、xcuitestespresso。 既定値: 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 - Project Directory
string. enablePrepare = true && framework = calabash の場合に必要です。

Calabash ワークスペース ディレクトリのパスを指定します。


calabashConfigFile - きゅうり構成ファイル
string. 省略可能。 の場合は enablePrepare = true && framework = calabashを使用します。

通常は cucumber.ymlである、Cucumber 構成ファイルへのファイル パスを指定します。


calabashProfile - 実行するプロファイル
string. 省略可能。 の場合は enablePrepare = true && framework = calabashを使用します。

実行するプロファイルを指定します。 この値は、Cucumber 構成ファイルに存在する必要があります。


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 - Test Tools ディレクトリ
string. 省略可能。 の場合は enablePrepare = true && framework = uitestを使用します。

を含む Xamarin UI テスト ツールを使用して、ディレクトリへのパスを test-cloud.exe指定します。


signInfo - 署名情報
string. 省略可能。 の場合は framework = calabash || framework = uitestを使用します。

署名情報を使用してテスト サーバーに署名します。


xcuitestBuildDir - ビルド ディレクトリ
string. 省略可能。 の場合は enablePrepare = true && framework = xcuitestを使用します。

ビルド出力ディレクトリ (通常 $(ProjectDir)/Build/Products/Debug-iphoneosは ) へのパスを指定します。


xcuitestTestIpaPath - IPA パスのテスト
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 Test ビーコンから新しいテスト実行を定義するときに、この文字列をコピーして貼り付けます。


series - テスト シリーズ
string. 省略可能。 の場合は enableRun = trueを使用します。 既定値: master

テストの実行を整理するための系列名 (、、betaなど) を指定します。 masterproduction


dsymDir - dSYM ディレクトリ
string. 省略可能。 の場合は enableRun = trueを使用します。

iOS シンボル ファイルを含む dSYM ディレクトリへのパスを指定します。


locale - システム言語
string. enableRun = true の場合に必要です。 使用できる値: da_DK (デンマーク語 (デンマーク)、 nl_NL (オランダ語 (オランダ語)、 en_GB (英語 (イギリス))、 en_US (英語 (米国)、 fr_FR (フランス語 (フランス))、 de_DE (ドイツ語 (ドイツ)、 ja_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設定すると、コマンドが非同期的に実行され、テスト結果を待たずにテストがアップロードされると終了します。


cliLocationOverride - mobile-center CLI の場所
string.

コマンド ライン インターフェイス (CLI) へのパスを mobile-center 指定します。


debug - デバッグ出力を有効にする
boolean. 既定値: false

コマンド ライン インターフェイス (CLI) に mobile-center を追加--debugします。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド
実行日 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン サポートされているすべてのエージェント バージョン。
タスクのカテゴリ テスト