다음을 통해 공유


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.
# 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. 
    #uitestStoreFile: # 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, espresso, calabash, uitest (Xamarin UI 테스트), xcuitest. 기본값은 appium입니다.


appiumBuildDirectory - 빌드 디렉터리
입력 별칭: appiumBuildDir. string. 필요한 경우 enablePrepare = true && framework = appium입니다.

Appium 테스트를 사용하는 디렉터리의 경로입니다.


espressoBuildDirectory - 빌드 디렉터리
입력 별칭: espressoBuildDir. string. 선택 사항입니다. 을 사용할 때 enablePrepare = true && framework = espresso사용합니다.

Espresso 출력 디렉터리의 경로입니다.


espressoTestApkFile - APK 경로 테스트
입력 별칭: espressoTestApkPath. string. 선택 사항입니다. 을 사용할 때 enablePrepare = true && framework = espresso사용합니다.

에스프레소 테스트가 있는 APK 파일의 경로입니다. 설정되지 않은 경우 를 build-dir 사용하여 검색합니다. 와일드카드가 허용됩니다.


calabashProjectDirectory - 프로젝트 디렉터리
입력 별칭: calabashProjectDir. string. 필요한 경우 enablePrepare = true && framework = calabash입니다.

Calabash 작업 영역 디렉터리의 경로입니다.


calabashConfigFile - 오이 구성 파일
string. 선택 사항입니다. 을 사용할 때 enablePrepare = true && framework = calabash사용합니다.

일반적으로 cucumber.yml 오이 구성 파일의 경로입니다.


calabashProfile - 실행할 프로필
string. 선택 사항입니다. 을 사용할 때 enablePrepare = true && framework = calabash사용합니다.

실행할 프로필입니다. 이 값은 오이 구성 파일에 있어야 합니다.


calabashSkipConfigCheck - 구성 검사 건너뛰기
boolean. 선택 사항입니다. 을 사용할 때 enablePrepare = true && framework = calabash사용합니다. 기본값은 false입니다.

true설정하면 이 입력은 오이 프로필에 지정된 구성 검사 건너뜁니다.


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 - 앱 슬러그
string. 필요한 경우 enableRun = true입니다.

앱 슬러그는 형식입니다 <username>/<app_identifier>. 앱의 <username><app_identifier> 을 찾으려면 Visual Studio App Center에서 해당 이름을 클릭합니다. 결과 URL은 형식 https://appcenter.ms/users/<username>/apps/<app_identifier>입니다.


devices - 장치
string. 필요한 경우 enableRun = true입니다.

이 테스트가 실행될 디바이스를 식별합니다. Visual Studio App Center 테스트 비콘에서 새 테스트 실행을 정의할 때 이 문자열을 복사하여 붙여넣습니다.


series - 테스트 계열
string. 선택 사항입니다. 을 사용할 때 enableRun = true사용합니다. 기본값은 master입니다.

테스트 실행을 구성하기 위한 계열 이름입니다(예: master, 프로덕션, 베타).


dsymDirectory - dSYM 디렉터리
입력 별칭: dsymDir. string. 선택 사항입니다. 을 사용할 때 enableRun = true사용합니다.

iOS 기호 파일의 경로입니다.


localeOption - 시스템 언어
입력 별칭: locale. string. 필요한 경우 enableRun = true입니다. 허용되는 값: da_DK (덴마크어(덴마크)), nl_NL (네덜란드어(네덜란드)), en_GB (영어(영국)), en_US (영어(미국)), (프랑스어(프랑스)), fr_FR (독일어(독일)), de_DE (일본어(일본)), ru_RUja_JP (러시아어(러시아)), es_MX (스페인어(멕시코)), es_ES (스페인어(스페인)), user (기타). 기본값은 en_US입니다.

언어가 표시되지 않는 경우 활용합니다. 를 선택하고 Other 로캘(예: en_US)을 입력합니다.


userDefinedLocale - 기타 로캘
string. 선택 사항입니다. 을 사용할 때 enableRun = true && locale = user사용합니다.

와 같은 en_US형식<language>_<country>의 두 문자 ISO 3166 국가 코드와 함께 두 글자 ISO-639 언어 코드를 입력합니다.


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입니다.

Visual Studio App Center CLI에 를 추가합니다 --debug .


uitestStoreFile - 저장소 파일
string. 선택 사항입니다. 을 사용할 때 enablePrepare = true && framework = uitest사용합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

이 작업을 통해 App Center 테스트를 사용하여 애플리케이션 이진 파일(.apk 또는 .ipa 파일)에 대해 테스트 도구 모음을 실행할 수 있습니다.

예제

이 예제에서는 App Center 테스트 작업을 사용하여 Android 앱에서 Espresso 테스트를 실행합니다.

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

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 2.206.1 이상
작업 범주 테스트
요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 2.144.0 이상
작업 범주 테스트
요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 지원되는 모든 에이전트 버전.
작업 범주 테스트