AppCenterTest@1 - App Center 測試 v1 工作

使用 Visual Studio App Center 測試應用程式套件。

Syntax

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. 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.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App 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.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

輸入

appFile - 二進位應用程式文件路徑
輸入別名： app。 string. 必要。

從存放庫根目錄到您要測試之 APK 或 IPA 檔案的相對路徑。

artifactsDirectory - Artifacts 目錄
輸入別名： artifactsDir。 string. 必要。 預設值：$(Build.ArtifactStagingDirectory)/AppCenterTest。

指定要放置準備步驟所產生的成品的位置，以及執行步驟所使用的位置。 如果此目錄不存在，將會建立此目錄。

prepareTests - 準備測試
輸入別名： enablePrepare。 boolean. 預設值：true。

當設定為 true時，此輸入會準備測試。

frameworkOption - 測試架構
輸入別名： framework。 string. 當 enablePrepare = true 時為必要。 允許的值：appium、、、calabashespresso (uitest Xamarin UI 測試) 、 xcuitest。 預設值：appium。

appiumBuildDirectory - 組建目錄
輸入別名： appiumBuildDir。 string. 當 enablePrepare = true && framework = appium 時為必要。

具有 Appium 測試之目錄的路徑。

espressoBuildDirectory - 組建目錄
輸入別名： espressoBuildDir。 string. 選擇性。 使用 時 enablePrepare = true && framework = espresso。

要輸出目錄的路徑。

espressoTestApkFile - 測試 APK 路徑
輸入別名： espressoTestApkPath。 string. 選擇性。 使用 時 enablePrepare = true && framework = espresso。

APK 檔案的路徑與一般測試。 如果未設定， build-dir 則會用來探索它。 允許通配符。

calabashProjectDirectory - 項目目錄
輸入別名： calabashProjectDir。 string. 當 enablePrepare = true && framework = calabash 時為必要。

此路徑為一個「檔案」工作區目錄。

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

Cucumber 組態檔的路徑，通常cucumber.yml。

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

要執行的配置檔。 此值必須存在於 Cucumber 組態檔中。

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

當設定為 true時，此輸入會略過 Cucumber 配置檔所指定的組態檢查。

uiTestBuildDirectory - 組建目錄
輸入別名： uitestBuildDir。 string. 當 enablePrepare = true && framework = uitest 時為必要。

具有所建置測試元件之目錄的路徑。

uitestStorePath - 存放區檔案
string. 選擇性。 使用 時 enablePrepare = true && framework = uitest。

用來簽署應用程式的市集檔案路徑。

uiTestStorePassword - 儲存密碼
輸入別名： uitestStorePass。 string. 選擇性。 使用 時 enablePrepare = true && framework = uitest。

用來簽署應用程式的市集檔案密碼。 若要加密此值，請使用新的變數，並在 [變數] 索引卷標上啟用其鎖定。

uitestKeyAlias - 索引鍵別名
string. 選擇性。 使用 時 enablePrepare = true && framework = uitest。

指定別名，識別存放區檔案中使用的公開/私鑰組。

uiTestKeyPassword - 金鑰密碼
輸入別名： uitestKeyPass。 string. 選擇性。 使用 時 enablePrepare = true && framework = uitest。

指定別名和儲存盤案的金鑰密碼。 若要加密此值，請使用新的變數，並在 [變數] 索引卷標上啟用其鎖定。

uiTestToolsDirectory - 測試工具目錄
輸入別名： uitestToolsDir。 string. 選擇性。 使用 時 enablePrepare = true && framework = uitest。

包含 test-cloud.exe的 Xamarin UI 測試工具之目錄路徑。

signInfo - 簽署資訊
string. 選擇性。 使用 時 framework = calabash || framework = uitest。

簽署測試伺服器。

xcUITestBuildDirectory - 組建目錄
輸入別名： xcuitestBuildDir。 string. 選擇性。 使用 時 enablePrepare = true && framework = xcuitest。

組建輸出目錄的路徑通常 $(ProjectDir)/Build/Products/Debug-iphoneos () 。

xcUITestIpaFile - 測試 IPA 路徑
輸入別名： xcuitestTestIpaPath。 string. 選擇性。 使用時機 enablePrepare = true && framework = xcuitest。

具有 XCUITest 測試之 .ipa 檔案的路徑。

prepareOptions - 其他選項
輸入別名： prepareOpts。 string. 選擇性。 使用時機 enablePrepare = true。

傳遞至 App Center 測試準備步驟的其他自變數。

runTests - 執行測試
輸入別名： enableRun。 boolean. 預設值：true。

執行測試。

credentialsOption - 驗證方法
輸入別名： credsType。 string. 當 enableRun = true 時為必要。 允許的值： serviceEndpoint (App Center 服務連線) ， inputs (認證) 。 預設值：serviceEndpoint。

使用 App Center 服務連線或輸入認證以連線到 Visual Studio App Center。

serverEndpoint - App Center 服務連線
string. 當 enableRun = true && credsType = serviceEndpoint 時為必要。

選取 Visual Studio App Center 的服務連線。 如有需要，請按兩下 [管理] 連結以建立新的服務連線。

username - App Center 用戶名稱
string. 當 enableRun = true && credsType = inputs 時為必要。

造訪 App Center 登入頁面來建立您的用戶名稱，並提供這裡的值。

password - App Center 密碼
string. 當 enableRun = true && credsType = inputs 時為必要。

造訪 App Center 登入頁面來設定密碼，並在這裡提供值。 已接受組建或發行管線 $(passwordVariable) 中定義的變數。 您可以將變數類型標示為 secret 來保護它。

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

應用程式 slug 格式 <username>/<app_identifier>為 。 若要尋找 <username> 和 <app_identifier> 作為應用程式，請從 Visual Studio App Center 按兩下其名稱。 產生的網址格式 https://appcenter.ms/users/<username>/apps/<app_identifier>為 。

devices - 設備
string. 當 enableRun = true 時為必要。

識別此測試將針對其執行的裝置。 當您從 Visual Studio App Center 測試指標定義新的測試回合時，複製並貼上此字串。

series - 測試系列
string. 選擇性。 使用時機 enableRun = true。 預設值：master。

用來組織測試回合 (的數列名稱，例如：master、production、beta) 。

dsymDirectory - dSYM 目錄
輸入別名： dsymDir。 string. 選擇性。 使用時機 enableRun = true。

iOS 符號檔的路徑。

localeOption - 系統語言
輸入別名： 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。

如果未顯示您的語言，請使用 。 選擇並 Other 輸入其地區設定，例如 en_US。

userDefinedLocale - 其他地區設定
string. 選擇性。 使用時機 enableRun = true && locale = user。

以 格式 <language>_<country>輸入任何雙字母 ISO-639 語言代碼以及任何雙字母 ISO 3166 國家/地區代碼，例如 en_US。

loginOptions - 登入的其他選項
輸入別名： loginOpts。 string. 選擇性。 使用時機 enableRun = true && credsType = inputs。

傳遞至 Visual Studio App Center 登入步驟的其他自變數。

runOptions - 執行的其他選項
輸入別名： runOpts。 string. 選擇性。 使用時機 enableRun = true。

傳遞至 Visual Studio App Center 測試回合的其他自變數。

skipWaitingForResults - 不要等候測試結果
輸入別名： async。 boolean. 選擇性。 使用時機 enableRun = true。 預設值：false。

以異步方式執行命令，並在上傳測試時結束，而不需要等候測試結果。

cliFile - App Center CLI 位置
輸入別名： cliLocationOverride。 string.

組建或發行代理程式上 Visual Studio App Center CLI 的路徑。

showDebugOutput - 啟用偵錯輸出
輸入別名： debug。 boolean. 預設值：false。

新增 --debug 至 Visual Studio App Center CLI。

工作控制選項

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

輸出變數

無。

備註

這項工作可讓您使用App Center測試，針對應用程式二進位 (.apk 或 .ipa 檔案 ) 執行測試套件。

• 請先向 App Center 註冊。
• 如需使用此工作的詳細資訊，請參閱 App Center 檔文章 使用 Azure DevOps 進行 UI 測試。

範例

此範例會使用App Center測試工作在Android應用程式上執行測試。

steps:
- task: AppCenterTest@1
  displayName: 'Espresso Test - Synchronous'
  inputs:
    appFile: 'Espresso/espresso-app.apk'
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest'
    frameworkOption: espresso
    espressoBuildDirectory: Espresso
    serverEndpoint: 'myAppCenterServiceConnection'
    appSlug: 'xplatbg1/EspressoTests'
    devices: a84c93af

規格需求

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