[UE5] 솔루션 구조

솔루션 구조

비주얼 스튜디오에서 솔루션 탐색기에 프로젝트 폴더들이 계층적으로 표시됩니다.

여기서 실제 윈도우즈 탐색기에서 본 프로젝트 폴더 구조와 차이점이 있을 수 있습니다.
비주얼 스튜디오는 빌드와 관리를 용이하게 하기 위해 디스크의 실제 폴더 구조와는 별개로 가상 폴더 구조를 생성합니다.

Engine 폴더

언리얼 엔진 자체의 소스 코드와 리소스가 담겨있는 폴더입니다.

언리얼 엔진의 에디터 작동, 엔진 코어 관련 코드가 포함되어 있습니다.

일반적으로는 수정할 일이 거의 없는 폴더입니다.
커스텀 엔진 빌드를 하거나, 엔진의 일부를 확장해야 하는 경우 수정이 필요 할 수 있습니다.

Games 폴더

우리가 만드는 프로젝트 코드가 모두 담기는 폴더입니다.

C++로 작성하는 게임 로직을 이 폴더에서 많이 다룹니다.

프로젝트 루트 폴더

Games폴더 안에 사용자가 만든 프로젝트 이름이 있는데 이 폴더가 프로젝트 루트입니다.
Games/프로젝트명으로 있습니다.

게임 개발에 필요한 모든 리소스와 설정 파일이 담긴 폴더입니다.

해당 폴더의 주요 구성 요소로 Source, Config, .uproject파일 등이 있습니다.

• Config폴더
  • .ini파일을 통해 에디터와 게임의 초기 상태를 지정합니다.
    • DefaultEditor.ini: 에디터 환경 설정 (뷰포트, UI 등)
    • DefaultEngine.ini: 엔진 전반 설정 (렌더링, 네트워킹 등)
    • DefaultGame.ini: 게임플레이 관련 설정 (게임 모드, 플레이어 컨트롤러 클래스 등)
    • DefaultInput.ini: 키보드, 마우스, 패드 등의 기본 입력 바인딩
• Source폴더
  • 실제 C++ 소스 코드(.cpp, .h)가 들어 있습니다.
  • 최초 프로젝트 생성 시에는 프로젝트명.cpp, 프로젝트명.h등 최소 파일만 있지만, 새 클래스를 만들수록 점차 늘어납니다.
  • 빌드 설정 관련 주요 파일도 포함됩니다.
    • 프로젝트명.Build.cs: 해당 프로젝트에 필요한 모듈, 라이브러리, 종속성 등을 정의합니다.
    • 프로젝트명.Target.cs, 프로젝트명Editor.Target.cs: 각각 게임 실행용, 에디터용 빌드 방식을 정의합니다.
• 프로젝트명.uproject
  • 언리얼 에디터에서 이 파일을 열면 프로젝트를 직접 실행할 수 있습니다.
  • 에디터는 이 파일을 통해 어떤 콘텐츠와 설정을 불러올지 판단합니다.

Programs 폴더

엔진 동작에 필요한 서버 모듈이나 유틸리티 등의 여러가지 프로그램들이 담긴 폴더입니다.

자동화 빌드 또는 서버 관련 기능을 사용하는 경우 학습 할 필요가 있습니다.

Rules 폴더

엔진과 게임 등 각 모듈의 빌드 규칙을 정의해 놓은 파일들이 담긴 폴더입니다.

모듈 의존성, 플러그인 활성화 여부, 빌드 대상 등을 제어합니다.

Visulizers 폴더

비주얼 스튜디오에서 디버깅 시 언리얼 엔진 관련 자료구조를 보기 좋게 표시하기 위한 설정 파일이 들어 있습니다.

예를 들어 FVector, FRotator, TArray 등의 복잡한 데이터 구조를 이해하기 쉬운 방식으로 시각화 해줍니다.