본문으로 건너뛰기

안동민 개발노트

본문 시작

개발 환경 설정

Epic Games Launcher와 Visual Studio에 C++ 개발 도구를 설치하고 엔진 연동 상태를 검증합니다.

이제 언리얼 엔진을 설치하고 C++ 개발 환경을 구성할 차례입니다.

아래 절차를 순서대로 진행하면 설치와 연동을 안정적으로 완료할 수 있습니다.

언리얼 C++ 개발 환경은 첫 코드 반영까지 이어져야 완성된다

설치 목록이 아니라 엔진, 컴파일러, 프로젝트, 에디터가 같은 소스를 주고받는 연결을 검증한다.

  1. Launcher

    학습 프로젝트와 맞는 UE5 엔진 버전을 설치한다.

  2. Toolchain

    MSVC, Windows SDK, C++ 게임 개발 워크로드를 갖춘다.

  3. C++ Project

    Source 폴더와 모듈이 있는 Blank 프로젝트를 만든다.

  4. Build

    IDE에서 컴파일해 에디터가 읽을 바이너리를 만든다.

  5. Reflect

    새 C++ 클래스와 속성이 에디터에 보이는지 확인한다.


에픽게임즈 런처를 이용한 손쉬운 방법

개발 환경은 엔진, IDE, 툴체인, 첫 빌드가 이어질 때 완성된다

설치 목록을 채우는 것이 아니라 같은 프로젝트를 엔진과 컴파일러가 함께 빌드하게 연결하는 일이다.

단계확인할 것실패 신호
Launcher프로젝트와 맞는 언리얼 엔진 버전엔진 버전과 프로젝트 버전이 다르다
IDEVisual Studio와 C++ 게임 개발 워크로드솔루션은 열리지만 컴파일러가 없다
ProjectC++ 템플릿, Source 폴더, 모듈 파일Blueprint 프로젝트로 시작해 코드 구조가 없다
Build첫 컴파일과 에디터 실행경로, SDK, include 오류가 나온다

언리얼 엔진은 에픽게임즈 런처(Epic Games Launcher)를 통해 가장 쉽게 설치하고 관리할 수 있습니다.

이미 에픽게임즈 계정이 있으시다면 로그인만 하면 되고, 아직 없다면 에픽게임즈 웹사이트에서 간단하게 생성할 수 있습니다.

에픽게임즈 런처 다운로드 및 설치: 가장 먼저 에픽게임즈 공식 웹사이트(www.epicgames.com)에 접속하여 에픽게임즈 런처를 다운로드하고 설치하세요.

설치 과정은 일반적인 소프트웨어 설치와 동일하게 진행됩니다.

에픽게임즈 런처 실행 및 로그인: 설치가 완료되면 런처를 실행하고 에픽게임즈 계정으로 로그인합니다.

언리얼 엔진 탭으로 이동: 런처 좌측 메뉴에서 언리얼 엔진 탭을 클릭하세요.

엔진 버전 설치: 라이브러리 탭을 클릭한 다음, 우측 상단의 주황색 엔진 버전 추가 버튼을 클릭합니다.

최신 버전을 포함하여 설치 가능한 언리얼 엔진 버전 목록이 표시됩니다.

이 책에서는 언리얼 엔진 5를 기준으로 설명합니다.

가급적 최신 언리얼 엔진 5 버전을 선택하고 설치 버튼을 클릭합니다.

설치 경로는 기본값을 유지하는 것이 좋습니다.

옵션 버튼을 클릭하면 함께 설치할 구성 요소를 선택할 수 있는데, C++ 개발을 위해서는 반드시 Starter Content (시작 콘텐츠)는 선택 사항이지만 설치를 권장합니다.

초반 학습에 유용하며, Editor Symbols for Debugging (디버깅용 에디터 심볼)은 디버깅 시 유용하므로 용량이 허락한다면 설치하는 것이 좋습니다.

하지만 필수는 아닙니다.

필요한 구성 요소를 선택했다면 설치를 진행합니다.

언리얼 엔진은 용량이 매우 크기 때문에 설치에 상당한 시간이 소요될 수 있습니다.


비주얼 스튜디오 설치: C++ 개발의 필수 도구

언리얼 엔진 C++ 개발을 위해서는 마이크로소프트 비주얼 스튜디오(Microsoft Visual Studio)라는 통합 개발 환경(IDE)이 필요합니다.

Visual Studio는 언리얼 C++ 프로젝트에서 코드 작성, 디버깅, 빌드 구성을 관리하는 IDE입니다.

비주얼 스튜디오 다운로드: 마이크로소프트 공식 웹사이트(visualstudio.microsoft.com)에 접속하여 Visual Studio Community 버전을 다운로드합니다.

Community 버전은 개인 개발자나 소규모 팀에게 무료로 제공됩니다.

비주얼 스튜디오 설치 및 워크로드 선택: 다운로드한 설치 파일을 실행합니다.

설치 관리자가 실행되면, 언리얼 엔진 개발을 위해 다음 워크로드를 반드시 선택해야 합니다.

  • C++를 사용한 데스크톱 개발: 기본적인 C++ 개발 도구를 포함합니다.
  • 게임 개발용 C++: 언리얼 엔진 개발에 필요한 추가적인 구성 요소를 포함합니다. 이 워크로드를 선택하면 설치 세부 정보 섹션에서 Unreal Engine 설치 관리자 항목이 자동으로 선택되는 것을 확인할 수 있습니다. 이 항목이 반드시 체크되어 있어야 합니다.

이 외에도 필요에 따라 다른 워크로드를 선택할 수 있지만, 위 두 가지는 필수입니다.

선택이 완료되면 설치 버튼을 클릭하여 설치를 진행합니다.

이 역시 상당한 시간이 소요될 수 있습니다.

첫 C++ 빌드 검증

런처, Visual Studio, Windows SDK, 프로젝트 설정은 따로 설치되지만 실패는 한 지점처럼 보인다. 그래서 한 번에 연결 상태를 확인한다.

  1. UE5 버전

    Engine 학습 프로젝트가 열리는 엔진 버전과 설치 경로를 먼저 고정한다.

  2. Visual Studio

    IDE 게임 개발용 C++ 워크로드와 Unreal 관련 구성 요소를 포함한다.

  3. Windows SDK

    SDK 컴파일 오류가 나면 설치 관리자에서 SDK와 MSVC 도구를 확인한다.

  4. 소스 코드 에디터

    Editor 에디터 개인 설정에서 Visual Studio 2022가 선택되어야 한다.

  5. 1. C++ 선택

    C++ 선택 Blank 프로젝트를 C++로 만든다.

  6. 2. IDE 실행

    IDE 실행 솔루션 파일이 Visual Studio에서 열린다.

  7. 3. 새 클래스

    새 클래스 에디터에서 C++ 클래스를 추가한다.

  8. 4. 빌드

    빌드 컴파일이 끝나고 오류 목록이 비어 있다.

  9. 5. 에디터 확인

    에디터 확인 콘텐츠 브라우저와 로그에 결과가 반영된다.

설치가 끝났다는 사실만으로는 충분하지 않습니다.

C++ 프로젝트 생성, IDE 실행, 첫 빌드, 에디터 반영까지 이어지는 작은 검증 루틴을 통과해야 실제 개발 환경이 준비된 것입니다.


언리얼 엔진과 비주얼 스튜디오 연동 확인

모든 설치가 완료되었다면, 언리얼 엔진이 비주얼 스튜디오를 제대로 인식하는지 확인하고 필요한 설정을 진행해야 합니다.

언리얼 엔진 프로젝트 생성: 에픽게임즈 런처에서 언리얼 엔진을 실행합니다.

게임 템플릿을 선택하고, 블랭크(Blank) 프로젝트를 생성하세요.

프로젝트 생성 시, 프로젝트 기본 설정에서 C++ 옵션이 선택되어 있는지 확인하는 것이 중요합니다.

프로젝트 이름을 입력하고 생성 버튼을 클릭합니다.

언리얼 엔진 에디터 설정 확인: 새 프로젝트가 열리면, 언리얼 엔진 에디터 상단 메뉴에서 편집(Edit) > 에디터 개인 설정(Editor Preferences) 으로 이동합니다.

소스 코드 에디터 설정: 좌측 메뉴에서 일반(General) 아래의 소스 코드(Source Code) 섹션을 찾으세요.

소스 코드 에디터(Source Code Editor) 드롭다운 메뉴에서 Visual Studio 2022 (또는 설치한 버전에 해당하는 Visual Studio)가 선택되어 있는지 확인합니다.

만약 다른 것이 선택되어 있다면 Visual Studio로 변경하고 에디터를 재시작합니다.

이로써 언리얼 엔진과 비주얼 스튜디오의 기본적인 연동이 완료되었습니다.

이제는 C++ 코드를 작성하고, 컴파일하며, 언리얼 엔진에서 그 결과를 확인할 준비가 된 것입니다.


추가 설정 및 팁

  • Windows SDK 설치: 간혹 비주얼 스튜디오 설치 과정에서 특정 버전의 Windows SDK가 누락될 수 있습니다. 만약 컴파일 오류가 발생한다면, 비주얼 스튜디오 설치 관리자를 다시 실행하여 개별 구성 요소 탭에서 필요한 버전의 Windows SDK를 설치해 주세요. 언리얼 엔진은 보통 설치된 비주얼 스튜디오에 포함된 최신 SDK를 사용합니다.
  • 언리얼 엔진 업데이트: 에픽게임즈 런처를 통해 언리얼 엔진을 주기적으로 업데이트하는 것이 좋습니다. 새로운 기능과 버그 수정이 포함되기 때문이죠.
  • 비주얼 스튜디오 확장 프로그램: Visual AssistResharper C++ 같은 확장은 C++ 코드 탐색과 분석 기능을 보강합니다. 필수는 아니므로 먼저 기본 환경으로 시작해도 됩니다.

설치가 완료된 뒤에는 런처, 엔진, IDE, 첫 빌드가 같은 경로를 바라보는지 한 번에 점검해야 다음 절 프로젝트 생성에서 막히지 않습니다.

개발 흐름 연결 검증

런처에서 엔진을 설치하고 Visual Studio 워크로드를 선택했다면, 바로 코드 작성을 시작하기보다 프로젝트 생성 전에 연동 상태를 한 번 확인합니다.

  1. Epic Games Launcher

    설치된 UE5 버전과 옵션 구성 요소를 확인합니다.

  2. Visual Studio

    C++ 데스크톱과 게임 개발 워크로드가 들어 있는지 봅니다.

  3. Editor Preferences

    소스 코드 에디터가 설치한 IDE를 가리키는지 맞춥니다.

  4. First Build

    빈 C++ 프로젝트를 열어 솔루션 생성과 컴파일을 확인합니다.

  5. 오류가 나면 먼저 볼 항목

    Windows SDK, Unreal Engine 설치 관리자, 프로젝트 경로의 한글/공백 문제를 순서대로 분리해서 확인합니다.

  6. 학습용 기본값

    초반에는 최신 UE5, Visual Studio 2022, Starter Content 포함 설정이 실습 피드백을 가장 빠르게 만듭니다.

  7. 성공 신호

    에디터에서 C++ 클래스를 만들고 IDE가 같은 솔루션을 열면 준비가 된 것입니다.

  8. 멈추는 지점

    빌드 오류는 대부분 워크로드, SDK, 엔진 버전 연결 문제에서 시작합니다.

  9. 다음 절 연결

    확인을 마친 뒤 Blank C++ 프로젝트를 생성하면 실습 흐름이 흔들리지 않습니다.

이제 컴퓨터의 언리얼 엔진 C++ 개발 기본 환경이 준비되었습니다.

설치 과정에서 문제가 발생했다면 이 절차를 다시 점검하고, 로그 메시지를 기준으로 원인을 확인합니다.

다음 절에서는 언리얼 엔진 프로젝트를 생성하고 기본 프로그래밍 개념을 엔진 환경에 적용하는 방법을 다룹니다.

설치 후 환경 검수 루프

엔진 설치가 끝났다면 바로 기능 구현으로 넘어가기보다 IDE, 모듈, 빌드, 에디터 실행까지 한 번 연결해 보세요.

설치 완료는 C++ 프로젝트 생성, 빌드, 에디터 연동까지 확인해야 한다

엔진이 켜지는 것만으로는 부족하다. 코드가 컴파일되고 에디터에서 반영되는지까지 본다.

검수 항목통과 기준놓치기 쉬운 문제
엔진 버전학습 프로젝트와 같은 UE 버전을 사용한다문서와 메뉴가 달라진다
VS 워크로드MSVC, Windows SDK, Unreal 관련 도구가 있다솔루션 빌드가 도구 없음으로 실패한다
프로젝트 생성Source, .uproject, 솔루션 파일이 함께 생긴다경로가 너무 길거나 한글/공백으로 깨진다
에디터 연동Compile 후 새 클래스와 값이 Details에 보인다이전 빌드나 다른 인스턴스를 보고 있다