Linux 개발 퀵스타트

언리얼 엔진(UE) 은 소스를 바탕으로 생성한 빌드나 사전 컴파일된 설치 빌드 를 사용하는 Linux 디바이스에서의 개발을 지원합니다. 이 페이지에서는 개발 환경과 빌드 파이프라인 등 Linux에 맞게 언리얼 엔진을 구성하는 방법을 설명합니다. 이 튜토리얼을 마치면 Linux 디바이스를 사용하여 언리얼 엔진에서 애플리케이션을 개발할 수 있습니다.

1. 권장 소프트웨어 및 하드웨어

언리얼 엔진은 다음의 최소 요구사항을 만족하는 다양한 Linux 배포 버전 및 IDE와 호환됩니다.

언리얼 에디터 를 원활하게 작동하기 위한 권장 시스템 표준은 다음과 같습니다.

Linux에서 사용되는 Vulkan 렌더링 하드웨어 인터페이스(Rendering Hardware Interface, RHI)는 다른 백엔드에 비해 저용량 VRAM에 적합하지 않습니다. VRAM 용량이 충분한 전용 GPU 사용을 적극 권장합니다.

개발 환경을 구성할 때는 테스트 시 가장 자주 사용하는 다음 소프트웨어를 권장합니다.

구성 방법에 대한 자세한 내용은 사용 중인 Linux 배포 버전이나 IDE의 문서를 참조하시기 바랍니다. OS와 하드웨어의 구성 방법은 이 문서의 범위를 벗어납니다. 하지만 언리얼 엔진에 맞는 IDE 구성 방법은 아래에서 확인할 수 있습니다.

2. 언리얼 엔진 설치

Linux에서 언리얼 엔진을 구성하려면 사전 컴파일된 빌드를 설치하거나, 소스를 바탕으로 엔진을 빌드해야 합니다.

2a. 설치 빌드 다운로드하기

언리얼 엔진을 실행하는 가장 간단한 방법은 설치 빌드를 사용하는 것입니다. 설치 빌드를 다운로드 및 설치하려면 다음 단계를 따릅니다.

2b. 소스를 바탕으로 언리얼 엔진 빌드하기

소스를 바탕으로 언리얼 엔진을 설치하려면 언리얼 엔진 소스 코드 다운로드하기를 참조하세요. 언리얼 엔진을 컴파일했다면 터미널에서 Engine/Binaries/Linux/UnrealEditor 를 실행하여 언리얼 에디터를 엽니다.

3. 새 프로젝트 구성하기

새 프로젝트를 구성하는 방법은 언리얼 엔진에서 새 프로젝트 생성하기를 참조하세요. 이 튜토리얼에서는 특정 템플릿이나 프로젝트 타입이 필요하지 않지만, C++용 환경을 구성하려는 경우 C++ 를 활성화해야 합니다.

[C++ 세팅 활성화 스크린샷)

4. 개발 환경 구성하기(C++)

C++ 프로젝트를 개발하려는 경우, 언리얼 엔진과 함께 사용할 Clang 툴 체인과 IDE를 구성해야 합니다. 사용해야 하는 IDE가 정해져 있는 것은 아니지만 Visual Studio Code 또는 Rider를 권장합니다. 이 섹션에서는 다른 운영체제에도 맞는 공통 개발 환경을 제공하는 Visual Studio Code를 기준으로 설명합니다.

1. 터미널을 열고 다음 명령을 실행합니다.

   Sudo apt install clang

2. 언리얼 엔진 설치 디렉터리를 찾아 Build/BatchFiles/Linux 를 연 다음 SetupToolchain.sh 를 실행합니다.

3. VS Code와 정식 C/C++ 익스텐션 팩 및 C# 익스텐션을 다운로드 및 설치합니다. 언리얼 엔진과 빌드 툴 모두에서 소스 코드를 읽는 데 필요합니다.

4. 언리얼 에디터를 열고 에디터 개인설정(Editor Preferences) 에서 소스 코드 에디터(Source Code editor)를 Visual Studio Code로 설정하거나, 다음 내용이 포함되도록 BaseEngine.ini 를 수정합니다.

            [/Script/SourceCodeAccess.SourceCodeAccessSettings]
            PreferredAccessor=VisualStudioCode
   		
   Copy full snippet

   [/Script/SourceCodeAccess.SourceCodeAccessSettings] PreferredAccessor=VisualStudioCode

5. GenerateProjectFiles.sh -vscode 를 실행하여 엔진 배포 버전(소스 코드 빌드의 경우) 또는 프로젝트용 VS Code 워크스페이스를 생성합니다. -project=(path to your project) 를 추가하여 구체적인 프로젝트를 선택합니다.

IntelliSense 등 유용한 유틸리티를 사용하여 VS Code를 환경설정하는 방법은 언리얼 엔진용 VS Code 구성을 참조하세요.

5. 프로젝트 빌드

환경 구성을 다 마쳤다면 이제 프로젝트 테스트 빌드를 실행하여 워크플로가 제대로 작동하는지 확인할 차례입니다.

5a. 언리얼 에디터에서 프로젝트 빌드하기

언리얼 에디터에서 프로젝트를 열고 플랫폼(Platforms) 드롭다운에서 Linux > 프로젝트 패키지(Package Project) 를 클릭합니다. 시스템이 올바르게 환경설정되었다면 언리얼 엔진이 프로젝트를 빌드, 쿠킹, 패키징할 것입니다.

5b. 명령줄을 통해 프로젝트 빌드하기

명령줄을 통해 프로젝트를 빌드하려면 빌드 작업 가이드에 나와 있는 RunUAT 스크립트의 BuildCookRun 명령을 사용합니다. 다음은 BuildCookRun 명령을 사용한 예시입니다.

	[UE 루트 디렉터리]/RunUAT BuildCookRun -Build -Cook -Stage -Package -Run -Project=[프로젝트 이름]

Copy full snippet

[UE 루트 디렉터리]/RunUAT BuildCookRun -Build -Cook -Stage -Package -Run -Project=[프로젝트 이름]

또는 Turnkey 명령줄로 동일한 프로세스를 시작할 수 있습니다.

	[UE 루트 디렉터리]/RunUAT Turnkey -command=ExecuteBuild -platform=Linux -Project=[프로젝트 이름]

Copy full snippet

[UE 루트 디렉터리]/RunUAT Turnkey -command=ExecuteBuild -platform=Linux -Project=[프로젝트 이름]

보통은 언리얼 엔진 소스 디렉터리에서 RunUAT를 사용해야 합니다. 이 명령을 더 단순하게 실행하려면 $UE_ROOT 환경 변수를 정의하면 됩니다. 이렇게 하면 RunUAT 스크립트에 전체 경로를 제공하는 대신 $UE_ROOT/RunUAT BuildCookRun 와 같은 명령을 사용하여 RunUAT를 실행할 수 있습니다.