Microsoft 게임 개발 키트를 설치한 후 빌드 환경 구성
이 항목에서는 압축을 푼 Microsoft GDK(게임 개발 키트) 내에서 빌드 환경 및 명령 프롬프트를 구성하는 방법을 설명합니다. Microsoft GDK(게임 개발 키트)의 압축을 풀고 제대로 작동하려면 이후 추가 단계가 필요하기 때문입니다.
환경 변수 명령 파일
Microsoft GDK(게임 개발 키트)에는 환경 변수를 정의하는 데 사용되는 .cmd 파일 집합이 포함되어 있습니다. 이들은 명령줄 연산(MSBuild를 사용한 빌드 포함)에 액세스하기 위한 명령 프롬프트를 올바르게 만드는 데 필요합니다.
이러한 .cmd 파일의 인스턴스에는 두 가지가 있습니다. 다음의 압축을 푼 예제 파일 위치에서 찾을 수 있습니다.
- C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd
- C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingDesktopVars.cmd
이들 파일을 검사하면 환경 변수를 정의하고 검색하는 방법을 더 효과적으로 파악할 수 있습니다. 대부분의 환경 변수는 IF NOT 검사를 기반으로 설정되므로 실행 전에 먼저 설정하면 재정의될 수 있습니다.
첫 번째 입력 변수 %1은 플랫폼 및 Visual Studio 버전을 결정하는 데 사용됩니다. 여기에 사용할 수 있는 값은 다음과 같습니다.
- GamingXboxVS2019
- GamingXboxVS2022
- GamingXboxScarlettVS2019
- GamingXboxScarlettVS2022
- GamingDesktopVS2019
- GamingDesktopVS2022
(명령줄에서) 이를 사용하는 예는 GamingXboxVars.cmd GamingXboxVS2022입니다.
그러면 Xbox 및 Visual Studio 2022 작업을 위해 정의된 환경 변수를 사용하여 명령 프롬프트가 설정됩니다. 다음 섹션에서는 압축을 푼 키트 파일을 참조하는 명령 프롬프트를 설정하기 위해 재정의해야 하는 환경 변수에 대해 자세히 설명합니다.
Gaming.Xbox.XboxOne.x64 및 Gaming.Xbox.Scarlett.x64에 대한 환경 변수 구성
Microsoft GDK(게임 개발 키트) 명령 프롬프트에서 GamingXboxVars.cmd를 호출하기 전에 압축을 푼 위치를 참조하고 로컬 설치 확인을 재정의하려면 다음 환경 변수를 설정해야 합니다.
- GXDKEDITION: GXDK(게임 Xbox 개발 키트)의 버전 번호입니다. 예를 들어 220300은 2022년 3월 Microsoft GDK(게임 개발 키트)를 의미합니다.
- GameDK: Microsoft GDK(게임 개발 키트)의 루트 위치입니다.
- GameDKLatest: 루트 위치 아래의 최신 버전 번호 폴더입니다.
- WindowsSdkDir: Windows 10 SDK의 위치입니다.
- GamingGRDKBuild: GRDK(게임 런타일 개발 키트) 관련 파일의 위치입니다.
- GamingGXDKBuild: Microsoft GDK(게임 개발 키트) 관련 파일의 위치입니다.
- VSInstallDir: Visual Studio 설치의 위치입니다.
이러한 환경 변수를 압축을 푼 예제 파일을 가리키도록 설정하는 예제 명령은 다음과 같습니다.
SET GXDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GXDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GXDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "GamingGXDKBuild=%GameDKLatest%GXDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
이전 섹션에서 설명한 GamingXboxVars.cmd 입력 변수를 사용하여 Xbox One과 Xbox Series X|S 환경 사이에서 전환할 수 있습니다.
Gaming.Desktop.x64에 대한 환경 변수 구성
Microsoft GDK(게임 개발 키트) 명령 프롬프트에서 GamingDesktopVars.cmd를 호출하기 전에 압축을 푼 위치를 참조하고 로컬 설치 확인을 재정의하려면 다음 환경 변수를 설정해야 합니다.
- GRDKEDITION: GRDK(게임 런타임 개발 키트)의 버전 번호입니다. 예를 들어 220300은 2022년 3월 Microsoft GDK(게임 개발 키트)를 의미합니다.
- GameDK: Microsoft GDK(게임 개발 키트)의 루트 위치입니다.
- GameDKLatest: 루트 위치 아래의 최신 버전 번호 폴더입니다.
- WindowsSdkDir: Windows 10 SDK의 위치입니다.
- GamingGRDKBuild: GRDK(게임 런타일 개발 키트) 파일의 위치입니다.
- VSInstallDir: Visual Studio 설치의 위치입니다.
이러한 환경 변수를 압축을 푼 예제 파일을 가리키도록 설정하는 예제 명령은 다음과 같습니다.
SET GRDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GRDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GRDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
명령 프롬프트 설정
명령 프롬프트는 Microsoft GDK(게임 개발 키트)가 설치될 때 적절한 Microsoft GDK(게임 개발 키트) 명령 프롬프트 .cmd 파일의 바로 가기로 만들어집니다. 다음은 그 예입니다.
C:\Windows\System32\cmd.exe /k "C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd" GamingXboxVS2022
위 내용으로 바로 가기를 생성하면 설치된 명령 프롬프트 스크립트와 동일한 환경 설정이 제공됩니다. 위의 환경 변수를 설정한 다음 적절한 입력 변수로 이를 실행하는 스크립트를 래핑하는 것이 권장되는 구성 방법입니다.
Microsoft GDK(게임 개발 키트)의 Lib 및 Include 참조
환경 변수 스크립트는 Lib 및 Include 경로에 대한 다음 위치를 설정합니다. Gaming.Xbox.Scarlett.x64에 대한 다음 예제는 참조용으로 제공되며 재정의해서는 안 됩니다(이 예제에서 MSVC Tools 버전은 VCToolsVersion 환경 변수에서 파생됨).
INCLUDE=C:\Program Files (x86)\Windows Kits\10\Include\um;C:\Program Files (x86)\Windows Kits\10\Include\shared;C:\Program Files (x86)\Windows Kits\10\Include\winrt;C:\Program Files (x86)\Windows Kits\10\Include\cppwinrt;C:\Program Files (x86)\Windows Kits\10\Include\ucrt;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\include;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\INCLUDE;
LIB=C:\Program Files (x86)\Windows Kits\10\Lib\um\x64;C:\Program Files (x86)\Windows Kits\10\Lib\ucrt\x64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\lib\amd64;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\lib\x64;
LIBPATH=C:\Windows\Microsoft.NET\Framework\v4.0.30319;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\
Windows 10 SDK의 Lib 및 Include 참조
환경 변수 스크립트는 Windows 10 SDK의 Lib & Include 경로에 대한 다음 위치를 설정합니다. 다음 예제는 참조용으로 제공되며 재정의해서는 안 됩니다.
WindowsIncludeRoot=C:\Program Files (x86)\Windows Kits\10\Include\
WindowsLibRoot=C:\Program Files (x86)\Windows Kits\10\Lib\