사용 가능한 환경 변수
Find all available environment variables for Unity Build Automation scripts and builds.
읽는 시간 2분최근 업데이트: 9달 전
다음 표에는 Unity Build Automation용 환경 변수가 나열되어 있습니다.
시스템
시스템 환경 변수는 시스템의 동작과 설치된 리소스의 위치를 관리합니다. 모든 변수가 설정되어 있으며 사전 빌드와 포스트 빌드 스크립트 모두에서 사용할 수 있습니다.
변수 | 설명 |
|---|---|
| ANDROID_HOME | Android 라이브러리로 연결되는 로컬 경로 |
| ANDROID_NDK_ROOT | Android NDK 루트 디렉토리로 연결되는 로컬 경로 |
| BUILDER_OS | 빌드가 실행되는 운영체제 유형입니다. (MAC이나 WINDOWS) |
| CCD_BINARY_PATH | Cloud Content Delivery 바이너리 실행 파일로 연결되는 로컬 경로 |
| HOMEDRIVE | 홈 드라이브 위치 |
| HOMEPATH | 홈 디렉토리로 연결되는 상대 경로 |
| OUTPUT_DIRECTORY | 빌드 프로세스의 출력이 포함된 디렉토리로 연결되는 경로 |
| PLASTIC_CM_PATH | Plastic CLI로 연결되는 경로. Windows 환경을 사용하는 경우 Cygwin 경로로 전환하여 경로가 유효한지 확인할 수 있음 |
| PLASTIC_CM_CONFIG_DIRECTORY | Plastic CLI 설정 파일로 연결되는 경로 |
| PLATFORM_HOST | 빌드 서비스 API의 호스트 (예: usersvc-live.cloud.unity3d.com) |
| PROJECT_DIRECTORY | 빌드할 프로젝트의 루트 디렉토리로 연결되는 경로 |
| SCM_MAX_RETRIES | 소스 코드를 체크아웃할 때 시도되는 최대 재시도 횟수 |
| UNITY_EXE | Unity 엔진 실행 파일의 위치 |
| UPM_REGISTRY | Unity 패키지 관리자의 URL |
| UPM_SERVER_ENABLED | true로 설정하면 에이전트에서 UPM 서버 시작(기본값) |
| UPM_SERVER_EXE | Unity 패키지 관리자 서버 실행 파일로 연결되는 경로 |
| UPM_SERVER_PORT | UPM 서버가 실행되는 포트 |
| USERPROFILE | OS의 사용자 홈 위치 |
| WEBGL_STREAMING_ENABLED | true로 설정하면 WebGL 프로젝트의 StreamingAssets로 연결되는 경로가 아카이브로 연결되는 경로 목록에서 제외됨(기본값) |
| WORKSPACE | 특정 빌드 타겟의 모든 폴더가 생성된 에이전트의 로컬 경로 예: /opt/workspace/workspace |
빌드
빌드 환경 변수는 빌드 실행과 관련되어 있고 이를 관리합니다. 아래는 일반적인 빌드 변수 목록입니다. 빌드 프로세스의 특정 부분 실행과 관련된 빌드 변수는 해당 섹션에 분류됩니다. Unity 빌드를 실행하기 전에 일부 변수는 설정되지 않을 수 있습니다. 이런 변수를 사용하기 전에 값을 확인하는 것이 좋습니다.
변수 | 설명 |
|---|---|
| BACKTRACE_ENABLED | ‘true’로 설정된 경우 오류 백트레이싱을 로깅하도록 설정(기본값) |
| BUILD_PLATFORM | 빌드되는 타겟 유형 |
| BUILD_TARGET | UCB 빌드 타겟의 ID |
| BUILD_REVISION | 빌드하려는 소스 코드의 현재 수정 사항 |
| BUILDCFG_FILE | 빌드 구성 파일로 연결되는 로컬 경로 |
| BUILDCFG_TARGET | 빌드되는 타겟의 이름이나 ID |
| BUILDJOB_CACHE | 빌드가 완료될 때 캐시할 파일의 유형. 기본값은 ‘라이브러리’이며, 관리 UI를 통해서만 ‘작업 공간’으로 설정할 수 있음 (전용 빌더 사용이 로컬로 설정된 경우) |
| CLEAN_BUILD | true로 설정된 경우 캐시된 라이브러리나 작업 공간을 가져오지 못함. Git를 사용하는 경우 Git 클린을 실행하며, Perforce를 사용하는 경우 p4 forcesync를 수행 |
| IS_BUILDER | 빌드 에이전트에서 실행할 때 true로 설정하며, 로컬에서 실행 시 false로 설정 |
| LOG_VERBOSE | Xcode 프로젝트에 상세 모드 옵션이 전달되면 '1'로 설정 |
| ORG_ID | UCB 조직의 ID |
| PARENT_BUILD_GUID | 이 빌드의 기본 아티팩트가 다운로드되고 다시 서명되며, 이미 빌드된 아티팩트에 다시 서명할 때만 설정 |
| PREVIOUS_SUCCESSFUL_BUILD_REVISION | 성공적으로 빌드된 타겟의 마지막 수정 사항 |
| PROJECT_ID | UCB 프로젝트의 ID |
| SCM_BRANCH | 빌드할 브랜치의 이름 |
| SCM_REVISION | 체크아웃할 특정 커밋 해시이며, 빌드 구성에 지정된 경우에만 설정 |
| SCM_HOST | 소스 관리 관리자의 호스트 URL |
| SCM_USER | SCM에서 코드를 체크아웃하기 위한 사용자 이름 |
| SKIP_UPLOAD_ARTIFACTS | '1'로 설정하면 빌드된 아티팩트의 UCB 업로드를 건너뜀 |
| UCB_BUILD_NUMBER | 빌드 중인 특정 타겟의 빌드 번호 |
| XCARCHIVE_PATH | Xcode 아카이브 파일로 연결되는 로컬 경로(예: '~/Library/Developer/Xcode/Archives/something.xcarchive) |
Cloud Content Delivery
이 변수는 빌드 구성에 따라 CCD_ENABLED가 true로 설정된 경우에만 사용할 수 있습니다.
변수 | 설명 |
|---|---|
| CCD_BUCKET_ID | 콘텐츠를 업로드할 버킷의 ID이며, 빌드 구성으로 정의됨 |
| CCD_CREATE_RELEASE | ‘true’로 설정하면 최신 버전의 버킷에서 릴리스가 생성되며, 빌드 구성으로 정의됨 |
| CCD_ENABLED | ‘true’로 설정하면 Cloud Content Delivery를 사용하며, 빌드 구성으로 정의됨 |
| CCD_PRESERVE_BUCKET | true로 설정하면 버킷의 기존 콘텐츠를 삭제하지 않으며, 빌드 구성으로 정의됨 |
| CCD_STRIP_REMOTE_PATH | ‘true’로 설정하면 버킷을 보존하고 폴더 레벨이 아닌 루트에 파일을 직접 업로드하며, 빌드 구성으로 정의됨 |
Fastlane
Fastlane 환경 변수는 Fastlane의 동작을 제어합니다.
변수 | 설명 |
|---|---|
| FASTLANE_USER | fastlane과 함께 사용할 앱 스토어 연결/Apple 개발자 포털 사용자 |
| FASTLANE_VERBOSE | ‘true’로 설정하면 트리거된 fastlane 커맨드를 실행할 때 상세 로깅이 활성화됨 |
| FL_NOTARIZE_ASC_PROVIDER | 제공자의 WWDR 팀 ID |
| FL_NOTARIZE_USE_NOTARYTOOL | Xcode 13을 사용하고 true로 설정하면 fastlane으로 공증할 때 Xcode 공증 툴 사용 |
| FL_NOTARIZE_USERNAME | fastlane과 함께 사용할 앱 스토어 연결/Apple 개발자 포털 사용자 |
Perforce
변수 | 설명 |
|---|---|
| P4_CLEANUPCLIENT | ‘true’로 설정하면 Perforce 저장소에서 코드를 체크아웃할 때 삭제 클라이언트가 실행됨 |
| P4_SSL | ‘true’로 설정된 경우 P4는 서버와 통신할 때 SSL 사용 |
| P4CLIENT | P4 SCM에 대한 작업을 수행할 때 사용할 P4 클라이언트 |
| P4PORT | P4 SCM이 실행되는 포트 |
| P4USER | P4에서 코드를 체크아웃할 사용자 이름 |
UVCS(이전 Plastic SCM)
변수 | 설명 |
|---|---|
| PLASTIC_AUTH_TYPE | Plastic SCM 인증에 사용되는 메서드 |
| PLASTIC_ENCRYPTION_METHOD | Plastic SCM의 암호화 유형 |
Unity
변수 | 설명 |
|---|---|
| MONO_XMLSERIALIZER_THS | Unity에서 Mono 빌드에 THS XML Serializer를 사용하지 않는 ‘No’로 설정 |
| UNITY_EXTRA_PARAMS | 배치 모드에서 실행할 때 Unity 에디터 전달되는 추가 파라미터 |
| UNITY_PLAYER_PATH | Unity 플레이어로 연결되는 로컬 경로 |
| UNITY_PLAYER_PATH_DATA | Windows나 Mac 빌드용 Unity 플레이어 데이터 파일로 연결되는 로컬 경로 |
| UNITY_PLAYER_PATH_DEBUG_SYMBOLS | Android 빌드용 Unity 플레이어 디버그 기호로 연결되는 로컬 경로 |
| UNITY_PLAYER_PATH_DSYM | iOS 빌드용 Unity 플레이어 디버그 기호로 연결되는 로컬 경로 |
| UNITY_SHADER_COMPILER_RETRY_COUNT | ‘3’으로 설정하며, 이 숫자는 Unity에서 셰이더를 컴파일할 때 재시도한 횟수 |
| UNITY_VERSION | 빌드가 실행될 Unity 버전 |
| UNITY_VERSION_DIFF | 이 빌드의 Unity 버전이 이전 빌드와 다른 경우 true로 설정 |
빌드 구성과 출력에 따라 동적으로 설정된 추가 환경 변수 2개가 있습니다. 이러한 작업 방식의 특성에 따라 환경 변수의 이름을 결정하는 패턴이 제공됩니다.
변수 | 설명 | 패턴 |
|---|---|---|
| UNITY_PLAYER_PATH_#{architecture} | 특정 아키텍처에 대한 Unity 플레이어 파일로 연결되는 로컬 경로 | #{architecture}는 빌드의 타겟 아키텍처에 대한 플레이스홀더 값을 나타냄 (예: 출력 아키텍처 중 하나가 x86이면 환경 변수는 UNITY_PLAYER_PATH_X86) |
| UNITY_PLAYER_PATH_#{obb_file_type}_OBB | Unity 플레이어 OBB 파일로 연결되는 로컬 경로 | #{obb_file_type}은 다양한 OBB 파일에 대한 플레이스홀더 값을 나타냅니다. (예: 파일의 이름은 example.file.obb이고 환경 변수는 UNITY_PLAYER_PATH_FILE_OBB) |