언리얼 엔진(UE)은 Visual Studio(VS)와 원활하게 통합되도록 설계되어, 프로젝트에서 코드를 빠르게 변경하고 컴파일 즉시 그 결과를 확인할 수 있는 수단을 제공합니다. VS를 UE와 연동되도록 구성하면 개발자의 효율과 전반적인 사용자 경험을 향상할 수 있습니다.
언리얼 엔진 - Visual Studio 워크플로를 구성하는 기본 사항에 대해서도 설명합니다.
버전 호환성
언리얼 엔진 바이너리 버전에 통합된 Visual Studio 버전 목록은 다음과 같습니다.
| 언리얼 엔진 버전 | VS 2019 버전 | VS 2022 버전 |
|---|---|---|
5.6 | 미지원 | 17.8 이상, 17.14 권장(디폴트) |
5.5 | 미지원 | 17.8 이상, 17.10 권장(디폴트) |
5.4 | 미지원 | 17.4 이상, 17.8 권장(디폴트) |
5.3 | 16.11.5 이상 | 17.4 이상, 17.6 권장(디폴트) |
5.2 | 16.11.5 이상 | 17.4 이상(디폴트) |
5.1 | 16.11.5 이상(디폴트) | 17.4 이상 |
기타 소프트웨어 버전:
| 소프트웨어 | 최소 버전 | 권장 버전 |
|---|---|---|
MSVC | 14.38.33130 | 14.38.33130 |
Windows SDK | 10.0.19041.0 | 10.0.22621.0 이상 |
LLVM | 18.1.3 | 18.1.8 |
.NET | .NET 8.0 | .NET 8.0 |
UE 필수 구성 요소 검증하기
언리얼 엔진을 에픽게임즈 런처에서 설치하거나 GitHub에서 복제하여 설치하는 경우, UE 필수 구성 요소 인스톨러가 엔진 실행에 필요한 필수 종속성, 라이브러리, 프레임워크를 자동으로 설치합니다.
Perforce에서 UE를 설치하거나 동기화하는 경우, 로컬에서 빌드한 UE 툴을 실행하기 전에 먼저 필수 구성 요소 인스톨러부터 실행해야 합니다. 인스톨러는 [UNREAL_ENGINE_ROOT]\Engine\Extras\Redist\en-us\에 있습니다.
Visual Studio 설치 옵션 추가하기
Visual Studio(VS)를 처음 설치하거나 기존 설치를 수정하는 경우, 다음 워크로드 및 컴포넌트를 활성화해야 합니다.
VS 설치를 수정하려면 Visual Studio 인스톨러를 실행한 다음 최신 버전 옆의 Modify를 클릭합니다.
필수 워크로드 추가하기
인스톨러 Workloads 탭의 Desktop & Mobile에서 다음 옵션을 활성화합니다.
.NET desktop development
Desktop development with C++
.NET Multi-platform App UI development
Gaming에서 Game development with C++를 활성화합니다.
필수 컴포넌트 추가하기
인스톨러의 Installation Details 패널에서 Game development with C++를 펼쳐서 다음 옵션을 활성화합니다.
C++ profiling tools
C++ AddressSanitizer
Windows 10 or 11 SDK (10.0.18362 or Newer)
Unreal Engine installer
VS에서 언리얼 엔진 C++ 프로젝트를 처음 열면 Solution Explorer에 컴포넌트 누락 경고가 표시될 수 있습니다. Install을 클릭하여 VS가 프로젝트에 필요한 추가 컴포넌트를 설치하도록 허용합니다.
권장 세팅
이러한 선택적 VS 인터페이스 조정으로 개발 환경을 더 편리하게 만들 수 있습니다.
오류 목록 창 끄기
일반적으로 Error List 창은 코드에 오류가 있으면 자동으로 열립니다. 하지만 UE로 작업할 때는 오류 목록 창에 근본 원인을 파악하기 어려운 다운스트림 오류가 추가적으로 표시될 수 있습니다. UE로 작업할 때는 Error List 창을 비활성화하고 출력 로그(Output Log)를 사용하여 실제 코드 오류를 확인할 수 있습니다.
Error List 창을 끄는 단계는 다음과 같습니다.
VS에서 Tools > Options로 이동합니다.
Options 창 왼쪽에서 Projects and Solutions를 선택합니다.
Always show Error List if build finished with errors를 비활성화합니다.
(선택 사항) 아래 테이블에서 프로젝트와 관련된 기타 옵션 및 기능을 변경합니다.
OK를 클릭합니다.
| 변경 후: | 옵션에서 이동할 위치: | 변경할 옵션: |
|---|---|---|
텍스트 에디터에서 코드 청크가 회색으로 표시되는 것을 방지합니다. | Text Editor > C/C++ > View | Show Inactive Blocks를 False로 설정 |
Solution Explorer에서 불필요한 폴더를 숨깁니다. | Text Editor > C/C++ > Advanced | Disable External Dependencies Folders를 True로 설정 |
IntelliSense(코드 완성, 제안, 그리고 코드를 작성할 때 자동 코드 포맷팅 기능)를 활성화합니다. | Text Editor > C/C++ > IntelliSense | Enable 64-bit IntelliSense 활성화 |
Solution Configurations 드롭다운 메뉴 폭 늘리기
VS 툴바의 Solution Configurations 드롭다운을 펼치면 커스텀 환경설정의 전체 이름을 확인 가능하므로 유용할 수 있습니다.
Solution Configurations 메뉴를 펼치는 단계는 다음과 같습니다.
Visual Studio에서 메인 툴바를 우클릭하고 컨텍스트 메뉴 하단에서 Customize를 선택합니다.
Customize 창에서 Commands 탭을 클릭하고 Toolbar 라디오 버튼을 선택한 다음 드롭다운 메뉴를 사용하여 Toolbar를 Standard로 변경합니다.
툴바 Preview에서 옵션을 스크롤하여 Solution Configurations를 찾아 선택한 다음 Modify Selection을 클릭합니다.
Width를 200으로 변경하고 OK를 클릭합니다. VS가 툴바를 새로운 크기로 업데이트합니다.
Customize 창을 닫습니다.
Solution Platforms 드롭다운 메뉴 추가하기
여러 플랫폼을 대상으로 개발할 때는 VS 툴바에 Solution Platforms 드롭다운 메뉴가 있으면 편리합니다.
Solution Configurations 드롭다운 오른쪽에 이 메뉴가 보이지 않으면 Standard 툴바의 오른쪽에 있는 작은 화살표 버튼을 클릭하고 Add or Remove Buttons로 이동한 다음 Solution Platforms를 선택하여 추가할 수 있습니다.
