Visual Studio에서 Unreal Engine 클래스, 모듈 및 플러그 인 추가
이 문서에서는 Visual Studio Tools for Unreal Engine을 사용하여 다음을 수행합니다.
- Visual Studio Unreal Engine 모듈 추가
- Visual Studio Unreal Engine 클래스 추가
- Visual Studio Unreal Engine 플러그 인 추가
필수 구성 요소
다음을 설치해야 합니다.
- Visual Studio 버전 17.11(17.11 미리 보기 버전 확인) 이상.
- Unreal Engine 버전 5 이상.
- Visual Studio Tools for Unreal Engine. 설치 지침은 Visual Studio Tools for Unreal Engine 설치를 참조하세요.
- Visual Studio Tools for Unreal Engine 빠른 시작을 완료하여 Lyra 게임을 다운로드하고 빌드한 후, Unreal Engine용 Visual Studio Tools를 사용하도록 구성합니다.
Visual Studio에서 Unreal Engine 모듈 추가
이제 Visual Studio 내에서 Unreal Engine 프로젝트에 Unreal Engine 모듈을 추가할 수 있습니다. 모듈을 추가하기 위해 Unreal Engine Editor와 Visual Studio 간에 더 이상 전환할 필요가 없으며 나중에 Visual Studio 솔루션을 Unreal Engine 프로젝트 파일과 동기화할 필요가 없습니다.
모듈은 Unreal Engine에서 코드를 구성하는 방법입니다. 관련 클래스와 자산을 함께 그룹화하고 런타임에 로드 및 언로드할 수 있는 자체 포함 단위로 코드를 구성하는 데 도움이 됩니다. 모듈을 만드는 작업은 구성 파일을 편집하고 상용구 코드를 추가해야 하기 때문에 수동으로 수행하는 경우 번거롭고 오류가 발생하기 쉽습니다. Visual Studio를 사용하면 모듈을 더 쉽게 만들 수 있습니다. 이는 프로세스를 안내하는 대화 상자를 제공하고, 구성을 자동으로 설정하며, 필수적인 코드를 추가하여 이루어집니다.
Visual Studio에서 Unreal Engine 모듈을 추가하려면 빠른 시작을 완료한 후 다음 단계를 수행합니다. Visual Studio Tools for Unreal Engine Lyra 게임을 다운로드하고 빌드합니다. 다음 단계에서는 visual Studio에서 LyraStarterGame.sln 솔루션이 열려 있다고 가정합니다.
- 솔루션 탐색기에서 새 모듈이 추가될 프로젝트를 선택합니다. 예를 들어, LyraStarterGame같은 프로젝트를 선택하세요.
- 프로젝트를 마우스 오른쪽 단추로 클릭하고(폴더가 아닌 프로젝트가 선택되어 있는지 확인) >Unreal Engine 항목 추가를 선택합니다. Unreal Engine 항목에 대한 새 항목 추가 대화 상자를 엽니다.
- Unreal Engine 모듈 선택하고 이름 필드에 모듈 이름을 입력한 다음, 추가를 선택하여 Unreal Engine 모듈 추가 대화 상자를 엽니다.
Unreal Engine 모듈 추가 대화 상자에는 모듈 이름에 대한 필드, 모듈 유형에 대한 드롭다운(런타임이 선택됨) 및 모듈 로드 단계(기본값이 선택됨)가 있습니다. 모듈 경로, 헤더, 원본 및 빌드 파일 경로가 나열됩니다. Unreal 편집기 도구를 사용하여 IntelliSense 정보 새로 고침 확인란이 선택되어 있습니다.
- 드롭다운을 사용하여 모듈 유형 선택하고 모듈 로드 단계.
- 확인 선택하여 프로젝트에 모듈을 추가하고 Visual Studio 솔루션 파일을 업데이트합니다.
모듈은 원본 폴더 또는 플러그 인 폴더 내의 플러그 인 모듈로만 만들 수 있습니다.
빌드 경로에는 Build.cs 파일이 만들어지는 위치가 표시됩니다.
Build.cs 파일에는 모듈에 대한 구성 정보가 포함되어 있습니다.
Visual Studio에서 Unreal Engine 클래스 추가
이제 Visual Studio 내에서 Unreal Engine 프로젝트에 Unreal Engine 클래스를 추가할 수 있습니다. 더 이상 Unreal Editor와 Visual Studio 간에 전환하여 클래스를 추가하거나 나중에 Visual Studio 솔루션을 Unreal Engine 프로젝트 파일과 동기화할 필요가 없습니다.
Visual Studio에서 Unreal Engine 클래스를 추가하려면 빠른 시작을 완료한 후 다음 단계를 수행합니다. Visual Studio Tools for Unreal Engine Lyra 게임을 다운로드하고 빌드합니다. 이 단계에서는 Visual Studio에서 LyraStarterGame.sln 솔루션이 열려 있다고 가정합니다.
- 솔루션 탐색기새 클래스를 사용할 폴더를 선택합니다. 예를 들어 LyraStarterGame 프로젝트에서 LyraStarterGame>원본 폴더에 새 클래스를 추가할 수 있습니다.
- 폴더를 마우스 오른쪽 단추로 클릭하고 추가>Unreal Engine 항목을 선택합니다.새 항목 추가 대화 상자를 엽니다.
Unreal Engine 공통 클래스(선택된 클래스), 빈 Unreal Engine 모듈 및 Unreal Engine 플러그 인을 추가하는 옵션이 있습니다.
- Unreal Engine 공용 클래스 선택한 다음 추가 선택하여 Unreal Engine 클래스 추가 대화 상자를 엽니다.
행위자, 문자 등과 같은 기본을 선택하는 옵션이 표시됩니다. 클래스 이름에 대한 필드와 클래스를 추가할 모듈의 드롭다운이 있습니다. 헤더 파일 및 원본 파일의 경로가 나열됩니다. Unreal 편집기 도구를 사용하여 IntelliSense 정보를 새로 고치려면 확인란이 선택됩니다.
- 클래스 이름선택합니다. Visual Studio는 이름이 기존 클래스 또는 파일과 충돌하는 경우 경고합니다.
- 기본 클래스선택합니다. 기본 클래스를 선택하면 해당 클래스 형식에 대해 올바른 헤더와 매크로가 포함됩니다.
- 사용하여 클래스에 추가할 모듈을 선택하여 클래스 드롭다운을 추가할 모듈을 선택합니다. 모듈 이름은 모듈을 포함하는 폴더의 이름입니다.
- Unreal Editor 도구 사용하여 IntelliSense 정보 새로 고침 확인란을 선택하여 Visual Studio에서 Unreal Editor 도구를 사용하여 IntelliSense 정보를 업데이트할지 여부를 선택합니다. Unreal Build Tool이 Visual Studio 솔루션 파일을 다시 생성하도록 하려면 이를 선택합니다.
- 확인 선택하여 새 클래스에 대한 헤더 및 원본 파일을 생성하고 Visual Studio 솔루션 파일에 추가합니다. 그러면 프로젝트를 다시 로드하라는 메시지가 표시됩니다. 을 선택하여을 통해 프로젝트를 다시 로드합니다.
Visual Studio에서 Unreal Engine 플러그 인 추가
이제 Visual Studio 내에서 Unreal Engine 프로젝트에 Unreal Engine 플러그 인을 추가할 수 있습니다. 플러그 인을 추가하기 위해 Unreal Editor와 Visual Studio 간에 더 이상 전환할 필요가 없으며 나중에 Visual Studio 솔루션을 Unreal Engine 프로젝트 파일과 동기화할 필요가 없습니다.
Visual Studio에서 Unreal Engine 플러그 인을 추가하려면 빠른 시작을 완료한 후 다음 단계를 수행합니다. Visual Studio Tools for Unreal Engine Lyra 게임을 다운로드하고 빌드합니다. 이 단계에서는 Visual Studio에서 LyraStarterGame.sln 솔루션이 열려 있다고 가정합니다.
- 솔루션 탐색기새 플러그 인을 이동하려는 폴더를 선택합니다. 예를 들어 LyraStarterGame 프로젝트에서 LyraStarterGame>Source 폴더에 새 플러그 인을 추가할 수 있습니다.
- 폴더를 마우스 오른쪽 단추로 클릭하고 추가>Unreal Engine 항목을 선택합니다.새 항목 추가 대화 상자를 엽니다.
Unreal Engine 공통 클래스, 빈 Unreal Engine 모듈 및 Unreal Engine 플러그 인(선택됨)을 추가하는 옵션이 있습니다.
- Unreal Engine 플러그 인 선택한 다음 추가 선택하여 Unreal Engine 플러그 인 추가 대화 상자를 엽니다.
플러그 인 유형 목록(고급이 선택됨) 및 플러그 인 이름, 경로, 작성자, 설명 및 URL에 대한 필드가 있습니다. 베타 확인란(선택되지 않음)의 Is 플러그 인 확인란과 Unreal Editor Tools를 사용하여 IntelliSense 정보 새로 고침 확인란(선택됨)이 있습니다.
- 플러그 인 유형 목록에서 플러그 인 유형을 선택합니다.
- 플러그 인 이름, 플러그 인 작성자, 플러그 인 설명및 플러그 인 URL제공합니다.
- 필요에 따라 베타 상태의 플러그인 확인란을 체크합니다.
- Unreal Editor 도구 사용하여 IntelliSense 정보 새로 고침 확인란을 선택하여 Visual Studio에서 Unreal Editor 도구를 사용하여 IntelliSense 정보를 업데이트할지 여부를 선택합니다. 이로 인해 Unreal Build Tool이 Visual Studio 솔루션 파일을 다시 생성합니다.
- 추가하여 새 플러그 인에 대한 플러그 인 헤더 및 소스 파일을 생성하고 Visual Studio 솔루션 파일에 추가합니다. 그러면 프로젝트를 다시 로드하라는 메시지가 표시됩니다. 다시 로드할 선택하여 프로젝트를 다시 로드합니다.
관련 콘텐츠
언리얼 엔진용 비주얼 스튜디오 도구
Visual Studio에서 Unreal Engine 블루프린트 보기
Visual Studio에서 Unreal Engine 로깅 보기
Visual Studio에서 Unreal Engine 매크로 보기