환경 변수 빌드

중요

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

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

환경 변수는 빌드 스크립트 작업을 관리하는 데 도움이 됩니다. 미리 정의된 변수를 호출하거나 직접 만들 수 있습니다.

미리 정의된 변수

일반 변수	설명
APPCENTER_BUILD_ID	현재 빌드의 고유 식별자
APPCENTER_BRANCH	빌드되는 분기의 이름
APPCENTER_SOURCE_DIRECTORY	빌드 컴퓨터의 소스 코드 위치
APPCENTER_OUTPUT_DIRECTORY	빌드 결과가 저장되는 위치
APPCENTER_TRIGGER	빌드를 트리거한 것은 빌드이거나 continuous 푸시에 의한 것 manual 이었습니다.
iOS 관련
APPCENTER_XCODE_PROJECT	선택한 Xcode 프로젝트
APPCENTER_XCODE_SCHEME	선택한 Xcode 스키마
Android 관련
APPCENTER_ANDROID_VARIANT	선택한 Android 변형
APPCENTER_ANDROID_MODULE	선택한 Android 모듈
UWP 관련
APPCENTER_UWP_SOLUTION	선택한 솔루션
APPCENTER_UWP_CONFIGURATION	선택한 구성
Xamarin 관련
APPCENTER_XAMARIN_PROJECT	선택한 프로젝트
APPCENTER_XAMARIN_CONFIGURATION	선택한 구성
특정 React Native
APPCENTER_REACTNATIVE_PACKAGE	선택한 패키지

빌드 구성에 선언된 변수

사용자 지정 환경 변수를 사용하면 리포지토리에 확인하지 않고 빌드에 필요한 중요한 정보를 정의할 수 있습니다. 빌드 구성에서 환경 변수를 만들고 빌드에서 사용할 수 있습니다. 예를 들어 API 키, 웹후크 토큰 또는 기타 비밀에 액세스합니다.

참고

'Platform'은 환경 변수로 사용하도록 예약되어 있습니다.

변수 암호화

변수 값은 잠금 아이콘을 클릭하여 암호화됩니다. 이 아이콘은 빌드 구성 & 로그에서 난독 처리합니다. 암호화된 값은 저장되면 편집할 수 없지만 다시 만들 & 삭제할 수 있습니다.

암호화되지 않은 값은 언제든지 암호화할 수 있습니다.

변수 액세스

미리 설정된 환경 변수는 빌드 프로세스 중에 사용할 수 있습니다. 사용 중인 도구 집합에 따라 구문이 다릅니다.

참고

환경 변수를 사용하는 올바른 방법은 사용된 도구 체인에 따라 달라집니다.

빌드 스크립트

빌드 스크립트에서 Bash 또는 PowerShell을 사용하는지 여부에 따라 다음 구문을 사용하여 변수에 액세스할 수 있습니다.

• Bash

  $ENVIRONMENT_VARIABLE
  

• PowerShell

  $env:ENVIRONMENT_VARIABLE
  

Xamarin 또는 UWP용 NuGet.Config

Xamarin 또는 UWP 앱을 빌드하는 경우 인증이 필요한 프라이빗 NuGet 피드에 연결할 수 있습니다. NuGet.Config 파일에서 정의한 변수를 사용할 수 있습니다. 파일의 자격 증명 NuGet.Config 사용에 대한 자세한 내용은 참조 설명서를 참조하세요.

<packageSourceCredentials>
  <MyAuthNuget>
    <add key="Username" value="%USER_VARIABLE%" />
    <add key="ClearTextPassword" value="%PASSWORD_VARIABLE%" />
  </MyAuthNuget>
</packageSourceCredentials>

Android용 build.gradle(앱 수준)

Android 앱의 경우 build.gradle (앱 수준) 구성에서 변수에 액세스할 수 있습니다. 자세한 내용은 Gradle 팁 및 레시피 설명서를 참조하세요 .

buildConfigField("String", "API_KEY", "\"${System.env.API_KEY}\"")