Visual Studio에서 Unreal Engine 클래스, 모듈 및 플러그인 추가하기

이 문서에서는 다음의 내용을 수행하기 위해 Visual Studio Tools for Unreal Engine을 사용합니다.

• Visual Studio에서 Unreal Engine 모듈 추가하기
• Unreal Engine 클래스를 Visual Studio 내에 추가하기
• Unreal Engine 플러그 인을 Visual Studio 내에 추가하기

필수 조건

다음 사항은 필수로 설치해야 합니다.

• Visual Studio 버전 17.11(17.11 미리 보기 버전 사용 가능) 이상 버전이어야 합니다.
• Unreal Engine 버전 5 이상.
• Visual Studio Tools for Unreal Engine 설치 지침은 언리얼 엔진 용 Visual Studio Tools 설치를 참고하세요 .
• Lyra 게임을 다운로드 및 빌드하고 Unreal Engine용 Visual Studio 도구를 사용하도록 구성하기 위해 빠른 시작: Visual Studio Tools for Unreal Engine을 완료합니다.

Visual Studio에서 Unreal Engine 모듈 추가하기

이제 Visual Studio 내에서 Unreal Engine 모듈을 Unreal Engine 프로젝트에 추가할 수 있습니다. 더 이상 모듈을 추가하기 위해 Visual Studio와 Unreal Engine Editor 사이를 전환할 필요가 없으며 이후에 Unreal Engine 프로젝트 파일과 Visual Studio 솔루션을 동기화할 필요가 없습니다.

Unreal Engine에서 코드를 구성하는 방법이 모듈입니다. 자산과 관련 클래스를 함께 그룹화하고 코드를 런타임에 로드 및 언로드할 수 있는 자체 포함 단위로 구성하기 위해 활용할 수 있습니다. 수동으로 모듈을 만드는 작업을 수행하는 경우 번거롭고 오류가 발생하기 쉬우며, 이는 구성 파일을 편집하고 상용구 코드를 추가해야 하기 때문입니다. Visual Studio를 사용하면 모듈을 더 쉽게 만들 수 있으며, 이를 통해 프로세스를 안내하는 대화 상자가 제공되고 구성이 수행되며 상용구가 추가됩니다.

빠른 시작: Visual Studio Tools for Unreal Engine을 완료한 뒤 다음의 단계를 수행하여 Lyra 게임을 다운로드하고 빌드함으로써 Unreal Engine 모듈을 Visual Studio에서 추가할 수 있습니다. 다음의 단계에서는 LyraStarterGame.sln 솔루션이 Visual Studio에서 열려 있다고 가정합니다.

1. 새 모듈을 사용할 LyraStarterGame 등의 프로젝트를 솔루션 탐색기에서 선택합니다.
2. 마우스 오른쪽 단추로 프로젝트를 클릭하고(이 과정에서 폴더가 아닌 프로젝트가 선택되어 있는지 확인합니다) Unreal Engine 항목... 추가>를 선택합니다. 다음과 같은 Unreal Engine 항목에 대한 새 항목 추가 대화 상자를 엽니다.
3. Unreal Engine 모듈을 선택하고 모듈 이름을 이름 필드에 입력한 뒤, 추가를 선택하여 Unreal Engine 모듈 추가 대화 상자를 엽니다.

   

   모듈 로드 단계(기본값이 선택됨), 모듈 유형에 대한 드롭다운(런타임이 선택됨) 및 모듈 이름에 대한 필드가 Unreal Engine 모듈 추가 대화 상자에 표시되어 있습니다. 빌드 파일 경로, 헤더, 원본 및 모듈 경로가 나열됩니다. Unreal 편집기 도구를 사용하여 IntelliSense 정보 새로 고침 확인란이 선택되어 있습니다.

4. 모듈 유형 및 모듈 로드 단계를 선택하기 위해 드롭다운을 사용합니다.
5. 프로젝트에 모듈을 추가하고 Visual Studio 솔루션 파일을 업데이트하려면 확인을 선택합니다.

모듈은 원본 폴더 또는 플러그 인 폴더 내의 플러그 인 모듈로만 만들 수 있습니다.
Build.cs 파일이 생성된 위치는 빌드 경로에 표시됩니다. 모듈에 대한 구성 정보가 Build.cs 파일에 포함되어 있습니다.

Unreal Engine 클래스를 Visual Studio 내에 추가하기

이제 Visual Studio 내에서 Unreal Engine 클래스를 Unreal Engine 프로젝트에 추가할 수 있습니다. 더 이상 클래스를 추가하기 위해 Visual Studio와 Unreal Editor 사이를 전환할 필요가 없으며 이후에 Unreal Engine 프로젝트 파일과 Visual Studio 솔루션을 동기화할 필요가 없습니다.

빠른 시작: Visual Studio Tools for Unreal Engine을 완료한 뒤 다음의 단계를 수행하여 Lyra 게임을 다운로드하고 빌드함으로써 Unreal Engine 클래스를 Visual Studio에서 추가할 수 있습니다. 다음의 단계에서는 LyraStarterGame.sln 솔루션이 Visual Studio에서 열려 있다고 가정합니다.

1. 새 클래스를 사용할 폴더를 솔루션 탐색기에서 선택합니다. 예를 들어 LyraStarterGame 프로젝트에서 새 클래스를 LyraStarterGame>원본 폴더에 추가할 수 있습니다.
2. 마우스 오른쪽 단추로 폴더를 클릭하고 Unreal Engine 항목...추가>를 선택하여 새 항목 추가 대화 상자를 다음과 같이 엽니다.

   

   Unreal Engine 플러그 인, 빈 Unreal Engine 모듈 및 Unreal Engine 공통 클래스(선택된 클래스)를 추가하는 옵션이 있습니다.

3. Unreal Engine 공용 클래스를 선택한 뒤, 추가를 선택하여 Unreal Engine 클래스 추가 대화 상자를 다음과 같이 엽니다.

   

   문자, 행위자 등의 기본 상태를 선택하는 옵션이 표시됩니다. 클래스 이름에 대한 클래스 및 필드를 추가할 모듈의 드롭다운이 있습니다. 원본 파일 및 헤더 파일에 대한 경로가 나열됩니다. Unreal 편집기 도구를 사용하여 IntelliSense 정보 새로 고침 확인란이 선택되어 있습니다.

4. 클래스 이름을 선택합니다. 기존 파일 또는 클래스와 이름이 충돌하는 경우 Visual Studio는 경고합니다.
5. 기본 클래스를 선택합니다. 기본 클래스를 선택하면 해당 클래스 형식에 대한 올바른 매크로 및 헤더가 포함됩니다.
6. 클래스 드롭다운을 추가하려면 모듈 선택을 사용하여 클래스에 추가할 모듈을 선택합니다. 모듈을 포함하는 폴더의 이름이 모듈 이름입니다.
7. Visual Studio에서 Unreal Editor 도구를 사용하여 IntelliSense 정보를 업데이트할지 여부를 선택하려면 Unreal 편집기 도구를 사용하여 IntelliSense 정보 새로 고침 확인란을 선택합니다. 이를 선택하면 Visual Studio 솔루션 파일을 Unreal Build Tool이 다시 생성하도록 할 수 있습니다.
8. 새 클래스에 대한 원본 및 헤더 파일을 생성하고 Visual Studio 솔루션 파일에 추가하려면 확인을 선택합니다. 이렇게 하면 프로젝트를 다시 로드하라는 프롬프트가 나타납니다. 프로젝트를 다시 로드하기 위해 다시 로드를 선택합니다.

Unreal Engine 플러그 인을 Visual Studio 내에 추가하기

이제 Visual Studio 내에서 Unreal Engine 플러그 인을 Unreal Engine 프로젝트에 추가할 수 있습니다. 더 이상 플러그 인을 추가하기 위해 Visual Studio와 Unreal Editor 사이를 전환할 필요가 없으며 이후에 Unreal Engine 프로젝트 파일과 Visual Studio 솔루션을 동기화할 필요가 없습니다.

빠른 시작: Visual Studio Tools for Unreal Engine을 완료한 뒤 다음의 단계를 수행하여 Lyra 게임을 다운로드하고 빌드함으로써 Unreal Engine 플러그 인을 Visual Studio에서 추가할 수 있습니다. 다음의 단계에서는 LyraStarterGame.sln 솔루션이 Visual Studio에서 열려 있다고 가정합니다.

1. 새 플러그 인을 사용할 폴더를 솔루션 탐색기에서 선택합니다. 예를 들어 LyraStarterGame 프로젝트에서 새 플러그 인을 LyraStarterGame>원본 폴더에 추가할 수 있습니다.
2. 마우스 오른쪽 단추로 폴더를 클릭하고 Unreal Engine 항목...추가>를 선택하여 새 항목 추가 대화 상자를 다음과 같이 엽니다.

   

   Unreal Engine 플러그 인(선택됨), 빈 Unreal Engine 모듈 및 Unreal Engine 공통 클래스를 추가하는 옵션이 있습니다.

3. Unreal Engine 플러그 인을 선택한 뒤, 추가를 선택하여 Unreal Engine 플러그 인 추가 대화 상자를 다음과 같이 엽니다.

   

   플러그 인 유형 목록(고급이 선택됨) 및 URL, 설명, 작성자, 경로 및 플러그 인 이름에 대한 필드가 있습니다. Unreal Editor Tools를 사용하여 IntelliSense 정보 새로 고침 확인란(선택됨), 그리고 베타 확인란(선택되지 않음)의 Is 플러그 인 확인란이 있습니다.

4. 플러그 인 유형을 플러그 인 유형 목록에서 선택합니다.
5. 플러그 인 이름, 플러그 인 작성자, 플러그 인 설명 및 플러그 인 URL이 제공됩니다.
6. Is 플러그 인 베타 확인란을 필요에 따라 선택합니다.
7. Visual Studio에서 Unreal Editor 도구를 사용하여 IntelliSense 정보를 업데이트할지 여부를 선택하려면 Unreal 편집기 도구를 사용하여 IntelliSense 정보 새로 고침 확인란을 선택합니다. 이러한 확인란을 선택하면 Visual Studio 솔루션 파일을 Unreal Build Tool이 다시 생성하도록 할 수 있습니다.
8. 새 플러그 인에 대한 플러그 인 헤더 및 소스 파일을 생성하고 Visual Studio 솔루션 파일에 추가하기 위해 추가를 선택합니다. 이렇게 하면 프로젝트를 다시 로드하라는 프롬프트가 나타납니다. 프로젝트를 다시 로드하기 위해 다시 로드를 선택합니다.

관련 콘텐츠

Visual Studio Tools for Unreal Engine
Visual Studio에서 Unreal Engine 청사진 보기
Visual Studio에서 Unreal Engine 로깅 보기
Visual Studio에서 Unreal Engine 매크로 보기