자동화 프로젝트 추가

AutomationTool 자동화 프로젝트를 추가하는 방법을 안내합니다.

Choose your operating system:

Windows

macOS

Linux

필요한 사전지식

이 페이지의 콘텐츠를 이해하고 활용하기 위해 다음 주제를 숙지해 주세요.

자동화 툴(AutomationTool) 에서 찾을 수 있는 위치에 새로운 C# 프로젝트를 만들어 자동화 툴에서 컴파일하고 로드할 프로젝트별 자동화 스크립트를 구현할 수 있습니다.

이를 위해서는 엔진(에픽게임즈 런처가 아닌 GitHub 또는 Perforce에서 받은 엔진)의 소스 빌드를 사용하고 프로젝트가 UEGames.uprojectdirs 파일에 나열된 서브디렉터리에서 검색할 수 있는 위치에 있어야 합니다. 이 파일은 Unreal Engine (UE) 루트 디렉터리에 있습니다.

단계

  1. Visual Studio에서 프로젝트 폴더를 우클릭하고 추가(Add) > 새 프로젝트...(New Project...) 를 클릭하세요.

  2. 새 프로젝트 추가(Add New Project) 메뉴가 열리면 클래스 라이브러리 (.NET Framework) Visual C#(Class Library (.NET Framework) Visual C#) 옵션을 선택하고 잘 설명할 수 있게 다음 세팅을 사용하세요.

    세팅

    참고

    Name

    SampleScript.Automation

    프로젝트의 생성 스크립트는 확장자가 *.Automation.csproj`인 *.csproj` 파일을 찾습니다.

    Location

    [ProjectDir]\Build

    [EngineDir]\Source\Programs

    *.uproject 파일과 같은 디렉터리 안에 있어야 합니다. 즉, UE4Games.uprojectdirs

    Framework

    4.6.2

    이 문서를 작성할 당시 사용 중인 .NET 프레임워크입니다.

    *.build.cs 또는 *.target.cs

  3. 잘 설명할 수 있도록 SampleScript.Automation > Class1.cs 를 우클릭하고 이름 변경(Rename) 을 선택하고 `SampleScript.cs`로 변경하세요.

프로젝트의 세팅 업데이트

이제 솔루션에 새로운 자동화 프로젝트가 있으니 빌드 환경설정과 프로젝트의 빌드 출력 경로를 설정할 차례입니다.

릴리스 빌드 환경설정 이름 변경

SampleScript 자동화 프로젝트를 선택한 상태로 다음을 수행하세요.

  1. 빌드(Build) > 구성 관리자...(Configuration Manager...) 를 엽니다.

  2. 목록에서 SampleScript.Automation 프로젝트를 찾고 구성(Configuration) 열에서 편집...(Edit...) 을 선택합니다.

  3. 프로젝트 구성 편집(Edit Project Configurations) 창에서 릴리스(Release) 구성을 선택하고 이름 바꾸기(Rename) 버튼을 누릅니다.

    1. 새 이름을 Development 로 설정합니다.

  4. 두 창을 모두 닫습니다.

프로젝트 빌드 출력 경로 설정

프로젝트의 프로퍼티 메뉴에서 빌드(Build) 탭을 선택한 상태에서 다음을 수행하세요.

  1. 모든 구성(All Configurations)을 선택합니다.

  2. 출력 경로: 필드를 프로젝트의 자동화 스크립트 디렉터리로 설정합니다.

    • 찾아보기...(Browse...) 를 사용하거나 출력 경로를 입력할 수 있습니다

    • 출력 경로는 프로젝트의 루트 디렉터리의 상대 경로가 되므로 '..'을 사용하여 부모 디렉터리로 이동해야 합니다

    • 프로젝트의 출력 경로를 적절하게 설정하지 않으면 자동화 툴이 자동화 명령을 발견할 수 없습니다

  3. Visual Studio를 닫고 GenerateProjectFiles.bat 를 실행합니다.

  4. 설정을 확인하려면 생성된 UE5.sln 을 열고 솔루션 탐색기(Solution Explorer)에서 UE > 프로그램(Programs) > 자동화(Automation) 로 이동한 다음 새로 추가된 자동화 프로젝트를 찾습니다.

필수 어셈블리 레퍼런스 추가

자동화 툴에서 제공하는 기본 기능을 사용하려면 AutomationUtils 라이브러리에 대한 레퍼런스를 추가해야 합니다.

  1. 솔루션 탐색기(Solution Explorer)의 프로그램(Programs) > 자동화(Automation) 에서 프로젝트를 찾습니다.

  2. 프로젝트 폴더에서 참조(References) 를 우클릭하고 참조 추가...(Add Reference...) 를 선택합니다.

  3. 참조 관리자 프로젝트(Reference Manager Projects) 메뉴에서 AutomationUtils.Automation 을 찾아서 선택하고 확인(OK) 을 클릭합니다.

최종 결과

이제 적절한 세팅과 레퍼런스의 자동화 프로젝트를 추가했으니

[명령을 추가](setting-up-your-production-pipeline/unreal-build-system/unreal-automation-tool/unreal-automation-tool/AddingCommands)
하는 방법을 배울 수 있습니다.

언리얼 엔진의 이전 버전을 위해 작성된 페이지입니다. 현재 언리얼 엔진 5 버전을 위해 업데이트되지 않았습니다.