VSMobileCenterTest@0 - Mobile Center 測試 v0 工作

發行項
04/29/2024

使用此工作來測試 Visual Studio Mobile Center 的行動應用程式套件。

Syntax

# 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、、espressocalabash、 uitest (Xamarin UI 測試) 。 xcuitest 預設值：appium。

指定工作將使用的測試架構。

appiumBuildDir - 組建目錄
string. 當 enablePrepare = true && framework = appium 時為必要。

指定包含 Appium 測試之目錄的路徑。

espressoBuildDir - 組建目錄
string. 選擇性。使用時機 enablePrepare = true && framework = espresso。

指定輸出目錄的路徑。

espressoTestApkPath - 測試 APK 路徑
string. 選擇性。使用時機 enablePrepare = true && framework = espresso。

使用一般測試來指定 APK 檔案的路徑。如果未設定值， build-dir 則會用來尋找 APK 檔案。允許使用萬用字元。

calabashProjectDir - 項目目錄
string. 當 enablePrepare = true && framework = calabash 時為必要。

指定一個路徑，以取得一個 Workspacebash 工作區目錄。

calabashConfigFile - Cucumber 組態檔
string. 選擇性。使用時機 enablePrepare = true && framework = calabash。

指定 Cucumber 組態檔的檔案路徑，通常是 cucumber.yml。

calabashProfile - 要執行的配置檔
string. 選擇性。使用時機 enablePrepare = true && framework = calabash。

指定要執行的設定檔。此值必須存在於 Cucumber 組態檔中。

calabashSkipConfigCheck - 略過設定檢查
boolean. 選擇性。使用時機 enablePrepare = true && framework = calabash。預設值：false。

強制工作在沒有 Cucumber 配置檔的情況下執行。

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。

使用包含的 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 StudioMobile Center。

serverEndpoint - 行動中心連線
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 行動中心來設定密碼。此字串可以接受組建/發行定義中定義的變數作為 $(passwordVariable)。您可以將變數類型標示為 secret 來保護它。

appSlug - 應用程式 Slug
string. 當 enableRun = true 時為必要。

應用程式 slug 格式 {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 。

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。

以格式 [language]_[country]指定任何雙字母 ISO-639 語言代碼，以及任何雙字母 ISO 3166 國家/地區代碼，例如 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。

將新增 --debug 至 mobile-center 命令行介面 (CLI) 。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控件選項和一般工作屬性。

輸出變數

無。

規格需求

需求	描述
管線類型	YAML，傳統組建
執行於	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	所有支援的代理程式版本。
工作類別	測試