Microsoft 게임 개발 키트 설정 페이로드 추출

이 문서에서는 설치하지 않고 사용할 수 있는 추출된 Microsoft GDK(게임 개발 키트)를 가져오는 프로세스를 설명합니다. 이 섹션에서는 Microsoft 게임 개발 키트 및 Windows 10 SDK에서 이 작업을 수행하는 방법에 대한 지침을 제공합니다. 이 프로세스는 고급 사용자를 위한 것입니다.

참고 항목

이 프로세스를 수행하더라도 대부분의 시나리오에서 Microsoft GDK(게임 개발 키트)를 설치해야 합니다. 이 프로세스를 통해 다음 시나리오를 사용할 수 있습니다.

1. 빌드 프로세스에서 사용할 머리글 및 라이브러리의 압축을 풉니다.
2. 전체 Microsoft GDK(게임 개발 키트)를 설치하지 않고 지정된 Microsoft GDK(게임 개발 키트)에서 xbprovision(NDA 항목)권한 부여 필요을 실행할 수 있도록 사이드로드 폴더의 압축을 풉니다.

이런 방법으로 설치 페이로드의 압축을 푼 후 Microsoft GDK(게임 개발 키트) 도구 중 일부를 실행할 수 있지만, 이렇게 하는 것은 공식적으로 지원되지 않으므로 문제가 발생할 수 있습니다.

추출된 Microsoft 게임 개발 키트 다운로드

추출된 Microsoft GDK(게임 개발 키트)는 고급 사용자에게 적합한 옵션으로 전체 Microsoft GDK(게임 개발 키트)를 설치하지 않고도 특정 파일을 빌드 시스템에 통합할 수 있게 해 줍니다. 추출된 Microsoft GDK(게임 개발 키트)는 Xbox 개발자 다운로드사이트에서 별도의 다운로드 옵션으로 사용할 수 있습니다. 다운로드 옵션은 타이틀에 추출(Extracted)이라는 단어를 수록하여 GDK 설치 관리자 다운로드 옵션과 차별화합니다.

팁

이 다운로드 옵션을 사용하면 Microsoft 게임 개발 키트에 대한 수동 추출 프로세스를 건너뛸 수 있습니다. 이 옵션을 사용하는 것이 좋습니다.

Microsoft 게임 개발 키트 수동 추출

추출된 Microsoft GDK(게임 개발 키트)를 다운로드하는 대신 일반 Microsoft GDK(게임 개발 키트) 설치 관리자에서 파일을 수동으로 추출할 수 있습니다. 일반 Microsoft GDK(게임 개발 키트)를 다운로드한 후에 Windows Installer(msiexec.exe)를 사용하여 개별 파일에 액세스할 수 있는 각 설치 관리자 패키지의 압축을 풀 수 있습니다.

팁

다음 절차에서는 Windows Installer(msiexec.exe)의 특정 사용을 보여 줍니다. Msiexec.exe에 대한 자세한 내용은 Windows Installer를 참조하세요.

모든 Microsoft GDK(게임 개발 키트) MSI의 콘텐츠 추출(ExtractXboxOneDKs.cmd 사용)

1. Xbox 개발자 다운로드 사이트에서 Microsoft 게임 개발 키트 설치 관리자를 다운로드합니다. 또는 GitHub 리포지토리에서 공용 Microsoft GDK(게임 개발 키트) 설치 관리자를 다운로드합니다(PC 개발만 지원). 다운로드한 파일의 이름은 GDK_03_2022.zip과 같습니다. 컴퓨터에서 해당 위치를 참고합니다.
2. 로컬 .zip 파일의 압축을 풉니다.
3. 명령 프롬프트를 열고 콘텐츠 압축을 푼 폴더 내의 SetupScripts 디렉터리로 이동합니다(예: C:\GDKDownload\SetupScripts)
   • 이 디렉터리의 ExtractXboxOneDKs.cmd 스크립트를 사용하여 GDK의 압축을 풀 수 있습니다. 사용법은 다음과 같습니다.
     • ExtractXboxOneDKs.cmd MSI_Source_Folder Target_Directory
     • 예를 들어 MSI_Source_Folder는 .zip 파일을 압축 해제한 위치입니다(예: C:\GDKDownload). 대상 디렉터리는 추출된 콘텐츠가 이동하는 위치입니다(예: C:\ExtractedGDK\220300).
4. ExtractXboxOneDKs.cmd 스크립트를 실행하면 추출된 파일이 대상 디렉터리(예: C:\ExtractedGDK\220300)에 존재합니다.
5. 대상 디렉터리로 이동하여 압축을 푼 GDK 파일을 빌드 시스템에서 요구하는 위치에 복사합니다.

참고 항목

대상 디렉터리에는 압축 풀기의 일부로 .msi 파일 집합과 Windows Kits 폴더가 포함됩니다. 이러한 항목은 무시해야 하며 삭제할 수 있습니다. Microsoft GDK 폴더는 압축 풀기 대상 디렉터리에서 유지해야 하는 유일한 폴더입니다.

모든 Microsoft GDK(게임 개발 키트) MSI의 콘텐츠 추출(수동)

1. GDK의 압축을 푼 후(위 1~2단계), Windows Installer(msiexec.exe)를 사용하여 개별 파일에 액세스할 수 있는 각 설치 관리자 패키지의 압축을 풀 수 있습니다.

2. 명령 프롬프트 창에서 .zip 파일에서 압축을 푼 파일이 있는 폴더로 이동하고 다음 명령줄을 실행합니다.
   

   for /F "delims=" %G in ('dir /b /s "installation_folder\*.msi"') DO (
   start /wait msiexec.exe /a "%G" TARGETDIR="msi_extraction_path" /qb
   )  
   

   여기서 installation_folder는 GDK 다운로드의 파일 경로이고, msi_extraction_path는 Windows Installer(.msi)의 파일을 압축을 풀어 저장할 폴더를 지정합니다. 예:
   

   for /F "delims=" %G in ('dir /b /s "C:\GDKDownload\*.msi"') DO (
   start /wait msiexec.exe /a "%G" TARGETDIR="C:\ExtractedGDK\220300\" /qb
   )  
   

   참고 항목

   이 코드 예시가 명령줄에서 직접 사용되는 대신 스크립트에서 사용되는 경우 %G를 %%G로 교체해야 합니다.

3. msi_extraction_path로 이동하여 압축을 푼 GDK 파일을 빌드 시스템에서 요구하는 위치에 복사합니다.

Windows 10 SDK 추출

Windows 10 SDK 설치 페이로드의 수동 압축 풀기는 전체 Windows SDK를 설치하지 않고 특정 파일을 빌드 시스템에 통합할 수 있게 해주는 고급 사용자에게 적합한 옵션입니다. Windows 10 SDK가 시스템에 설치되어 있으면 추출된 Microsoft GDK(게임 개발 키트)를 사용하기 위해 이 단계를 수행할 필요가 없습니다.

모든 Windows 10 SDK MSI의 콘텐츠 추출(ExtractXboxOneDKs.cmd 사용)

참고 항목

2020년 5월 GDK부터 GDK에는 이제 20H1 버전의 Windows 10 SDK(버전 10.0.19041.0) 이상이 필요합니다.

참고 항목

2023년 10월 GDK를 기준으로 GDK에는 이제 Windows 11 SDK(버전 10.0.22000.0) 이상이 필요합니다.

1. Windows 개발자 센터에서Windows SDK 설치 관리자를 다운로드합니다. 다운로드하는 파일에는 winsdksetup.exe와 같은 이름이 지정됩니다. 컴퓨터에서 해당 위치를 참고합니다.

2. 명령 프롬프트를 열고 exe가 다운로드된 디렉터리에서 winsdksetup.exe /layout C:\WinSDKDownload를 실행합니다(이를 통해 exe에서 msi 파일의 압축을 풀 수 있음).

3. UI를 단계별로 실행하고 모든 확인란을 선택된 상태로 두고 모든 파일을 다운로드하도록 합니다.

4. C:\WinSDKDownload로 이동하여 .msi 파일이 있는지 확인합니다.

   팁

   또는 Windows SDK 를 다운로드할 수 있습니다. ISO를 탑재합니다. 여기에는 1-4단계에서 생성한 것과 동일한 .msi 파일이 포함됩니다.

5. 위의 모든 Microsoft GDK(게임 개발 키트) MSI(Extracting Contents)(ExtractXboxOneDKs.cmd 사용)의 콘텐츠 추출 에 설명된 스크립트를 사용하여 MSI_Source_Folder 대한 msi 폴더(예: C:\WinSDKDownload)와 추출된 콘텐츠가 갈 대상 디렉터리에 대한 다른 폴더(예: C:\ExtractedWinSDK)를 가리킵니다.

   참고 항목

   포함된 파일의 경로가 길기 때문에 소스 및 대상 디렉터리(압축 풀기에만 해당)를 45자로 제한하는 것이 좋습니다(드라이브 문자 포함). 그런 다음 압축 풀기가 완료된 후 이동할 수 있습니다. 폴더 경로에서 45자를 초과하면 최대 파일 경로 길이를 초과하여 압축 풀기가 실패합니다.

6. ExtractXboxOneDKs.cmd 스크립트를 실행하면 추출된 파일이 대상 디렉터리(예: C:\ExtractedWinSDK)에 존재합니다.

7. 대상 디렉터리로 이동하여 압축을 푼 Windows SDK 파일을 빌드 시스템에서 요구하는 위치에 복사합니다.

   참고 항목

   이 압축 풀기 후에 대상 디렉터리에 많은 파일/폴더가 존재합니다. Windows Kits\10 폴더는 이 예제에서 빌드 시스템 참조를 위해 사용되는 폴더입니다. 원하는 작업에 따라 다른 폴더가 필요할 수 있습니다.

모든 Windows 10 SDK MSI의 압축 풀기(수동)

1. winsdksetup.exe의 .msi 파일 집합을 얻은 후(위 1~4단계), Windows Installer(msiexec.exe)를 사용하여 개별 파일에 액세스할 수 있는 각 설치 관리자 패키지의 압축을 풀 수 있습니다.

2. 명령 프롬프트 창에서 .zip 파일에서 압축을 푼 파일이 있는 폴더로 이동하고 다음 명령줄을 실행합니다.
   

   for /F "delims=" %G in ('dir /b /s "installation_folder\*.msi"') DO (
   start /wait msiexec.exe /a "%G" TARGETDIR="msi_extraction_path" /qb
   )  
   

   여기서 installation_folder는 WIn10 SDK 다운로드의 파일 경로이고, msi_extraction_path는 Windows Installer(.msi)의 파일을 압축을 풀어 저장할 폴더를 지정합니다. 예:
   

   for /F "delims=" %G in ('dir /b /s "C:\WinSDKDownload\*.msi"') DO (
   start /wait msiexec.exe /a "%G" TARGETDIR="C:\ExtractedWinSDK" /qb
   )  
   

   참고 항목

   이 코드 예시가 명령줄에서 직접 사용되는 대신 스크립트에서 사용되는 경우 %G를 %%G로 교체해야 합니다.

3. msi_extraction_path로 이동하여 압축을 푼 Windows SDK 파일을 빌드 시스템에서 요구하는 위치에 복사합니다.

추출된 여러 Microsoft GDK(게임 개발 키트) 버전을 지원하기 위한 권장 레이아웃

Microsoft GDK(게임 개발 키트) 압축 해제 시 이 폴더가 타이틀 빌드 시 액세스할 공유 위치 또는 소스 제어 시스템에 위치하는 것으로 가정합니다. 여러 버전의 Microsoft GDK(게임 개발 키트)가 필요한 시나리오가 있을 수 있습니다. 이 시나리오에서는 추출된 여러 Microsoft GDK(게임 개발 키트) 버전의 레이아웃에 대한 권장 사항은 다음과 같습니다.

• ...\ExtractedGDK\211000\Microsoft GDK...
• ...\ExtractedGDK\220300\Microsoft GDK...

이렇게 하면 각 버전에 전체 페이로드가 제공됩니다. 빌드 환경 변수를 사용하여 버전 간 전환으로 빌드 컴파일 프로세스 도중 사용되는 항목을 정의하는 것이 좋습니다.

참고 항목

Microsoft GDK(게임 개발 키트)를 설치하지 않고 빌드 환경 구성

설치하지 않고 Microsoft GDK(Microsoft 게임 개발 키트) 사용