빠른 시작: Visual Studio Tools for Unreal Engine
이 문서에서는 Unreal Engine(UE) 게임 샘플을 다운로드하고 Visual Studio Tools for Unreal Engine을 구성합니다. Visual Studio Tools for Unreal Engine은 Unreal Engine을 사용하여 게임을 개발하는 데 도움이 되는 무료 확장입니다. Visual Studio에서 Unreal Engine 개발 환경을 개선하는 기능을 제공합니다.
필수 조건
다음 사항은 필수로 설치해야 합니다.
- Visual Studio 버전 17.10 이상
- Unreal Engine 버전 5 이상이 필요하며, 이는 해당 문서에서 사용된 예제에는 Unreal Engine 5 이상이 필요하기 때문입니다.
- Visual Studio Tools for Unreal Engine 설치 지침은 언리얼 엔진 용 Visual Studio Tools 설치를 참고하세요 .
Visual Studio에서 Lyra 게임 샘플 다운로드 및 빌드
Lyra는 Unreal Engine을 학습하는 데 사용되는 샘플 게임 프로젝트입니다. 다운로드 지침은 Lyra 샘플 게임의 Lyra Starter 게임 다운로드 섹션을 참조하세요. Unreal Engine의 소스 코드 설치를 통해 구입한 경우 해당 버전에는 게임을 빌드하고 실행하는 데 필요한 자산이 포함되지 않습니다. 다운로드 지침을 사용하여 에픽 설치 관리자를 통해 필요한 모든 것을 얻을 수 있습니다.
Visual Studio Tools for Unreal Engine을 사용하도록 Lyra 게임 샘플 구성
Unreal Engine용 Visual Studio 도구 플러그 인은 Visual Studio 2022 버전 17.7을 기준으로 Unreal Engine 설치에 포함되어 있습니다. Unreal Engine 청사진을 더 이상 볼 필요가 없습니다. 이전 버전의 Visual Studio가 있는 경우, 플러그인을 수동으로 설치하기 위해 Visual Studio Tools for Unreal Engine 설치를 참조합니다.
게임 샘플을 다운로드한 뒤, LyraStarterGame.uproject
을(를) Visual Studio Tools 플러그 인을 사용하도록 업데이트합니다. Unreal 편집기에서 이를 수행하는 한 가지 방법이 있습니다. Lyra 프로젝트를 로드하고 주 메뉴에서 편집>플러그인을 선택합니다. Visual Studio 통합 도구 플러그인을 찾아 옆에 있는 확인란을 선택합니다.
또 다른 방법은 LyraStarterGame.uproject
파일을 수동으로 편집하는 것입니다. 방법은 다음과 같습니다.
텍스트 편집기에서
LyraStarterGame.uproject
파일을 엽니다. 게임 샘플을 설치한 디렉터리에 있습니다.Plugins
섹션의 끝에 다음 코드를 추가합니다.,{ "Name": "VisualStudioTools", "Enabled": true }
Unreal Engine에서
- Unreal Engine에서 Lyra 프로젝트를 엽니다.
- Unreal Engine 편집기 기본 메뉴에서 도구>Visual Studio 프로젝트 생성을 선택합니다. Visual Studio에 대한 솔루션 파일을 생성합니다.
- Unreal Engine 편집기 기본 메뉴에서 툴>Visual Studio 열기를 선택하여 Visual Studio에서 게임을 엽니다. 컴퓨터에 여러 버전의 Visual Studio가 있는 경우 올바른 버전이 열려 있는지 확인합니다. Visual Studio 기본 메뉴에서 Microsoft Visual Studio에 대한 도움말을>선택합니다. 이를 사용하려면 Visual Studio 2022 버전 17.7 이상이 필요합니다. 올바른 버전이 열리지 않은 경우 올바른 버전의 Visual Studio에서 수동으로 엽니다
LyraStarterGame.sln
.
Visual Studio에서
- 솔루션 구성 드롭다운을 개발 편집기로 변경합니다. 이렇게 하면 Blueprints Visual Studio Tools for Unreal Engine을 사용할 수 있습니다.
- 시작 프로젝트를 LyraStarterGame 프로젝트로 설정합니다. 솔루션 탐색기에서 솔루션을 마우스 오른쪽 버튼으로 클릭하고 속성을 선택합니다.
- 솔루션 속성 페이지 대화 상자의 공통 속성 아래에서 시작 프로젝트 구성을 선택합니다.
- 단일 시작 프로젝트가 선택되어 있는지 확인하고 드롭다운에서 LyraStarterGame을 선택합니다.
공통 속성에서 시작 프로젝트 구성이 선택되어 있습니다. 단일 시작 프로젝트 라디오 버튼이 선택되어 있습니다. 드롭다운의 시작 프로젝트는 LyraStarterGame입니다.
- 확인을 선택하여 대화 상자를 닫습니다.
- Visual Studio 주 메뉴에서 빌드 솔루션 빌드를 선택하여>게임을 빌드 합니다.
Visual Studio 빌드 출력 창
Visual Studio의 빌드 출력 창에는 빌드 진행 상황과 발생하는 오류 또는 경고가 표시됩니다. 보기>출력을 통해 빌드 출력 창을 Visual Studio 주 메뉴에서 열 수 있습니다.
Visual Studio 2022 17.12부터, Visual Studio에서 해당 파일을 열기 위해 출력 창에서 파일에 대한 절대 경로를 두 번 클릭할 수 있습니다. 출력 창의 경로는 절대 경로여야 하며, 소스 코드는 Visual Studio 솔루션의 일부여야 합니다. Visual Studio 또는 다른 유형의 프로젝트에서 Unreal Engine 프로젝트를 빌드할 때 작동합니다.
LyraStarterGame 샘플 빌드에 대한 출력 창을 다음과 같은 스크린샷이 보여 줍니다. LyraCharacter.generated.h
에서 사용자가 경고를 두 번 클릭했습니다. 해당 파일의 절대 경로가 제공되므로 파일이 편집기에서 열립니다.
Unreal Engine 도구 모음
Visual Studio에서의 Unreal Engine 개발 통합 환경을 개선하는 도구 모음을 Visual Studio에서 제공합니다. 도구 모음은 일반적인 UE 작업에 빠르게 액세스할 수 있도록 합니다.
기본 메뉴에서 Visual Studio의 Unreal Engine 도구 모음을 활성화하기 위해 보기>도구 모음>Unreal Engine을 이용합니다. 도구 모음은 다음과 같습니다.
도구 모음 버튼, 왼쪽에서 오른쪽으로:
- 오른쪽 드롭다운에 나열된 재생 아이콘은 프로세스에 연결하는 빠른 연결 버튼입니다. 드롭다운에는 Unreal Engine 관련 프로세스가 나열되므로 Unreal Engine 편집기에서 더 쉽게 연결이 가능합니다. 이를 통해 모든 프로세스에 연결할 수도 있습니다.
- Unreal Engine 통합 서버를 시작하고 중지하는 버튼입니다. Visual Studio와 Unreal Engine 통합의 성능을 통합 서버가 향상시킵니다. 프로젝트에서 작업할 때 테스트 정보를 자동으로 업데이트하며, 백그라운드 프로세스로 실행됩니다. 기기 리소스를 회수하려면 이를 끌 수 있으며, 통합 개선이 필요할 때 시작할 수 있습니다. UE 프로젝트를 Visual Studio에서 열면 서버가 자동으로 시작됩니다.
- Unreal Engine 청사진 자산을 다시 검사하는 버튼입니다. 이렇게 하면 Visual Studio 솔루션이 Unreal Engine 프로젝트의 최신 청사진 자산으로 업데이트됩니다.
- Unreal Engine 로그 창을 여는 버튼입니다.
- Unreal Engine 통합 구성 창을 열고 전체 구성 상태 및 Visual Studio 통합 도구 상태를 확인하고, 청사진 지원을 확인하며, Unreal Engine 명명 규칙 검사기 상태 가져오기 등을 확인할 수 있는 버튼입니다.
명령줄 인수 드롭다운
내부 루프의 편집 및 디버깅 부분에서 명령줄 인수의 다양한 조합으로 게임을 자주 시작할 수 있습니다. 이제 명령줄 인수 드롭다운이 더 쉬워집니다.
명령줄 인수 드롭다운은 표준 도구 모음의 솔루션 플랫폼 드롭다운 다음에 표시됩니다. C:\UE\LyraStarterGame\LyraStarterGame.uproject -fullscreen 및 C:\UE\LyraStarterGame\LyraStarterGame.uproject -JsonDebugOutput에 대한 항목이 있습니다.
명령줄 인수를 추가하려면 드롭다운에 입력하고 Enter 키를 누릅니다. 인수는 입력한 순서대로 저장되고 나중에 사용할 수 있도록 드롭다운에 표시됩니다.
새 명령줄을 위한 공간을 확보하기 위해 가장 오래된 명령줄을 제거하기 전에 추가할 수 있는 명령줄은 5개로 제한됩니다.
Unreal Engine 편집기에서 실행되는 Unreal Engine 프로젝트를 디버깅할 때 첫 번째 인수는 프로젝트의 경로여야 합니다. 예: C:\UE\LyraStarterGame\LyraStarterGame.uproject
명령줄 인수 드롭다운 사용에 대한 자세한 내용은 디버깅하는 동안 명령줄 인수 전달(C++)을 참조하세요.
다음 단계
Visual Studio에서 Unreal Engine 클래스, 모듈 및 플러그인 추가하기
Visual Studio에서 Unreal Engine 청사진 보기
Visual Studio에서 Unreal Engine 로깅 보기
Visual Studio에서 Unreal Engine 매크로 보기