AppCenterTest@1 - App Center 테스트 v1 작업

아티클
03/24/2025

Visual Studio App Center를 사용하여 앱 패키지를 테스트합니다.

구문론

# 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때 사용합니다.

Espresso 테스트가 있는 APK 파일의 경로입니다. 설정하지 않으면 build-dir 검색하는 데 사용됩니다. 와일드카드가 허용됩니다.

calabashProjectDirectory - Project 디렉터리
입력 별칭: 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에 연결합니다.

App Center 서비스 연결serverEndpoint -
string; enableRun = true && credsType = serviceEndpoint때 필요합니다.

Visual Studio App Center에 대한 서비스 연결을 선택합니다. 필요한 경우 관리 링크를 클릭하여 새 서비스 연결을 만듭니다.

App Center 사용자 이름username -
string; enableRun = true && credsType = inputs때 필요합니다.

App Center 로그인 페이지방문하여 사용자 이름을 만들고 여기에 값을 제공합니다.

App Center 암호password -
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, 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때 사용합니다.

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

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

명령을 비동기적으로 실행하고 테스트 결과를 기다리지 않고 테스트가 업로드되면 종료됩니다.

App Center CLI 위치cliFile -
입력 별칭: 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

요구 사항

요구 사항	설명
파이프라인 유형	YAML, 클래식 빌드
다음에서 실행	에이전트, DeploymentGroup
요구	없음
기능	이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한	어느 것이든
settable 변수	어느 것이든
에이전트 버전	2.206.1 이상
작업 범주	테스트

요구 사항	설명
파이프라인 유형	YAML, 클래식 빌드
다음에서 실행	에이전트, DeploymentGroup
요구	없음
기능	이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한	어느 것이든
settable 변수	어느 것이든
에이전트 버전	2.144.0 이상
작업 범주	테스트

요구 사항	설명
파이프라인 유형	YAML, 클래식 빌드
다음에서 실행	에이전트, DeploymentGroup
요구	없음
기능	이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한	어느 것이든
settable 변수	어느 것이든
에이전트 버전	지원되는 모든 에이전트 버전입니다.
작업 범주	테스트

다음을 통해 공유

AppCenterTest@1 - App Center 테스트 v1 작업

구문론

입력

작업 제어 옵션

출력 변수

비고

예시

요구 사항

피드백

추가 리소스