테스트의 환경 변수

아티클
03/15/2024

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아봅니다.

테스트할 때 사용자 지정 환경 변수가 설정된 애플리케이션 또는 테스트 실행기를 시작하는 것이 도움이 되는 경우가 많습니다. 예를 들어 환경 변수를 사용하여 애플리케이션의 동작을 제어하거나 로그인 정보를 사용하여 테스트를 제공할 수 있습니다.

대부분의 프레임워크에서 유용한 환경 변수는 테스트, 애플리케이션 또는 둘 다 내에서 사용할 수 있습니다. App Center CLI를 통해 추가 환경 변수를 설정할 수 있습니다.

프레임워크별 지원

App Center에서 일부 프레임워크 및 플랫폼 조합은 사용자 지정 환경 변수 설정 및 사용뿐만 아니라 애플리케이션 및 테스트에 자동으로 제공되는 변수(예 RUNNING_IN_APP_CENTER : 및 APP_CENTER_TEST)를 사용할 수 있도록 지원합니다.

이 표에는 각 프레임워크 또는 플랫폼에 대해 지원되는 환경 변수가 나열됩니다.

프레임워크	환경 변수 테스트	애플리케이션 환경 변수
Appium	사용 가능	사용할 수 없음
호리병박	사용 가능	iOS에서만 사용 가능
에스프레소	사용 가능	사용 가능
Xamarin.UITest	사용 가능	iOS에서만 사용 가능
XCUITest	사용할 수 없음	사용할 수 없음

참고

Espresso 테스트 및 Android 애플리케이션에서는 Android에서 환경 변수를 InstrumentationRegistry 지원하지 않으므로 에서 변수를 사용할 수 있습니다.

애플리케이션에서 사용할 수 있는 환경 변수

지원되는 프레임워크의 경우 애플리케이션 내에서 이러한 환경 변수를 사용할 수 있습니다.

환경 변수	설명
`RUNNING_IN_APP_CENTER`	`1` App Center 테스트에서 디바이스가 실행 중일 때 로 설정

테스트에서 사용할 수 있는 환경 변수

지원되는 프레임워크의 경우 이러한 환경 변수는 테스트 내에서 사용할 수 있습니다.

환경 변수	설명
`APP_CENTER_TEST`	`1` App Center 테스트에서 테스트를 실행할 때 로 설정합니다.
`XTC_APP_ENDPOINT`	다른 서비스가 애플리케이션과 통신할 수 있도록 하는 디바이스의 보안 포트 주소입니다. 애플리케이션에 자체 HTTP 서버를 포함하고 테스트 프레임워크 외부에서 앱과 상호 작용해야 하는 애플리케이션에서 사용됩니다. (Android만 해당). 예: `http://devicehost151.prod:37777/proxy2/token-c059c5c6-37cc-4400-9038-96d1d342ed6e/`
`XTC_DEVICE`	운영 체제 이름과 디바이스 이름을 결합합니다. 예: `Google Pixel 2 XL (8.1.0)`
`XTC_DEVICE_INDEX`	0~N-1 범위의 문자열입니다. 여기서 N은 테스트가 실행되는 디바이스의 수입니다. 동일한 테스트가 여러 디바이스에서 병렬로 실행되는 경우에 사용됩니다. `XTC_DEVICE_INDEX` 는 각 디바이스에 대한 각 테스트 실행에 대해 고유합니다. 자세한 내용은 테스트 중 동시 데이터베이스 변경 처리 를 참조하세요.
`XTC_DEVICE_NAME`	테스트를 실행하는 디바이스의 이름입니다. 예: `Google Pixel 2 XL`
`XTC_DEVICE_OS`	테스트를 실행하는 디바이스의 운영 체제 이름입니다. 예: `8.1.0`
`XTC_LANG`	테스트를 실행하는 데 사용되는 언어 코드입니다. 예: `en`
`XTC_PLATFORM`	테스트 중인 플랫폼( `android` 또는 `ios`)

추가 환경 변수 설정

CLI를 사용하여 App Center에 테스트를 업로드할 때 옵션을 사용하여 --test-parameter 환경 변수를 설정하도록 요청할 수 있습니다. 환경 변수는 테스트 실행기 및 애플리케이션(테스트 중인 애플리케이션 또는 AUT)에 대해 설정할 수 있습니다.

참고

App Center Test에서 테스트 및 애플리케이션 변수를 지원하는 프레임워크에 대한 자세한 내용은 프레임워크별 지원을 참조하세요.

테스트에 대한 환경 변수

$ appcenter test run < > \
  < args > \
  --test-parameter "test_env=USERNAME=clever_user@example.com" \
  --test-parameter "test_env=PASSWORD=pa$$w0rd" \
  --test-parameter "test_env=TWO_FACTOR_URL=https://staging.example.com/test-2FA" \
  --test-parameter "test_env=UPGRADE_PURCHASED=0"

애플리케이션에 대한 환경 변수

$ appcenter test run < > \
  < args > \
  --test-parameter "app_env=VERBOSE_LOGGING=1" \
  --test-parameter "app_env=CONTENT_SERVER=staging.example.com \
  --test-parameter "app_env=API_LEVEL=3.2" \
  --test-parameter "app_env=UPGRADE_PURCHASED=0"

테스트에서 환경 변수 사용

샘플 Appium 테스트 코드:

다음 코드 조각은 Appium을 사용하여 App Center Test에서 환경 변수에 액세스하는 방법을 보여 줍니다.


String appCenterTest = System.getenv("APP_CENTER_TEST");

샘플 Calabash 테스트 코드:

다음 코드 조각은 Calabash를 사용하여 App Center Test에서 환경 변수에 액세스하는 방법을 보여 줍니다.


app_center_test = ENV["APP_CENTER_TEST"]

샘플 에스프레소 테스트 코드

Android는 환경 변수를 지원하지 않으므로 App Center 테스트는 에스프레소 대신 값을 설정합니다 InstrumentationRegistry . 다음 코드 조각은 값에 액세스 InstrumentationRegistry 하는 방법을 보여줍니다.


String appCenterTest = InstrumentationRegistry.getArguments().getString("APP_CENTER_TEST");

샘플 Xamarin.UITest 테스트 코드

다음 코드 조각은 Xamarin.UITest를 사용하여 App Center Test에서 환경 변수에 액세스하는 방법을 보여 줍니다.

string appCenterTest = Environment.GetEnvironmentVariable("APP_CENTER_TEST");

애플리케이션에서 환경 변수 사용

샘플 네이티브 Android 애플리케이션 코드

참고

App Center Test에서 애플리케이션 변수를 지원하는 프레임워크에 대한 자세한 내용은 프레임워크별 지원을 참조하세요.

Android는 환경 변수를 지원하지 않으므로 App Center 테스트는 대신 값을 설정합니다 InstrumentationRegistry . 다음 코드 조각은 값에 액세스 InstrumentationRegistry 하는 방법을 보여줍니다.


String runningInAppCenter = InstrumentationRegistry.getArguments().getString("RUNNING_IN_APP_CENTER");

샘플 네이티브 iOS 애플리케이션 코드

참고