解壓縮 Microsoft Game Development Kit (GDK) 安裝承載

本文件說明如何取得已解壓縮的 Microsoft Game Development Kit (GDK)，以便在不安裝的情況下使用。本節提供針對 GDK 和 Windows SDK 執行此操作的指示。此流程適用於進階使用者。

​

下載已解壓縮的 Microsoft Game Development Kit

已解壓縮的 Microsoft Game Development Kit (GDK) 是提供給進階使用者的選項，可讓特定檔案整合到建置系統中，而不需安裝完整的 Microsoft Game Development Kit (GDK)。已解壓縮的 Microsoft Game Development Kit (GDK) 可在 XBOX Developer Downloads 網站上以個別下載選項的形式取得。此下載選項的標題中會列出 Extracted 一字，以便與 GDK 安裝程式下載選項區分。

​

手動解壓縮 Microsoft Game Development Kit

除了下載已解壓縮的 Microsoft Game Development Kit (GDK) 之外，您也可以從一般的 Microsoft Game Development Kit (GDK) 安裝程式手動解壓縮檔案。下載一般的 Microsoft Game Development Kit (GDK) 之後，您可以使用 Windows Installer (msiexec.exe) 解壓縮每個安裝程式套件，以存取其個別檔案。

​

解壓縮所有 Microsoft Game Development Kit (GDK) MSI 的內容 (使用 ExtractXboxOneDKs.ps1)

1. 從 XBOX Developer Downloads 網站下載 Microsoft Game Development Kit 安裝程式。或者，從 GitHub 存放庫下載公開的 Microsoft Game Development Kit (GDK) 安裝程式 (僅支援 PC 開發)。 您下載的檔案名稱會類似 GDK_03_2022.zip。請記下它在您電腦上的位置。
2. 解壓縮本機 .zip 檔案的內容。
3. 開啟 PowerShell 提示字元，並瀏覽至內容解壓縮目的地資料夾內的 SetupScripts 目錄 (例如 C:\GDKDownload\SetupScripts)
   • 此目錄中的 ExtractXboxOneDKs.ps1 指令碼可用來解壓縮 GDK。其用法如下：
     • .\ExtractXboxOneDKs.ps1 -SourcePath <MSI_Source_Folder> -TargetDirectory <Target_Directory>
     • 例如，SourcePath 是 .zip 檔案的解壓縮位置 (例如 C:\GDKDownload)。TargetDirectory 是解壓縮內容的存放位置 (例如 C:\ExtractedGDK\220300)
4. 執行 ExtractXboxOneDKs.ps1 指令碼之後，解壓縮的檔案會位於目標目錄中 (例如 C:\ExtractedGDK\220300)
5. 瀏覽至目標目錄，然後將解壓縮的 GDK 檔案複製到您建置系統所需的位置。

​

解壓縮所有 Microsoft Game Development Kit (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 SDK

手動解壓縮 Windows SDK 安裝承載是提供給進階使用者的選項，可讓特定檔案整合到建置系統中，而不需安裝完整的 Windows SDK。只要系統上已安裝 Windows SDK，使用已解壓縮的 Microsoft Game Development Kit (GDK) 就不需要執行此步驟。

​

解壓縮所有 Windows SDK MSI 的內容 (使用 ExtractXboxOneDKs.ps1)

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 Game Development Kit (GDK) MSI 的內容 (使用 ExtractXboxOneDKs.ps1) 中提及的指令碼，將 SourcePath 指向 msi 資料夾 (例如 C:\WinSDKDownload)，並將 TargetDirectory 指向用來存放解壓縮內容的另一個資料夾 (例如 C:\ExtractedWinSDK)。
   由於所含檔案的路徑很長，建議將來源和目標目錄 (僅限解壓縮時) 限制在 45 個字元以內 (包括磁碟機代號)。解壓縮完成後，即可移動這些目錄。資料夾路徑超過 45 個字元將導致解壓縮失敗，因為超過檔案路徑長度上限。
6. 執行 ExtractXboxOneDKs.ps1 指令碼之後，解壓縮的檔案會位於目標目錄中 (例如 C:\ExtractedWinSDK)
7. 瀏覽至目標目錄，然後將解壓縮的 Windows SDK 檔案複製到您建置系統所需的位置。
   此解壓縮完成後，目標目錄中會有許多檔案/資料夾。Windows Kits\10 資料夾是此範例中供建置系統參考所使用的資料夾。視所需動作而定，可能需要其他資料夾。

​

解壓縮所有 Windows 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 是 Windows 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 Game Development Kit (GDK) 版本的建議配置

解壓縮 Microsoft Game Development Kit 時，會假設此資料夾將存放於共用位置或原始檔控制系統中，以便在建置您的遊戲時存取。在某些案例中，可能需要多個版本的 Microsoft Game Development Kit (GDK)。在此案例中，我們對多個已解壓縮 Microsoft Game Development Kit (GDK) 版本的配置建議如下：

• …\ExtractedGDK\211000\Microsoft GDK…
• …\ExtractedGDK\220300\Microsoft GDK…

這可讓每個版本都具備完整的承載。我們建議您使用建置環境變數在版本之間切換，以定義建置編譯流程中所使用的版本。

​

另請參閱

在不安裝 Microsoft Game Development Kit (GDK) 的情況下設定建置環境 在不安裝的情況下使用 Microsoft Game Development Kit (GDK)