Skip to main content
이는 가이드 경로의 3단계입니다. 여기서 시작하기 전에 GDK 설정 및 설치에서 GDK를 설치하고 샘플을 빌드하세요. 모든 GDK 게임은 Visual Studio 프로젝트에서 시작합니다. 게임이 어디에서 실행될지에 따라 템플릿을 선택합니다: Windows PC 전용, XBOX 콘솔 전용, 또는 동일한 코드로 두 대상 모두. 나중에 다른 대상을 추가할 수 있으므로 지금 확정할 필요는 없습니다.
어떤 대상을 선택해야 할지 확실하지 않다면, Windows PC가 있고 아직 개발 키트가 없는 경우 Desktop(Gaming.Desktop.x64)으로 시작하세요. 모든 것을 로컬에서 테스트할 수 있습니다. 개발 키트를 받은 후에 XBOX 대상을 추가하세요.

​
프로젝트 템플릿

GXDK를 설치하면 Visual Studio에 9개의 GDK 프로젝트 템플릿이 추가됩니다: PC용 5개와 XBOX 콘솔용 4개.

​
프로젝트 생성

  1. Visual Studio를 엽니다.
  2. File > New > Project로 이동합니다.
  3. All Languages에서 **C++**를 선택합니다. All Platforms에서 XBOX 또는 Windows를 선택합니다. All Project Types에서 Games를 선택합니다. 템플릿 이름으로 검색할 수도 있습니다.
  4. 템플릿을 선택하고 OK를 클릭합니다.

​
템플릿 선택

​
PC 전용

Direct3D 12 Desktop Game으로 시작하세요.
  • WINAPI_FAMILY_DESKTOP_APP을 사용하며 kernel32.lib 및 user32.lib를 포함한 전체 PC 라이브러리와 링크됩니다.
  • D3D12용 헤더와 라이브러리가 포함됩니다. 간단한 스왑 체인, D3D 디바이스, 업데이트/렌더 루프를 제공합니다.
  • XGameRuntime.h가 포함되며 XGameRuntime.lib와 링크됩니다. 모든 GDK Gaming Runtime 기능을 바로 사용할 수 있습니다.
  • XSAPI 확장 라이브러리를 기본적으로 사용할 수 있습니다.
  • 표준 x64 플랫폼 또는 사용자 지정 Gaming.Desktop.x64 플랫폼으로 빌드합니다.
  • Partner Center 신원용 자리 표시자가 포함된 MicrosoftGameConfig.mgc 파일을 만듭니다.

​
XBOX 전용

Direct3D 12 XBOX Game으로 시작하세요.
  • WINAPI_FAMILY_GAMES를 사용하며 XGamePlatform.lib와 링크됩니다.
  • XBOX D3D12.x 확장에 사용할 준비가 된 D3D12 헤더가 포함됩니다.
  • XGameRuntime.h가 포함되며 XGameRuntime.lib와 링크됩니다.
  • XSAPI 확장 라이브러리를 기본적으로 사용할 수 있습니다.
  • 원격 디버그 기대치가 있는 Gaming.XBOX.XboxOne.x64 MSBuild 플랫폼을 사용합니다.
  • 자리 표시자가 포함된 MicrosoftGameConfig.mgc 파일을 만듭니다.

​
PC 및 XBOX (공유 코드베이스)

예를 들어 Direct3D 12 Desktop Game 같은 템플릿 하나로 시작한 다음 Gaming.XBOX.XboxOne.x64(또는 그 반대)를 대상으로 하는 두 번째 빌드 구성을 추가합니다. #define 또는 #ifdef 가드로 소스 코드를 조정하거나, 플랫폼별 코드를 별도의 DLL로 분리하세요:
  • PC 구성은 표준 D3D12를 사용합니다.
  • XBOX 구성은 D3D12.x를 사용합니다.
활성 구성을 전환하면 디버거, 링크된 라이브러리 및 기타 도구 설정이 자동으로 변경됩니다.

​
개발 키트에서 엔드-투-엔드 출시

더 깊은 경로를 선택하기 전에 실습형 콘솔 워크스루를 진행하세요. 방금 만든 Direct3D 12 XBOX Game 템플릿을 XBOX 개발 키트에서 실행되는 loose 배포까지 이어가고, 거기서 설치 가능한 XVC를 만들어 냅니다.

GDKX로 첫 콘솔 타이틀 빌드 및 실행

14단계 튜토리얼: GDK 에디션 고정, DirectXTK12 추가, XBOX Series X|S 콘솔용 빌드, 개발 키트에 배포, 실행 실패 진단, 설치 가능한 XVC 생성.

​
다음 단계

프로젝트가 빌드됩니다. 여러분이 출시하려는 것에 맞는 큐레이팅된 경로를 선택하세요. 이 가이드는 다음에 필요한 더 깊은 문서(Build, Services, Optimize, Publishing, API References)로 안내합니다.

포팅

다른 플랫폼에서 출시된 타이틀을 포팅합니다.

XBOX Play Anywhere

한 번의 구매로 PC와 콘솔에서. 공유된 저장.

XBOX Series X|S 콘솔

콘솔 우선: Quick Resume, DirectStorage, Smart Delivery.

Windows 및 ROG XBOX Ally

Windows PC 및 휴대용 기기에 출시합니다.

Unreal Engine

Unreal용 GDK 플러그인 및 플랫폼 확장.

Unity

PC 및 XBOX용 Unity 통합.

Godot 및 커뮤니티 엔진

Godot, GameMaker, 사용자 지정 엔진 관련 참고.
대부분의 타이틀은 신원, 멀티플레이어, 리더보드, 경제 시스템, 라이브 옵스를 위해 GDK를 PlayFab과 함께 사용합니다. 프로젝트가 빌드된 이후 언제든지 연결할 수 있습니다.

​
참고 자료

마지막 수정일 2026년 8월 4일

관련 항목

GDKX로 첫 콘솔 타이틀 빌드 및 실행크로스 제너레이션 게임XDK 및 GDK 타이틀 버전에서의 멀티플레이어 초대XBOX GDK로의 포팅 가이드이벤트 기반 업적 개요