> ## 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.

# GDK 프로젝트 템플릿으로 새 PC 타이틀 시작

> Direct3D 12, Gaming Runtime, 정적 라이브러리, DLL, makefile 빌드용 다섯 개의 GDK Visual Studio 프로젝트 템플릿으로 새 PC Desktop 타이틀을 시작하세요.

이 항목은 GDK 프로젝트 템플릿을 사용해 새 타이틀 개발을 시작하는 방법을 설명합니다.

<Note>
  Gaming Runtime을 사용해 PC Desktop을 타깃으로 하는 게임의 경우, Direct3D 12, Direct3D 11, 또는 레거시 Direct3D 9를 자유롭게 사용할 수 있습니다. D3DX9, D3DX10, D3DX11 등 레거시 DirectX SDK 구성 요소를 사용하는 경우 몇 가지 특별한 고려 사항이 있으니 [DirectX Framework 패키지](/build/core-features/common/packaging/packaging-framework-packages) 문서에서 자세한 내용을 확인하세요.
</Note>

## Gaming Runtime용 Visual Studio 프로젝트 템플릿으로 시작하기

Microsoft Game Development Kit(GDK)를 Visual Studio가 설치된 개발 PC에 설치하면 다음 표와 같이 PC Desktop을 타깃으로 하는 다섯 개의 프로젝트 템플릿이 함께 설치됩니다.

| 대상 플랫폼  | 템플릿                                | 설명                                                                                                                                |
| ------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Desktop | Direct3D 12 Desktop Game (Classic) | Gaming Runtime과 표준 x64 MSBuild 플랫폼을 사용해 독립 실행형 PC 게임 실행 파일을 빌드하는 프로젝트를 Visual Studio 프로젝트 시스템에서 생성합니다.                            |
|         | Direct3D 12 Desktop Game           | 독립 실행형 PC 게임 실행 파일을 빌드하는 프로젝트를 Visual Studio 프로젝트 시스템에서 생성합니다.                                                                    |
|         | Direct3D 12 Desktop Game Makefile  | 명령 프롬프트에서 `makefile`을 사용해 PC Desktop 게임을 빌드하기에 적합한 프로젝트를 생성합니다.                                                                   |
|         | Desktop Static Library             | Gaming.Desktop.x64 커스텀 MSBuild 플랫폼을 사용해 정적 라이브러리를 빌드하는 프로젝트를 Visual Studio 프로젝트 시스템에서 생성합니다. PC Desktop을 타깃으로 하는 게임에 포함하기에 적합합니다. |
|         | Desktop DLL                        | Gaming.Desktop.x64 커스텀 MSBuild 플랫폼을 사용해 DLL을 빌드하는 프로젝트를 Visual Studio 프로젝트 시스템에서 생성합니다. PC Desktop을 타깃으로 하는 게임에 포함하기에 적합합니다.      |

이 템플릿에 접근하려면 다음을 수행합니다.

1. Visual Studio를 엽니다.
2. **File** > **New** > **Project**를 선택합니다. **New Project** 대화 상자가 나타납니다.
3. **New Project** 대화 상자에서 **All Languages** 필터를 \*\*C++\*\*로, **All Platforms** 필터를 **Windows**로, **All Project Types**를 **Games**로 설정합니다. 위의 프로젝트 이름으로 검색할 수도 있습니다.
4. Microsoft Game Development Kit 프로젝트 템플릿 목록에서 원하는 프로젝트 템플릿을 선택합니다.
5. **OK**를 선택합니다.

## 적절한 템플릿 사용

### PC Desktop만을 대상으로 하는 게임

PC 장치만을 대상으로 하는 게임을 개발하는 경우, Direct3D 12 Desktop Game 템플릿이 일반적인 출발점입니다. 이 템플릿의 주요 특징은 다음과 같습니다.

* Windows API Family `WINAPI_FAMILY_DESKTOP_APP`을 사용하고 *kernel32.lib*, *user32.lib* 등 일반적인 PC Desktop 라이브러리에 링크합니다. 그 결과 전체 PC Desktop API를 게임에서 사용할 수 있습니다.
* PC Desktop과 호환되는 Direct3D 12 그래픽 구현을 추가할 수 있도록 필요한 헤더와 라이브러리를 포함합니다. 템플릿은 간단한 스왑체인, Direct3D 디바이스, 기본적인 게임 업데이트 및 렌더 루프를 제공합니다.
* 모든 Gaming Runtime 기능을 바로 사용할 수 있도록 *XGameRuntime.lib*에 링크하고 필요한 헤더를 포함합니다.
* XBOX Live API(XSAPI) 확장 라이브러리도 기본적으로 사용 가능합니다. 추가 Microsoft Game Development Kit(GDK) 확장 라이브러리를 함께 추가할 수 있습니다.
* '표준' x64 플랫폼 또는 커스텀 MSBuild 플랫폼 Gaming.Desktop.x64를 기반으로 하는 빌드 구성을 선언합니다. 이는 x64 타깃을 빌드하며, 로컬 디버거를 사용해 개발 PC에서 로컬로 게임을 반복 개발할 것을 전제로 합니다.
* Partner Center에서 얻은 타이틀 정보를 채워 넣을 자리 표시자 정보가 포함된 *MicrosoftGameConfig.mgc* 파일을 생성합니다.

## 참고

* [MicrosoftGame.Config 개요](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
* [Gaming Runtime 시작하기](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/archive/gr-get-started-with-pc-dev-toc)


## Related topics

- [GDKX로 첫 콘솔 타이틀 빌드 및 실행](/ko/home/build-first-title/first-console-title-walkthrough.md)
- [PC 게임 개발을 위한 Visual Studio 프로젝트 템플릿](/ko/tools/tools-pc/visualstudio/gr-vs-templates.md)
- [새로운 GDK 타이틀 개발하기](/ko/home/build-first-title/developing-new-titles.md)
- [XBOX 개발용 Visual Studio 프로젝트 템플릿](/ko/tools/tools-console/visualstudio/durango-visual-studio-templates.md)
- [XBOX 게임 개발 문서](/ko/index.md)