UnrealVS 익스텐션 | 언리얼 엔진 5.0 문서

Visual Studio 용 UnrealVS 익스텐션으로 언리얼 엔진으로 개발할 때 자주 쓰는 기능을 쉽게 접할 수 있습니다. 익스텐션을 설치하고 프로젝트에 사용하는 방법을 설명합니다.

포함된 기능:

Startup Project 설정
Startup Project 빌드에 바인딩 가능한 명령
명령줄 인수 설정
프로젝트 배치 빌드
'퀵 빌드' 프로젝트 메뉴.

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

설치와 셋업

UnrealVS 익스텐션 설치를 위해서는:

디스크의 UnrealVS.vsix 파일을 찾습니다:

[UE4RootLocation]/Engine/Extras/UnrealVS/<VS-Version>/UnrealVS.vsix
UnrealVS.vsix 파일을 더블클릭하여 설치를 시작합니다.
UnrealVS 익스텐션이 특정 Visual Studio 버전을 대상으로 삼습니다. 인스톨러가 올바른 버전을 대상으로 삼는지, 박스가 체크되어 있는지 확인한 다음 설치 버튼을 눌러 계속합니다.
설치가 끝나면 닫기 버튼을 누릅니다.
Visual Studio 를 실행시키고, Tools >Extensions and Updates... 에서 익스텐션을 확인할 수 있을 것입니다

Visual Studio 가 이미 실행중이라면 재시작을 해야 익스텐션이 로드되어 표시될 것입니다. 익스텐션은 Help > About Microsoft Visual Studio 대화창의 Installed Products 목록에도 표시됩니다.
View > Toolbars 또는 Visual Studio 툴바 영역에 우클릭한 다음 UnrealVS 를 선택하여 익스텐션의 툴바를 표시합니다.
기본적으로 툴바는 위와 같이 나타나나, Tools > Customize... 에서 Commands 탭의 UnrealVS 툴바를 선택하여 입맛대로 맞출 수 있습니다.
Customize 대화창에서 Add Command... 를 선택한 다음 Categories 목록에서 UnrealVS 를 선택하면 툴바에 추가할 수 있는 UnrealVS 명령 목록이 나타납니다. 명령 추가를 완료하면 확인 을 클릭하세요.

스타트업 프로젝트 설정

Startup Project 드롭다운으로 Startup Project 간의 전환이나 세팅을 빠르게 할 수 있습니다. 솔루션에서 실행파일을 빌드하는 데 사용할 수 있는 게임 프로젝트가 자동으로 모두 나열됩니다. 목록에서 프로젝트를 선택하면 그것이 현재 스타트업 프로젝트로 설정됩니다.

UnrealVS 옵션에서 나열되는 프로젝트를 변경할 수 있습니다. Game 프로젝트만 보이려면, Tools > Options... 에서 UnrealVS 를 선택하면 됩니다. Hide Non-Game Startup Projects (게임이 아닌 시작 프로젝트 숨김) 옆 드롭다운을 클릭하고 True 를 선택합니다. 그리고 확인 을 클릭합니다..

스타트업 프로젝트 빌드

익스텐션에는 현재 Startup Project 빌드 기능을 단축키나 다른 커스텀 실행 방법에 지정하는 명령도 포함되어 있습니다.

단축키에 지정하는 방법

Tools > Options... 대화창에서 Environment 트리 아래 Keyboard 를 선택합니다. Apply the following additional keyboard mapping scheme 아래 드롭다운을 클릭하고 Visual C++ 6 을 선택합니다.
목록에서 UnrealVS.BuildStartupProject 명령을 선택합니다.

검색창에 "UnrealVS" 를 입력하여 걸러낼 수 있습니다.
명령을 선택한 상태로 Press Shortcut Keys 박스에 클릭한 다음 명령을 실행시키는 데 사용할 키 조합을 입력합니다. 예제에서는 Ctrl + Alt + Shift + B 가 표시되어 있습니다.

이미 다른 명령에 할당되지 않은 키 조합을 선택해야 합니다. 입력한 키 조합이 이미 사용중이면 Shortcut currently used by 박스에 경고가 뜹니다.
할당 버튼을 눌러 명령에 키를 지정합니다. 지정된 키는 Shortcuts for selected command 박스에 표시됩니다.
OK 버튼을 눌러 변경내용을 저장합니다. 이제 그 단축키를 사용하면 Startup Project 로 설정된 프로젝트가 자동 빌드됩니다.

단일 소스 파일 반복처리

Visual Studio 에서 Ctrl+F7 을 사용하는 단일 소스 (.cpp) 파일에 대한 업데이트 반복처리에 익숙한 경우 , Ctrl+F7 에 UnrealVS.CompileSingleFile 명령을 바인딩하면, 현재 솔루션 구성, 플랫폼, -singlefile = <현재 열려있는 파일의 경로> 인수를 사용하여 활성 프로젝트를 빌드할 수 있습니다.

명령줄 인수

Command-Line (명령줄) 컨트롤은 디버깅 세션에서 실행하는 현재 프로젝트에 대한 Command Arguments (명령줄 인수)를 설정하는 데 사용됩니다. 프로젝트 Properties 를 통해 설정하는 데 대한 단축키 역할을 합니다. 사실상, 여기에 가한 변경은 Properties 에도 자동 반영됩니다.

텍스트 박스에 인수를 입력하거나, 드롭다운 목록 중 최근의 인수 목록에서 선택합니다. 그러면 디버깅 세션이 시작될 때 실행파일에 그 인수가 전달됩니다.

언리얼 에디터를 빌드하는 게임 프로젝트에 대한 프로젝트 환경설정, 에디터 실행파일이 사용중인 프로젝트를 알 수 있도록 명령줄에 프로젝트 이름이 자동으로 붙습니다. 예를 들어 Debug Editor 환경설정을 사용하여 QAGame 을 빌드하는 경우, 명령줄에 인수를 별도로 입력해 주지 않아도 QAGame.uproject 인수가 자동으로 붙습니다. QAGame 에 대한 에디터를 실행하려는 경우, Command-Line 컨트롤을 비워둬도 에디터는 어느 프로젝트를 실행중인지 알 것입니다.

사용가능한 인수 전체 목록은 문서를 참고해 주시기 바랍니다.

프로젝트 새로고침

프로젝트 파일은 Visual Studio 에서 IDE의 프로젝트 파일 를 사용하여 생성할 수 있습니다. 모든 프로젝트 파일 동기화와 업데이트 작업이 훨씬 빨라지는데, .bat 파일을 수동으로 찾아서 실행해 줄 필요가 없어지기 때문입니다.

프로젝트 파일을 새로고치려면:

UnrealVS 툴바의 프로젝트 새로고침 버튼을 누릅니다.
프로젝트 생성 프로세스 진행과정이 출력 창에 표시됩니다.
창에 뜬 대로 필요한 프로젝트를 다시 로드합니다.

배치 빌더

UnrealVS Batch Builder 로 일정한 세트의 빌드 잡을 만들어 실행시킬 수 있습니다. Visual Studio 의 Build > Batch Build... 옵션보다 다용도입니다.

배치 빌더 창을 열려면:

UnrealVS 툴바의 배치 빌더 버튼을 누르거나 UnrealVS.BatchBuilder 명령에 할당시킨 키보드 단축키를 누릅니다. (UnrealVS 명령에 키보드 단축키를 설정하는 방법은 위의 스타트업 프로젝트 빌드 부분을 참고하세요).
UnrealVS 배치 빌더 창이 나타납니다.
- Project, Config, Platform 을 선택하고 원하는 잡 유형의 동글 버튼을 클릭해서 Build Job (빌드 잡)을 생성합니다.
- > 및 < 버튼으로 잡을 추가/제거합니다.
- Build Jobs (빌드 잡) 목록에서, 오른쪽 화살표 버튼으로 선택된 잡을 목록에서 위아래 이동합니다.
- Build Jobs (빌드 잡) 목록 아래 드롭다운에서 편집하려는 Job Set (잡 세트)를 선택합니다.
- 새 Job Set (잡 세트)를 만들려면, 필드에 새 이름을 입력합니다.
- Delete (삭제) 버튼은 목록에서 선택된 Job Set (잡 세트)를 삭제합니다.
- Start (시작) 버튼으로 현재 잡 세트에 배치 빌드 작업을 시작 또는 중지 합니다.
- 잡 세트는 .suo 파일에 저장되어 다음 번 솔루션을 로드할 때 사용됩니다.
Start (시작)을 클릭하면 Output (출력) 탬에 배치 빌드 진행률이 표시됩니다.

실행중인 세트의 Build Jobs (빌드 잡)이 출력 목록에 표시됩니다. 현재 실행중인 빌드 잡은 굵게 표시됩니다.
- = 대기중인 잡
- = 잡 완료, 성공함
- = 잡 실패
- = 잡 취소
배치 빌드가 실행중일 때는 바쁨 애니메이션과 Stop (중지) 버튼이 표시됩니다.
출력 탭의 항목을 더블클릭하거나 우클릭한 다음 컨텍스트 메뉴에서 Show Output 을 선택하면 개별 Build Jobs 에서의 출력을 확인할 수 있습니다.

개별 항목에 대한 Batch Builder 출력 표시는 Visual Studio Output 창에서 UnrealVS - BatchBuild 라는 이름의 패널에 표시됩니다. 현재/지난 빌드 잡의 출력을 표시하는 Build 패널과 혼동을 피하기 위함입니다.

퀵 빌드 메뉴

Quick Build 메뉴에는 메인 솔루션 빌드 환경설정을 바꾸지 않고도 다른 환경설정과 플랫폼 조합으로 프로젝트를 쉽게 빌드할 수 있는 방법이 제공됩니다.

Solution Explorer 에서 Project 노드에 우클릭합니다.
UnrealVS Quick Build 메뉴에는 언리얼 엔진 솔루션에서 사용가능한 플랫폼과 빌드 환경설정에 대한 서브메뉴가 들어있습니다.
항목을 선택하여 선택된 프로젝트, 플랫폼, 환경설정으로 빌드합니다. IDE 에서 Solution Configuration 과 Solution Platform 을 바꾸고 빌드를 시작시킨 다음 원래대로 다시 설정하는 것보다 훨씬 빠릅니다.

UnrealVS 소스 코드 작업하기

UnrealVS 소스 코드는 [UE4Root위치]/Engine/Source/Programs/UnrealVS/ 폴더에 있습니다.

Visual Studio 로 UnrealVS 프로젝트 파일을 로드하기 위해서는, UnrealVS 를 컴파일할 적합한 버전의 Visual Studio 에 맞는 Visual Studio SDK 가 설치되어 있어야 합니다. 예를 들어 Visual Studio 2015 까지 지원하려면 Visual Studio 2015 SDK 를 설치한 다음, Visual Studio 2015 에 UnrealVS 프로젝트 파일을 로드해 줘야 합니다.