VSMobileCenterTest@0 - Mobile Center Test v0 タスク

[アーティクル]
07/02/2024

このタスクを使用して、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
エージェントのバージョン	サポートされているすべてのエージェントバージョン。
タスクのカテゴリ	テスト

次の方法で共有

VSMobileCenterTest@0 - Mobile Center Test v0 タスク

構文

入力

タスク制御オプション

出力変数

必要条件

フィードバック

その他のリソース