Visual Studio 구성하기

언리얼 엔진 은 Visual Studio 와 원활하게 통합되도록 설계되어, 프로젝트에서 코드를 빠르고 쉽게 변경하고 컴파일 즉시 그 결과를 확인할 수 있습니다. 언리얼 엔진과 함께 작동하도록 Visual Studio 를 구성하면 개발자의 효율과 전반적인 사용자 환경을 향상시킬 수 있습니다.

언리얼 엔진 - Visual Studio 워크플로를 구성하는 기본 사항에 대해서도 설명합니다.

버전 호환성

언리얼 엔진 바이너리 버전에 통합된 Visual Studio 버전 목록은 다음과 같습니다.

UE 5.1부터는 최신 버전을 지원하는 플랫폼 SDK를 설치한 경우 언리얼 빌드 툴(Unreal Build Tool, UBT) 에서 설치된 Visual Studio의 최신 버전에 맞는 Visual Studio 솔루션 파일을 생성합니다. 이 경우 UBT는 해당 플랫폼 SDK를 지원하는 Visual Studio의 최신 버전에 대한 Visual Studio 솔루션 파일을 생성합니다.

UE 5.2부터는 VS 2022가 언리얼 엔진 컴파일을 위한 디폴트 Visual Studio 버전이 됩니다.

UE 5.2용 플러그인을 사전 컴파일링할 경우 VS 2019를 사용하여 플러그인을 컴파일하는 것을 권장합니다. 이렇게 하면 VS 2019 또는 VS 2022를 사용하는 모든 사용자가 해당 플러그인을 사용할 수 있습니다. 플러그인에 대한 자세한 내용은 플러그인 문서를 참조하세요.

언리얼 엔진 필수 구성 요소 인스톨러

에픽 런처 또는 GitHub 복제를 통해 언리얼 엔진을 설치하는 경우 UE 필수 구성 요소 인스톨러가 자동으로 실행됩니다. 하지만 Perforce에서 언리얼 엔진을 설치 또는 동기화하는 경우, 수동 실행해야 합니다. 로컬에서 빌드한 UE 툴을 사용하기 위해서는 필수입니다. 이 인스톨러는 코드 베이스의 UNREAL_ENGINE_ROOT\Engine\Extras\Redist\en-us\ 에 있습니다.

새 Visual Studio 설치 옵션

Visual Studio 를 처음 설치하는 경우, 다음 옵션을 활성화해야 합니다.

Visual Studio Workloads

VS를 사용한 언리얼 엔진 개발 시 다음 Workloads 옵션을 설치해야 합니다.

• .NET desktop development
• Desktop development with C++
• Universal Windows Platform development
• Game development with C++

C++ 툴

C++ 툴을 Visual Studio 설치에 추가하려면, Workloads 아래 Game development with C++ 와 다음 옵션을 선택합니다.

• C++ profiling tools
• C++ AddressSanitizer
• Windows 10 SDK (10.0.18362 or Newer)
• Unreal Engine installer

권장 세팅

다음은 언리얼 엔진에서 Visual Studio를 사용하는 개발자에게 권장되는 세팅입니다.

아래 VS 버전이 약간 다르게 보인다면 테마가 Dark 로 변경되어 있기 때문입니다. Tools > Options > Environment > General > Color theme 에서 설정할 수 있습니다.

솔루션 구성의 드롭다운 메뉴 폭 늘리기

1. VS를 시작합니다. VS를 처음으로 연다면 Get Started 창이 나타납니다. Continue without code 를 클릭합니다.

   이미지를 확대하려면 클릭하세요.

2. 툴바에 우클릭하면 나타나는 메뉴 하단의 Customize 를 선택합니다.

   이미지를 확대하려면 클릭하세요.

3. Commands 탭을 클릭하고 Toolbar 라디오 버튼을 선택합니다.
   

4. Toolbar 옆 드롭다운에서 Standard 를 선택합니다.
   

5. Preview 목록에서 Solution Configurations 컨트롤을 선택하고 Modify Selection 을 선택합니다. 스크롤을 내려야 할 수도 있습니다.

6. Width 를 200 으로 설정하고 OK 를 클릭합니다.
   

7. Customization 에서 Close 를 클릭합니다. 툴바가 바로 업데이트됩니다.

솔루션 플랫폼 드롭다운 추가

1. Standard 툴바에서 가장 오른쪽 버튼을 찾습니다 (마우스 커서를 올리면 Standard Toolbar Options 라고 표시됩니다).

2. 드롭다운 버튼을 클릭하고 Add or Remove Buttons 를 선택한 뒤 Solution Platforms 를 클릭하면 메뉴가 툴바에 추가됩니다.

오류 목록 창 끄기

일반적으로 Error List (오류 목록) 창은 코드에 오류가 있으면 자동으로 뜹니다. 하지만 언리얼 엔진에서 사용할 때는 오류 목록 창에 잘못된 오류 정보가 표시될 수 있습니다. 오류 목록 창을 비활성화하고 언리얼 엔진 출력 창의 실제 코드 오류를 확인하는 것이 가장 좋습니다. 다음 단계는 오류 목록 창을 끄는 방법을 보여줍니다.

1. 오류 목록 창이 열려 있다면 닫습니다.

2. Tools 메뉴에서 Options 대화창을 엽니다.
   

3. Projects and Solutions 를 선택하고 Always show Error List if build finishes with error 체크를 해제합니다.
   

4. OK 를 클릭합니다.

다음은 유용한 기타 구성 설정입니다.

• Show Inactive Blocks 를 끕니다. 끄지 않으면 텍스트 에디터에 너무 많은 코드 청크가 회색으로 표시될 수 있습니다. 이 설정은 Tools > Options > Text Editor > C/C++ > View 에서 끕니다.

• Disable External Dependencies Folders 를 true 로 설정하면 Solution Explorer 에서 불필요한 폴더를 숨길 수 있습니다. 이 옵션은 Tools > Options > Text Editor > C/C++ > Advanced 에서 찾을 수 있습니다.

• Edit & Continue 기능이 필요 없으면 끕니다. Tools > Options > Debugging > Edit and Continue 에서 작업할 수 있습니다.

• IntelliSense를 켭니다.