> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX Series X|S 및 XBOX One용 Visual Studio 구성하기

> XBOX Series X|S 및 XBOX One 빌드를 위한 Visual Studio 구성

Visual Studio를 사용하여 단일 프로젝트나 솔루션 안에서 타이틀의 XBOX Series X|S 및 XBOX One 버전을 모두 빌드할 수 있습니다. Visual Studio를 이러한 방식으로 사용하면 XBOX One과 XBOX Series X|S 세대를 모두 대상으로 하는 타이틀을 빌드하는 데 필요한 소스 코드와 빌드 구성 차이를 더 쉽게 관리할 수 있습니다.

코드 구조와 빌드 프로세스 설계에 따라 특정 바이너리의 XBOX One 및 XBOX Series X|S 버전을 같은 프로젝트 내에서 또는 같은 솔루션 내의 다른 프로젝트에서 빌드하도록 선택할 수 있습니다. XBOX Series X|S와 XBOX One 사이에서 코드가 대체로 동일한 바이너리(예: 비그래픽 코드)의 경우 동일한 프로젝트에서 빌드하는 것이 합리적일 수 있습니다. 두 플랫폼 사이에서 코드가 상당히 다른 프로젝트의 경우 별도의 프로젝트가 관리하기 더 쉬울 수 있습니다.

Visual Studio의 플랫폼 개념을 사용하여 XBOX Series X|S 빌드의 구성 설정을 XBOX One 빌드에 필요한 설정과 분리합니다.

Microsoft Game Development Kit (GDK)에서 제공하는 Visual Studio 템플릿을 사용하여 만든 프로젝트에는 XBOX One 및 XBOX Series X|S 플랫폼 모두에 대한 정의가 포함되어 있습니다. XBOX One 플랫폼의 이름은 `Gaming.Xbox.XboxOne.x64`입니다. XBOX Series X|S 플랫폼의 이름은 다음 스크린샷과 같이 `Gaming.Xbox.Scarlett.x64`입니다.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_scarlett_config.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=43dd3823fa1808f1d6991e6a4f5c3471" alt="Gaming.Xbox.XboxOne.x64 및 Gaming.Xbox.Scarlett.x64 플랫폼을 보여주는 Visual Studio 템플릿 스크린샷" width="228" height="121" data-path="images/gdk/tools/vs_scarlett_config.png" />

`Gaming.Xbox.XboxOne.x64`와 `Gaming.Xbox.Scarlett.x64` 플랫폼은 XBOX One 또는 XBOX Series X|S용으로 타이틀을 빌드하는 데 필요한 전처리기 정의, include 및 라이브러리 경로, 기타 설정을 지정합니다. 예를 들어 `Gaming.Xbox.Scarlett.x64` 플랫폼은 다음 전처리기 정의를 설정합니다.

```cpp theme={null}
_GAMING_XBOX_SCARLETT
```

이 플랫폼은 msbuild 속성을 사용하여 include 및 라이브러리 경로 목록에 다음 디렉터리를 추가합니다.

```cpp theme={null}
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\Include\Scarlett
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\lib\amd64\Scarlett
```

`Gaming.Xbox.XboxOne.x64` 플랫폼은 타이틀의 XBOX One 버전을 빌드하는 데 필요한 빌드 환경에 대응하는 변경 사항을 적용합니다.

msbuild로 빌드할 때 다음 코드 예제와 같이 명령줄에서 이러한 플랫폼을 지정합니다.

```cpp theme={null}
msbuild MySolution.sln /p:Configuration=Debug /p:Platform="Gaming.Xbox.Scarlett.x64"
```

## 다른 빌드 시스템 사용

빌드 시스템이 Visual Studio 및 msbuild가 아닌 경우 GDK에 포함된 msbuild .targets 및 .props 파일의 XBOX Series X|S와 XBOX One 버전을 비교하여 세대 간 개발에 필요한 자체 빌드 시스템 변경 사항을 판별할 수 있습니다.

이러한 파일은 *C:\Program Files (x86)\Microsoft GDK\260400\GXDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms* 아래의 `Gaming.Xbox.Scarlett.x64` 및 `Gaming.Xbox.XboxOne.x64` 디렉터리에 설치됩니다.

Visual Studio를 사용하지 않고 빌드하는 데 필요한 특정 설정에 대한 자세한 내용은 [XBOX One용 Microsoft Game Development Kit 포팅 가이드](/build/console-features/porting-from-xbox-one-era/porting-guide-for-existing-era)를 참조하세요.

## 참고 항목

[Visual Studio](/tools/tools-console/visualstudio/visualstudio)


## Related topics

- [Visual Studio](/ko/tools/tools-console/visualstudio/index.md)
- [콘솔 개발을 위한 Visual Studio](/ko/tools/tools-console/visualstudio/visualstudio.md)
- [GDK 툴체인 설치하기](/ko/home/setup-install/download-install.md)
- [GDK에서 Clang/LLVM 사용하기](/ko/tools/tools-pc/visualstudio/gr-vs-clang.md)
- [XBOX용 Address Sanitizer 지원](/ko/tools/tools-console/visualstudio/address-sanitizer-support.md)