개발 환경 설정 기초집LESSON 17

Unreal Engine 개발 환경: Launcher·엔진 버전·C++ 컴파일 도구 점검

난이도입문

예상 시간60분

선수지식7강 Visual Studio와 Rider

17강. Unreal Engine 개발 환경: Launcher·엔진 버전·C++ 컴파일 도구 점검

1. 이번 강의에서 해결할 문제

Unreal Editor는 열리지만 C++ 프로젝트 생성이나 컴파일에서 도구 체인을 찾지 못합니다. Launcher, Engine, IDE, UnrealBuildTool과 MSVC의 역할을 분리해 확인합니다.

2. 학습 목표

3. 핵심 개념

Epic Games Launcher는 바이너리 Engine 설치를 관리하고 Unreal Editor가 프로젝트를 엽니다. UnrealBuildTool은 .Build.cs와 .Target.cs를 읽어 빌드를 구성하며 Windows에서는 호환 MSVC와 Windows SDK가 필요합니다. Visual Studio나 Rider는 이 도구 체인을 호출하고 오류를 보여 주는 IDE입니다.

정확한 Visual Studio·MSVC·SDK 조합은 엔진 세부 버전마다 달라질 수 있으므로 Epic의 C++ 개발 환경 설정과 Microsoft의 Unreal 도구 설치를 해당 버전으로 확인합니다.

4. 단계별 실습

Epic Games Launcher 작업 — 권한 상승 가능

Library에서 사용할 Unreal Engine 버전과 설치 옵션을 확인합니다.
프로젝트가 요구하는 엔진을 임의로 제거하거나 업그레이드하지 않습니다.
Engine 설치와 필수 구성 요소 설치는 권한 상승을 요구할 수 있습니다.

PowerShell · 실행 위치: 일반 PowerShell

Get-ChildItem -LiteralPath 'C:\Program Files\Epic Games' -Directory -Filter 'UE_*' -ErrorAction SilentlyContinue

$vswherePath = Join-Path ${env:ProgramFiles(x86)} 'Microsoft Visual Studio\Installer\vswhere.exe'
if (Test-Path -LiteralPath $vswherePath) {
    & $vswherePath -latest -products * `
        -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 `
        -property installationPath
}

예상 결과: 기본 위치에 설치한 Engine 폴더와 C++ Build Tools가 있는 Visual Studio 설치 루트가 표시됩니다. 사용자 지정 설치라면 Launcher 설정에서 실제 경로를 확인합니다.

PowerShell · 실행 위치: Unreal 프로젝트 루트

$projectFile = Get-ChildItem -Filter *.uproject | Select-Object -First 1
$projectFile.FullName
if ($projectFile) {
    (Get-Content $projectFile.FullName -Raw | ConvertFrom-Json).EngineAssociation
}
Get-ChildItem .\Source -Recurse -Filter *.Build.cs -ErrorAction SilentlyContinue

예상 결과: .uproject 경로, 연결된 엔진 식별자와 C++ 모듈 Build.cs가 표시됩니다.

Unreal Editor·IDE 작업

C++ Blank 프로젝트를 짧은 경로에 만듭니다.
공식 안내에 맞는 Development Editor와 Win64 구성을 선택합니다.
IDE에서 Build하거나 Editor의 Compile을 실행해 성공 로그를 확인합니다.
Play In Editor가 시작되고 종료되는지 확인합니다.

5. 명령어와 설정이 동작하는 이유

.uproject의 EngineAssociation이 어떤 Engine으로 열지 연결하고 Build.cs가 모듈 의존성을 정의합니다. IDE의 Build는 UnrealBuildTool을 거쳐 호환 MSVC·SDK를 호출하므로 각 단계의 설치 여부가 모두 필요합니다.

6. 자주 하는 실수와 해결법

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ