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, 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 .

작업 제어 옵션

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

출력 변수

없음

설명

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

• 먼저 App Center에 등록합니다.
• 이 작업을 사용하는 방법에 대한 자세한 내용은 UI 테스트에 Azure DevOps 사용 App Center 설명서 문서를 참조하세요.

예제

이 예제에서는 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 이상
작업 범주	테스트