빌드 구성
Configure build settings and requirements for your Unity project using Build Automation.
읽는 시간 2분최근 업데이트: 한 달 전
빌드 구성에서는 프로젝트의 특정 빌드를 생성하기 위한 설정과 요구 사항을 정의합니다. 빌드 구성은 프로젝트가 여러 플랫폼에서 컴파일되고 패키징되고 배포를 위해 준비되는 방식을 결정하는 정형화된 설정입니다. 빌드 구성이 생성되면 이에 대해 여러 차례의 빌드 시도를 실행할 수 있습니다. 플랫폼, Unity 버전, 자격 증명 등 설정에 지정된 모든 구성이 각 빌드 시도에 자동으로 적용되어 모든 빌드에서 일관성과 재현성을 확보할 수 있습니다. 빌드 구성을 설정하려면 다음 단계를 따릅니다.
- Unity Dashboard에 로그인합니다.
- DevOps > Build automation > Configurations를 선택합니다.
필수 조건
첫 번째 빌드 구성을 설정하기 전에 프로젝트의 소스 관리 설정이 구성되었는지 확인합니다. 이 단계는 첫 번째 구성에 필요합니다. 소스 관리를 구성하려면 Get started를 선택합니다.
빌드 타겟 구성 - 소스 관리 구성
빌드 구성 흐름 선택
새 빌드 구성을 설정하려면 빠른 타겟 설정과 타겟 설정이라는 2가지 옵션이 있습니다.빠른 타겟 설정
빠른 타겟 설정을 선택하면 대시보드에 각 플랫폼에서 빌드 타겟을 구성하는 데 필요한 기본 구성이 표시됩니다. 빌드 타겟에서 고급 설정을 구성하고 싶지 않은 경우 빠른 타겟 설정을 선택합니다.
빌드 타겟 구성 - 빠른 타겟 설정
타겟 설정
타겟 설정을 선택하면 먼저 빌드 타겟을 실행하는 데 필요한 기본 설정을 구성합니다. 그런 다음 구성을 저장하거나 고급 설정으로 이동할 수 있습니다.
빌드 타겟 구성 - 고급 설정
기본 정보
Basic Info 섹션에는 빌드의 주요 설정을 정의하는 필드가 포함되어 있습니다.설정 | 설명 |
|---|---|
| 타겟 이름 | 빌드 타겟 구성의 고유한 이름을 설정합니다. |
| Branch | Build Automation에서 가져올 브랜치를 선택합니다. |
| 프로젝트 하위 폴더 경로(선택 사항) | 저장소의 루트에 없는 경우 |
| Unity 버전 | 사용하는 Unity 버전을 선택합니다. Unity 버전을 통해 빌더 운영체제와 버전, 헤드리스 모드 등 여러 고급 설정의 가용성을 관리합니다. |
| Unity 버전 자동 감지 | 프로젝트의 |
| 빌더 운영체제와 버전 | 빌드 머신의 OS와 버전을 선택합니다. 이는 플랫폼의 영향을 받습니다. 자세한 내용은 각 빌더 OS의 지원되는 플랫폼을 참고하십시오. |
| Xcode 버전(macOS 빌더만 해당) | 선택한 OS에 기본 Xcode 버전을 사용하려면 Default를 선택합니다. 이 옵션은 macOS 빌더 운영체제를 선택할 때 나타납니다. 지원되는 버전에 대한 사용 가능한 Xcode 버전 가이드를 참고하십시오. |
| Unity 에디터 아키텍처(macOS 빌더만 해당) | Silicon 기반 운영체제에서 실행되는 빌드의 Unity 에디터 아키텍처를 지정합니다. |
| Android SDK 버전(Android 빌드만 해당) | Unity 프로젝트를 빌드할 Android SDK 버전을 설정합니다. 자세한 내용은 Unity 버전에 대한 Android SDK 호환성 가이드를 참고하십시오. |
빌드 타겟 구성 - 기본 정보
빌더 구성
빌드의 머신 사양을 선택합니다. 적절한 설정은 프로젝트의 복잡도와 플랫폼 요구 사항에 따라 다릅니다. 빌더 구성에 대한 자세한 내용은 머신 사양 선택을 참고하십시오.자격 증명
Credentials 섹션에서는 Build Automation이 빌드에 서명하는 데 사용하는 자격 증명을 제공하여 빌드 아티팩트의 보안과 무결성을 보장할 수 있습니다. Android용 키스토어나 macOS용 서명 인증서와 같은 필수 자격 증명을 제공합니다.스케줄링
Scheduling 섹션에서는 빌드 트리거를 자동화하고 반복 빌드 스케줄을 설정할 수 있습니다. | 설정 | 설명 | |---|---| | 자동 빌드 | 저장소에서 변경 사항이 감지되면 빌드를 자동으로 시작합니다. | | 자동 취소 | 새 빌드가 트리거되면 보류 중인 빌드를 자동으로 취소합니다. | | 빌드 스케줄 | 주기, 날짜, 시간 등의 옵션으로 반복 빌드 스케줄을 설정합니다. | 자세한 내용은 자동 빌드 실행을 참고하십시오.Android 설정
Android를 타겟 플랫폼으로 선택하면 추가 빌드 설정을 사용할 수 있습니다. 타겟 구성의 Basic Info 섹션에서 첫 번째로 Android SDK 버전을 설정합니다. 선택한 Unity 버전에 따라 원하는 Android SDK 버전을 선택하려면 이 설정을 사용합니다. 자세한 내용은 Unity 버전에 대한 Android SDK 호환성 가이드를 참고하십시오. 나머지 Android 관련 설정은 Platform specific settings (Android) 의 Advanced Settings에 있습니다.설정 | 설명 |
|---|---|
| APK 대신 앱 번들 빌드(.aab) | Android 앱 번들은 앱의 모든 컴파일된 코드와 리소스를 포함하는 업로드 포맷으로, APK 생성과 Google Play에 대한 서명을 지체시킵니다. 또한 Gradle 빌드 시스템을 사용해야 합니다. 자세한 내용은 Android 앱 번들 기술 자료를 참고하십시오. |
| 에셋 팩 빌드 | 에셋 팩 빌드는 앱 번들을 빌드하는 경우에만 사용할 수 있습니다. 이 옵션을 활성화하면 Unity Build Automation에서 Google Play Unity 플러그인의 Google Play 빌드 메서드를 사용하여 에셋 팩으로 앱 번들을 빌드합니다. 프로젝트에 플러그인을 설치해야 합니다. 또한 사전 빌드 스크립트에서 프로그래밍 방식으로 에셋 팩을 구성하고 |
| 바이너리 애플리케이션 빌드 분할 생성 | 이 설정을 통해 |
빌드 타겟 구성 - Android 설정
유니버설 Windows 플랫폼 설정
선택한 타겟 플랫폼이 UWP(유니버설 Windows 플랫폼)인 경우 추가 빌드 설정을 사용할 수 있습니다. 이 설정을 사용하면 UWP 애플리케이션을 빌드하는 방법과 타겟 디바이스를 설정하는 방법을 세밀하게 관리할 수 있습니다. UWP 설정에 대한 포괄적인 정보는 UWP 빌드 설정 기술 자료를 참고하십시오. 타겟 설정의 Basic Info 섹션에는 다음 UWP별 옵션이 포함되어 있습니다.설정 | 설명 |
|---|---|
| Visual Studio 버전 | UWP 애플리케이션 빌드에 사용된 Visual Studio 버전을 정의합니다. Unity 2022.2 이전 버전을 사용하는 경우 이 설정과 관계없이 최신 Visual Studio 버전이 자동으로 선택됩니다. |
| Windows SDK 버전 | Visual Studio로 빌드할 때 애플리케이션이 타게팅하는 Windows SDK 버전을 설정합니다. 선택한 Visual Studio 버전에 따라 다릅니다. |
| 빌드 유형 | Unity에서 생성한 UWP 빌드 출력 유형을 결정합니다. 사용 가능한 옵션은 |
| 빌드 구성 | Visual Studio 프로젝트 출력의 최적화 레벨을 지정합니다. 옵션에는 |
| 타겟 디바이스 제품군 | 애플리케이션이 지원하는 UWP 디바이스 제품군을 정의합니다. 기본적으로 이 옵션은 |
빌드 타겟 구성 - UWP 기본 설정
설정 | 설명 |
|---|---|
| 애플리케이션 기능 | 앱에서 사용할 시스템 리소스와 기능에 대한 성능을 지정합니다. 자세한 내용은 기능 프로퍼티 기술 자료를 참고하십시오. |
| 실행 파일 전용 CPU 아키텍처 | 빌드 유형을 |
| 타겟 CPU 플랫폼 | 빌드 유형을 |
빌드 타겟 설정 - UWP 고급 설정