1단계: 개발 PC 요구 사항 확인
운영 체제
하드웨어
- GDK 설치를 위한 30GB의 여유 공간이 있는 빠르고 최신의 x64 PC.
- XBOX 대상 개발의 경우 NVMe SSD(방열판 포함), 개발 PC의 10 GbE NIC, Cat 6a 케이블을 사용하는 10 GbE 스위치(개발 PC와 개발 키트가 동일한 서브넷에 있음), Thunderbolt 3 지원 마더보드를 사용하세요.
- 디스플레이 기능을 검증하기 위한 4K 또는 UHD, HDR 지원 디스플레이.
검증된 10 GbE 하드웨어 참조
검증된 10 GbE 하드웨어 참조
- Netgear XS708T 8포트 스위치
- AQuantia Aqtion AQN-107 PCIe 10GBase-T 어댑터
- Intel Ethernet Converged Network Adapter X540-T1
- Samsung SSD 970 EVO NVMe M.2 1 TB
- Category 6a 이더넷 케이블
2단계: Windows SDK 설치
GDK 타이틀은 Win32 기반이므로 Windows SDK는 개발자 환경의 핵심입니다. Direct3D, XAudio, PIX for Windows API, 코어 OS 서비스,WINAPI_FAMILY_GAMES 파티션, xgameplatform.lib, 통합된 GameInput API, Process Lifecycle Management(PLM)를 제공합니다.
최소 필수 버전: Windows SDK 22000 이상(Windows 11 SDK). 독립 실행형으로 설치하거나 Visual Studio Installer의 선택적 구성 요소로 설치할 수 있습니다.
3단계: Visual Studio 설치
Visual Studio 2022 또는 Visual Studio 2026을 C++ 워크로드와 함께 사용하세요.GDK 이후에 새로운 Visual Studio 에디션을 설치하는 경우, 새 에디션과 통합되도록 GDK를 복구하세요. Visual Studio를 제거해야 한다면 GDK를 먼저 제거하세요.
4단계: GDK 다운로드 및 설치
- XBOX GDK 다운로드 페이지에서 GDK와 선택적으로 Game Core for XBOX를 다운로드합니다. 이는 ID@XBOX 액세스가 필요합니다.
- 설치 프로그램을 관리자 권한으로 실행합니다.
- 라이선스 조건에 동의합니다.
- GDK를 선택하고 선택적으로 Game Core for XBOX 구성 요소를 선택합니다.
- 설치 프로그램이 완료될 때까지 기다린 다음 요청 시 재부팅합니다.
GDK에 포함된 것
- Gaming Runtime: MSIXVC 패키징, TCUI, Connected Storage, 비동기 블록, 디바이스 연결, 사용자, TTS, 접근성, Screen Time.
- Gaming Cloud Services: XSAPI, XAL, 멀티플레이어 네트워킹, PlayFab, 인앱 구매 지원 Store.
- Gaming 디바이스 확장: DirectX 12.x, Audio.x, PIX.x,
XMemAlloc및 기타 콘솔 전용 메모리 API.
PC 및 XBOX 도구
PC 게임: 표준 Visual Studio 도구와 PIX for Windows로 로컬에서 반복 작업하고 테스트하고 디버그합니다. 필요에 따라 랩 PC에서 문제를 재현하기 위해 VS Remote Tools를 구성하세요. XBOX 게임: PIX for XBOX,xb* 명령줄 도구, XBOX Manager, Dev Home, XBOX Device Portal(XDP)을 사용하여 XBOX Series X|S 콘솔 또는 XBOX One 제품군 콘솔 개발 키트에서 원격으로 반복 작업합니다.
Microsoft 심볼 서버
Gaming Runtime 심볼을 얻으려면 Microsoft 심볼 서버를 사용하도록 설정하세요. Visual Studio에서 Debug > Options > Symbols로 이동한 다음 Microsoft Symbol Servers를 선택합니다. Microsoft public symbol server 문서를 참조하세요.Build Without Install (BWOI)
BWOI를 사용하면 설치 프로그램을 실행하지 않고도 빌드 서버가 GDK를 사용할 수 있습니다. 이는 CI 및 잠긴 빌드 환경에 매우 중요합니다. GDK 설치 페이로드를 알려진 디렉터리에 추출하고, 빌드 환경 변수가 이를 가리키게 한 다음msbuild 또는 툴체인으로 빌드하세요.
- BWOI는 Visual Studio VSIX 통합을 설치하지 않습니다.
- XBTC 및 makepkg 페이로드 같은 일부 도구는 일회성 추출 단계가 필요합니다.
- 개발자별 개발 키트 및 PIX는 워크스테이션에 여전히 정상적으로 설치됩니다.
원격 Windows 게임 개발
원격 게임 개발 도구를 사용하여 개발 네트워크를 통해 원격 Windows PC에 배포하고 디버그합니다. 이는 예를 들어 Windows 10의 아티스트, Server 2019의 빌드, 별도의 테스트 PC의 대상 등 다중 PC 개발 파이프라인에 도움이 됩니다. Hyper-V 또는 VMware는 일시적인 테스트 이미지에 적합합니다.다음 단계
Visual Studio에서 제공된 샘플을 열어 설치가 작동하는지 확인하세요.GDK 샘플
GDK와 함께 제공되는 참조 샘플입니다.