언어:
페이지 정보
태그:
수준별:
엔진 버전:
언리얼 엔진

UE4 용 Visual Studio 셋업하기

언리얼 엔진

언리얼 엔진 4 는 Visual Studio 2013 에 매끄럽게 통합되도록 디자인되어 있습니다. 이를 통해 빠르고 쉽게 프로젝트의 코드를 변경하고 그 컴파일 결과를 바로 확인할 수 있습니다. 언리얼 엔진 4 에 돌아가도록 Visual Studio 구성을 해 두면 언리얼 엔진 4 를 사용하는 개발자들의 전체적인 사용감과 효율을 향상시키는 데 도움이 됩니다.

이 문서에서는 UE4 에서 VS2013 작업방식 셋업 기초에 대해서도 다루겠습니다.

UE4-to-VS 작업방식 구성 전

Visual Studio 2015 (VS2015) 가 C++ 툴을 기본으로 설치하지 않도록 하는 것이 좋습니다. VS2015 설치시 Custom 설치를 선택한 뒤 작업방식에 필요한 C++ 컴포넌트를 선택하십시오. Visual Studio 2015 를 이미 설치한 상태라면, File > New > Project > C++ 로 C++ 를 설치합니다.

다음 표는 UE4 바이너리 버전과 통합된 Visual Studio 버전을 나타냅니다.

언리얼 엔진 버전

Visual Studio 버전

4.15 이상

VS2017

4.10 부터 4.14

VS2015

4.2 부터 4.9

VS2013

(GitHub 나 P4 에서 구할 수 있는) UE4 오픈 소스 버전은 VS2013 과 통합되어 있습니다. 또한, UE4 초기 버전도 Visual Studio 예전 버전과 통합되어 있는데, 여기서는 다루지 않습니다.

추천 세팅

언리얼 엔진 4 와 Visual Studio 를 사용하는 개발자에게 추천하는 세팅은 다음과 같습니다.

  1. Solution Configurations (솔루션 구성) 드롭다운 메뉴의 폭을 다음과 같이 넓힙니다:

    1. 툴바에 우클릭하여 뜨는 메뉴 하단에서 Customize (사용자 지정)을 선택합니다.

      SelectingCustomize.png

    2. Commands (명령) 탭을 선택합니다.

      ClickCommandsTab.png

    3. Toolbar (도구 모음) 동글 버튼을 선택합니다.

      SelectToolbarRadioButton.png

    4. Toolbar (도구 모음) 옆의 드롭다운에서, Standard (표준)을 선택합니다.

      SelectStandard.png

    5. 아래 Controls (컨트롤) 목록에서, Solution Configurations (솔루션 구성) 컨트롤을 선택합니다.

      SelectSolutionConfigControl.png

    6. 오른편의 Modify Selection (선택 사항 수정)을 선택합니다.

      ClickModifySelection.png

    7. Width (너비)를 200 으로 설정합니다.

      SetWidth_200.png

    8. Close (닫기)를 선택합니다. 툴바가 즉시 업데이트됩니다.

      ClickClosetoUpdateToolbar.png

  2. 솔루션 플랫폼 드롭다운을 추가 방법은 다음과 같습니다:

    1. 표준 툴바 가장 오른쪽의 버튼을 누르면, 도구 모음에 단추를 추가하고 제거할 수 있는 드롭다운 메뉴가 열립니다.

      SelectDropDownButton.png

    2. 드롭다운 버튼을 클릭하고, Add or Remove Buttons (단추 추가/제거) 에 커서를 올린 다음, Solution Platforms (솔루션 플랫폼)을 클릭하여 도구 모음에 메뉴를 추가합니다.

      SelectSolutionPlatforms.png

  3. Error List (오류 목록) 창을 비활성화시킬 것을 추천합니다. 전형적으로 코드에 문법 오류가 날 때마다 Error List (오류 목록) 창이 뜹니다. 그러나 언리얼 엔진 작업을 할 때는, 오류 목록 에 잘못된 오류 정보가 나타날 수 있습니다. 이 창은 비활성화시키고, 출력 창을 통해 실제 오류만 확인하는 것이 최선입니다. 오류 목록 창을 끄는 방법은 다음과 같습니다:

    1. Error List (오류 목록) 창이 열려있으면 닫습니다.

    2. Tools (도구) 메뉴에서 Options (옵션) 대화창을 엽니다.

      OpenOptionsDialog.png

    3. Projects and Solutions (프로젝트 및 솔루션)을 선택한 다음 Always show Error List if build finishes with error (오류로 인해 빌드가 종료될 때 항상 오류 목록 표시) 체크를 해제합니다.

      UncheckErrorsListOption.png

    4. OK (확인)을 클릭합니다.

다음과 같은 구성도 해 주면 좋습니다:

  • Show Inactive Blocks 를 끕니다. 그리 하지 않으면 다수의 코드 덩어리가 텍스트 에디터에서 회색으로 빠져 보입니다. (Tools > Options > Text Editor > C/C++ > View).

  • 솔루션 익스플로러의 External 폴더는 화면만 어지럽히니 그냥 끕니다. (Tools > Options > Text Editor > C/C++ > Advanced 에서 Disable External Dependencies Folder)

  • 불필요한 Edit & Continue 기능을 끕니다. (Tools > Options > Debugging > Edit and Continue--)

  • IntelliSense 를 켭니다. (Intellisense 참고)

Visual Assist X 사용자

Visual Assist X 가 설치되어 있다면:

  • Format After Paste 를 끕니다 (VAssistX > Visual Assist X Options > Advanced > Corrections). 이 옵션을 끄지 않으면, Visual Assist X 는 자동으로 소스 코드 포맷을 적용하여, 문서의 포맷이 잘못될 수 있습니다.

Visual Studio 2017 사용자

Visual Studio 를 처음 설치하는 경우, 다음 옵션이 켜져있는지 확인하는 것이 좋습니다.

UE4 인스톨러 포함

다음 옵션은 Visual Studio 2017 을 설치할 때 UE4 인스톨러도 같이 다운로드합니다.

VS2017_SettingsInstaller.png

UE4 인스톨러 없이

다음 옵션은 Visual Studio 2017 을 설치할 때 UE4 인스톨러를 다운로드하지 않습니다.

VS2017_SettingsNoInstaller.png

Intellisense, Live Errors, Squiggles

이제 UE4 프로젝트에 IntelliSense 가 제대로 지원되며, 라이브 Error List 와 "squiggles" 도 물론입니다! (켜는 법에 대해서는 아래 참고)

IntelliSense 는 입력과 동시에 C++ 를 리컴파일합니다. VAX 의 문법 검사 기능만 있는 것보다는 훨씬 강력한데요, 코드 한 줄 한 줄 확인하는 C++ 컴파일러를 사용하기 때문입니다. 엄청난 기능이라 작업방식 속도를 크게 올려줄 것입니다!

VC++ Intellisense Squiggles

squiggles 와 함께 Error List 에 살펴보는 파일에 대한 IntelliSense 오류도 볼 수 있습니다. 이 기능은 Error List 의 우클릭 메뉴에서 껐다 켰다 할 수 있습니다.

Error List

Squiggles 는 UE4 프로젝트에 작동하지 않던 것이라 이미 껐을 수도 있습니다. C/C++ Advanced 탭을 쳐서 아래와 같은 세팅이 되어 있는지 확인하시기 바랍니다.

VC++ Advanced Options

C++ 파일을 열 때, 이 아이콘을 살펴보면 IntelliSense 컴파일러가 "작업중" 이라는 것을 알 수 있습니다:

Intellisense 진행상황 표식

구현 세부사항

  • 코드를 편집시 가끔은 Squiggles 가 나타나는 데 몇 초 걸릴 수 있습니다.

    • 그 이유는 그저 include 파일이 엄청 많고, IntelliSense 가 현재 PCH 를 사용하지 않기 때문입니다.

  • 가끔 "가긍정" IntelliSense 오류가 납니다. 이유는 여러가지 있을 수 있습니다.

    • IntelliSense 컴파일러 (EDG) 가 MSVC 컴파일러보다 엄격한 경우

    • 일부 #define 이 평소 빌드시와는 달리 IntelliSense 에 대해 다르게 셋업된 경우

    • IntelliSense 가 컴파일한 것은 항상 32 비트로 취급된 경우

  • 코드를 #ifdef __INTELLISENSE__ 로 둘러싸서 필요한 경우 Squiggles 를 없앨 수도 있습니다.

  • IntelliSense 오류 문구는 VC++ 컴파일러 오류와 약간 다르게 되어 있습니다. 그냥 그렇습니다.

  • 헤더 파일의 Squiggles 는 헤더를 포함하는 알려진 .cpp 에 대해 헤더를 컴파일하는 식으로 작동합니다.

    • 가끔 IntelliSense 가 이 작업을 망치면 헤더에 Squiggles 가 보입니다.

  • (위에 표시된) Max Cached Translation Units 세팅이 있으며, 원한다면 올릴 수 있습니다.

    • 메모리 사용량은 늘어나지만 반응속도가 약간 향상됩니다.

  • 아직 IntelliSense 와 호환되지 않는 C++ 파일이 조금 있습니다.

  • Unreal Build Tool 에 -IntelliSense 옵션이 새로 생겼습니다.

    • 모든 프로젝트 파일에 대한 IntelliSense 프로퍼티 시트를 뱉어내는 옵션입니다.

    • 새로운 모듈이 추가됐을 때나 프로젝트 인클루드가 변경되었을 때만 다시 실행시켜 주면 됩니다.

UnrealVS 익스텐션

Visual Studio 용 UnrealVS 익스텐션으로 언리얼 엔진으로 개발할 때 자주 쓰는 기능을 쉽게 접할 수 있습니다.

unrealvs_toolbar_cmd.png

포함된 기능:

  • Startup Project 설정.

  • Startup Project 빌드에 바인딩 가능한 명령.

  • 명령줄 인수 설정.

  • 프로젝트 뱃치 빌드.

  • '퀵 빌드' 프로젝트 메뉴.

UnrealVS 익스텐션은 Visual Studio 2013 Express 버전에서 작동하지 않습니다. Visual Studio 2013 Community 와 Professional 버전에서만 호환됩니다.

익스텐션 셋업과 사용법에 대해서는 UnrealVS 익스텐션 문서를 참고해 주시기 바랍니다.

디버깅

Visual Studio 에는 visualizer 로 디버거를 확장하는 기능이 지원되어, FName 이나 동적 배열처럼 흔한 언리얼 유형을 쉽게 조사할 수 있습니다.

Visual Studio 2013 용 UE4 비주얼라이저 설치

UE4 비주얼라이저 설치는 두 단계로 이루어집니다.

  1. 설치의 일부로 포함된 비주얼라이저 로직이 들어있는 파일을 찾습니다:

    • [UE4Root]/Engine/Extras/VisualStudioDebugging/UE4.natvis

  2. UE4.natvis 파일을 다음 위치 중 한 곳에 복사합니다:

    • [VisualStudioInstallPath]/Common7/Packages/Debugger/Visualizers/UE4.natvis

    • [UserProfile]/My Documents/Visual Studio 2013/Visualizers/UE4.natvis

Visual Studio 인스톨 디렉토리에 파일을 복사하기 위해서는 관리자 권한이 필요할 수 있습니다.

태그