사용자 지정 테스트 환경을 위한 환경 변수 - AWS Device Farm

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자 지정 테스트 환경을 위한 환경 변수

Device Farm은 사용자 지정 테스트 환경 실행의 일부로 사용할 수 있도록 여러 환경 변수를 동적으로 구성합니다.

사용자 지정 환경 변수

Device Farm은 테스트 호스트에서 환경 변수로 적용되는 키-값 페어의 구성을 지원합니다. 이는 Device Farm 프로젝트 또는 실행 생성 중에 구성할 수 있습니다. 실행에 구성된 모든 변수는 상위 프로젝트에 구성될 수 있는 모든 변수를 대체합니다. 다음과 같은 제한 사항이 있습니다.

  • 사용자 지정 환경 변수는 레거시 iOS 테스트 호스트에서 지원되지 않습니다. 자세한 내용은 레거시 iOS 테스트 호스트 단원을 참조하십시오.

  • 로 시작하는 변수 이름은 내부 서비스용으로 예약$DEVICEFARM_되어 있습니다.

  • 사용자 지정 환경 변수는 테스트 사양에서 테스트 호스트 컴퓨팅 선택을 구성하는 데 사용되지 않을 수 있습니다.

공통 환경 변수

이 섹션에서는 Device Farm의 모든 테스트에 공통적인 환경 변수를 설명합니다.

$DEVICEFARM_DEVICE_NAME

테스트가 실행되는 디바이스입니다. 디바이스의 고유 디바이스 식별자(UDID)를 나타냅니다.

$DEVICEFARM_DEVICE_UDID

디바이스의 고유 식별자입니다.

$DEVICEFARM_DEVICE_PLATFORM_NAME

디바이스의 플랫폼 이름입니다. Android 또는 입니다iOS.

$DEVICEFARM_DEVICE_OS_VERSION

디바이스의 OS 버전입니다.

$DEVICEFARM_APP_PATH

(모바일 앱 테스트)

테스트가 실행되고 있는 호스트 머신의 모바일 앱 경로 웹 테스트 중에는이 변수를 사용할 수 없습니다.

$DEVICEFARM_LOG_DIR

고객 로그, 아티팩트 및 기타 원하는 파일이 나중에 검색할 수 있도록 저장되는 기본 디렉터리의 경로입니다. 예제 테스트 사양을 사용하면이 디렉터리의 파일이 ZIP 파일에 아카이브되고 테스트 실행 후 아티팩트로 사용할 수 있습니다.

$DEVICEFARM_SCREENSHOT_PATH

테스트 실행 중에 캡처되는 스크린샷이 있는 경우의 경로입니다.

$DEVICEFARM_PROJECT_ARN

작업의 상위 프로젝트의 ARN입니다.

$DEVICEFARM_RUN_ARN

작업 상위 실행의 ARN입니다.

$DEVICEFARM_DEVICE_ARN

테스트 중인 디바이스의 ARN입니다.

$DEVICEFARM_TOTAL_JOBS

상위 Device Farm 실행과 연결된 총 작업 수입니다.

$DEVICEFARM_JOB_NUMBER

내이 작업의 번호입니다$DEVICEFARM_TOTAL_JOBS. 예를 들어 실행에는 5개의 작업이 포함될 수 있으며 각 작업의 고유한 $DEVICEFARM_JOB_NUMBER 범위는 0~4입니다.

$AWS_REGION

AWS 리전입니다. 서비스는 테스트 중인 디바이스가 위치한 리전과 일치하도록 이를 설정합니다. 필요한 경우 사용자 지정 환경 변수로 재정의할 수 있습니다.

$ANDROID_HOME

(Android만 해당)

Android SDK 설치 디렉터리의 경로

Appium 테스트를 위한 환경 변수

이 섹션에서는 Device Farm의 사용자 지정 테스트 환경에서 모든 Appium 테스트에 사용되는 환경 변수를 설명합니다.

$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR

(Android만 해당)

Appium 웹 및 하이브리드 테스트에 사용하는 데 필요한 ChromeDriver 실행 파일이 포함된 디렉터리의 위치입니다.

$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>

(iOS만 해당)

Device Farm에서 실행되도록 구축된 WebDriverAgent 버전의 파생 데이터 경로입니다. 변수의 번호는 WebDriverAgent의 메이저 버전에 해당합니다. 예를 들어 DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9는 WebDriverAgent 버전 9.x를 가리킵니다. 자세한 내용은 iOS 테스트를 위한 WebDriverAgent 버전 선택 단원을 참조하십시오.

참고

$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N> 환경 변수는 레거시가 아닌 iOS 호스트에만 존재합니다. 자세한 내용은 레거시 iOS 테스트 호스트 단원을 참조하십시오.

$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9

(iOS 전용, 더 이상 사용되지 않음)

Device Farm에서 실행되도록 구축된 WebDriverAgent 버전의 파생 데이터 경로입니다. 대체 이름 지정 체계는 섹션을 참조$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>하세요.

XCUITest 테스트를 위한 환경 변수

이 섹션에서는 Device Farm의 사용자 지정 테스트 환경에서 XCUITest 테스트에 사용되는 환경 변수를 설명합니다.

$DEVICEFARM_XCUITESTRUN_FILE

Device Farm .xctestun 파일의 경로입니다. 앱 및 테스트 패키지에서 생성됩니다.

$DEVICEFARM_DERIVED_DATA_PATH

Device Farm xcodebuild 출력의 예상되는 경로

$DEVICEFARM_XCTEST_BUILD_DIRECTORY

테스트 패키지 파일의 압축을 푼 콘텐츠의 경로