[UE5.1] 언리얼 엔진 5 C++ 클래스 생성 후 프로젝트 컴파일링 하기

이번 글은 유데미를 통해 언리얼5 C++ 강의를 수강하여 실습한 내용을 정리한 포스팅입니다.
영상에서 사용한 엔진은 5.0 버전을, 저는 5.1.1 버전을 이용하여 실습을 진행했습니다.

 

 

 

 컴파일러와 에디터

소스 코드 (Source Code) : 사람이 읽을 수 있는 코드  -> ex. C++
바이너리 실행 파일 : 기계가 읽을 수 있는 0과 1로 구성된 바이너리 코드
컴파일러 (Compiler) : 사람이 읽는 코드를 기계가 읽을 수 있도록 변환 과정을 맡는다.
-> ex. 비주얼 스튜디오 (윈도우 os)
-> ex. XCode (맥 os)
소스 코드 에디터 : 소스 코드를 만들 때 더 편하게 해주는 도구 -> 자동 완성 / 타이핑한 것 중 잘못된 부분 강조 표시
-> ex. 비주얼 스튜디오 코드 
-> ex. 비주얼 스튜디오 자체에도 내장된 소스 코드 에디터가 있다.

컴파일을 진행하기에 앞서 먼저, 컴파일러와 에디터에 관해 간단히 훑어보고, 포스팅을 이어 나가도록 하겠습니다.

에디터는 우리가 사용할 수 있도록 이미 구성이 되어 있는 소프트웨어를 의미합니다. 언리얼 자체에도 언리얼 에디터라는 게 존재합니다. 게임 에셋, 블루프린트 코드, 에셋 등도 언리얼 에디터에서 관리하는 느낌입니다.

하지만, C++로 프로젝트를 진행하고자 한다면 언리얼 에디터에서가 아닌 소스 코드 에디터에서 컴파일러를 거쳐 바이너리 실행 파일로 전환 후 언리얼 에디터로 넘어가는 방식을 거쳐야 합니다.

 

즉, C++ 로 소스 코드 실행 시 컴파일러에서 소스 코드와 소스 코드에서 사용한 언리얼에 내장된 라이브러리와 기능들을 가져와 모두를 바이너리로 전환 뒤 언리얼 에디터로 넘어가 플레이어가 게임을 플레이할 수 있도록 출력하는 흐름입니다.

 

 

 

 

 Visual studio 2022 와 Visual studio Code 설치 

저는 언리얼 5.1로 진행하기 위해서 Visual Studio 2022를 다운받았습니다. 

설치 과정을 모두 다루기에는 글이 너무 길어지니, 꼭 필요한 부분만 포스팅 이어 나가겠습니다.

 

설치하셨다면, C++를 사용한 게임 개발을 꼭 체크해서 설치해 주세요. 추가로 Unreal Engine 설치 관리자도 세부 정보에서 같이 체크 하셔서 설치를 이어 나가주셔야 합니다.

 

https://dotnet.microsoft.com/ko-kr/download/dotnet?cid=getdotnetcore 

.NET 다운로드(Linux, macOS 및 Windows)

UE 5.0 버전을 사용하실 때는 .NET Core 3.1을 설치하지만 5.1 버전 이상부터는 더 이상 사용하지 않아 제대로 작동을 안 한다고 합니다. 그렇기에 .NET 6.0을 설치하는 것도 참고해 주세요. 

 

 

https://code.visualstudio.com/

Visual Studio Code - Code Editing. Redefined

비주얼 스튜디오만으로도 C++ 언리얼 프로젝트를 진행하는 데 문제가 없겠지만, 비주얼 스튜디오 코드가 워낙 가볍고, 강의에서와 같은 환경을 위해 저도 Visual Studio Code를 다운받았습니다.

 

Visual Studio Code를 다운 받았다면, 확장 프로그램으로 위 2가지를 추가로 설치를 해주시면 됩니다.

 

 

 

 

 Unreal 에서 C++ 클래스 생성 이후 컴파일 진행

 

Edit -> Editor Preferences를 클릭해 주시면 위 사진과 같은 창이 뜰 것입니다. General -> Source Code를 클릭 해주시면서 각자 C++ 소스 코드 에디터를 수정해 주셔야 합니다. 저는 VSCode를 쓰기 위해 Visual Studio Code를 클릭합니다.

 

Tool -> New C++ Class를 눌러주어 C++ 클래스를 생성해주세요.

 

그런 다음, 원하는 타입의 상속받을 클래스를 생성하면 됩니다. 저는 강의를 따라 Actor 클래스를 선택했습니다.

클래스 생성만 지었다면, 아직 Content Browser에는 C++ 파일이 추가가 안 되어 있습니다. 

그렇기에 IDE (통합 개발 환경) 즉, 우리의 소스 코드 에디터에서 빌드를 한번 해주셔야 C++ 파일이 추가됩니다.

 

VSCode를 사용하신다면, Terminal -> Run Build Task 를 눌러주세요.

 

위의 사진과 같이 Development Build를 찾아 선택해 주세요. 아마 처음엔 스크롤을 좀 내려야 보일 거에요.

 

빌드가 정상적으로 되었다면, 총 빌드 시간과 아무 Key를 눌러 터미널을 창을 닫겠다는 메시지가 뜰 것입니다.

 

컴파일이 정상적으로 완료 후 Content Browser에서 아까 생성한 C++ 클래스 파일이 보이고 있습니다.  수고하셨습니다!