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

# 사용자 지정 테스트 환경을 위한 환경 변수
<a name="custom-test-environment-variables"></a>

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

**Topics**
+ [사용자 지정 환경 변수](#custom-test-environment-variables-custom)
+ [공통 환경 변수](#custom-test-environment-variables-common)
+ [Appium 테스트를 위한 환경 변수](#custom-test-environment-variables-appium)
+ [XCUITest 테스트를 위한 환경 변수](#custom-test-environment-variables-xcuitest)

## 사용자 지정 환경 변수
<a name="custom-test-environment-variables-custom"></a>

 Device Farm은 테스트 호스트에서 환경 변수로 적용되는 키-값 페어의 구성을 지원합니다. 이는 Device Farm 프로젝트 또는 실행 생성 중에 구성할 수 있습니다. 실행에 구성된 모든 변수는 상위 프로젝트에 구성될 수 있는 모든 변수를 대체합니다. 다음과 같은 제한 사항이 있습니다.
+ 사용자 지정 환경 변수는 레거시 iOS 테스트 호스트에서 지원되지 않습니다. 자세한 내용은 [레거시 iOS 테스트 호스트](custom-test-environments-hosts-ios.md#legacy-ios-host) 단원을 참조하십시오.
+ 로 시작하는 변수 이름은 내부 서비스용으로 예약`$DEVICEFARM_`되어 있습니다.
+ 사용자 지정 환경 변수는 테스트 사양에서 테스트 호스트 컴퓨팅 선택을 구성하는 데 사용되지 않을 수 있습니다.

## 공통 환경 변수
<a name="custom-test-environment-variables-common"></a>

 이 섹션에서는 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` **  
 고객 로그, 아티팩트 및 기타 원하는 파일이 나중에 검색할 수 있도록 저장되는 기본 디렉터리의 경로입니다. [예제 테스트 사양을](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example) 사용하면이 디렉터리의 파일이 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\$14입니다.

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

** `$ANDROID_HOME` **  
 *(Android만 해당)*   
 Android SDK 설치 디렉터리의 경로 

## Appium 테스트를 위한 환경 변수
<a name="custom-test-environment-variables-appium"></a>

 이 섹션에서는 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 버전 선택](test-types-appium.md#test-types-appium-select-wda) 단원을 참조하십시오.  
 `$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>` 환경 변수는 레거시가 아닌 iOS 호스트에만 존재합니다. 자세한 내용은 [레거시 iOS 테스트 호스트](custom-test-environments-hosts-ios.md#legacy-ios-host) 단원을 참조하십시오.

** `$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9` **  
 *(iOS 전용, 더 이상 사용되지 않음)*   
 Device Farm에서 실행되도록 구축된 WebDriverAgent 버전의 파생 데이터 경로입니다. 대체 이름 지정 체계는 섹션을 참조`$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>`하세요.

## XCUITest 테스트를 위한 환경 변수
<a name="custom-test-environment-variables-xcuitest"></a>

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

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

** `$DEVICEFARM_DERIVED_DATA_PATH` **  
Device Farm xcodebuild 출력의 예상되는 경로

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