> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 說明取得已解壓縮之 Microsoft Game Development Kit (GDK) 安裝承載的流程。

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

> [!NOTE]
>
> 在大部分案例中，此流程並不能取代安裝 Microsoft Game Development Kit (GDK) 的需求。此流程可啟用下列案例：
>
> 1. 解壓縮標頭和程式庫，以便在您的建置流程中使用。
> 2. 解壓縮 Sideload 資料夾，以便能夠從指定的 Microsoft Game Development Kit (GDK) 執行 [xbprovision (NDA 主題)](https://learn.microsoft.com/en-us/gaming/gdk/docs/tools/tools-console/commandlinetools/xbprovision)，而不需安裝完整的 Microsoft Game Development Kit (GDK)。
>
> 以此方式解壓縮安裝承載之後，可以執行部分 Microsoft Game Development Kit (GDK) 工具，但這麼做並未獲得正式支援，而且您可能會遇到問題。

## 下載已解壓縮的 Microsoft Game Development Kit

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

> [!TIP]
>
> 使用此下載選項可讓您略過 Microsoft Game Development Kit 的手動解壓縮流程。這是建議的選項。

## 手動解壓縮 Microsoft Game Development Kit

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

> [!TIP]
>
> 下列程序示範 Windows Installer (msiexec.exe) 的特定用法。如需 msiexec.exe 的詳細資訊，請參閱 [Windows Installer](https://learn.microsoft.com/windows/desktop/Msi/windows-installer-portal)。

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

1. 從 [XBOX Developer Downloads](https://aka.ms/gdkdl) 網站下載 Microsoft Game Development Kit 安裝程式。或者，從 [GitHub 存放庫](https://github.com/microsoft/GDK)下載公開的 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 檔案複製到您建置系統所需的位置。

> [!NOTE]
>
> 解壓縮時，目標目錄會包含一組 .msi 檔案和一個 Windows Kits 資料夾。這些項目應予以忽略，並可刪除。Microsoft GDK 資料夾是解壓縮目標目錄中唯一需要保留的資料夾。

### 解壓縮所有 Microsoft Game Development Kit (GDK) MSI 的內容 (手動)

1. 解壓縮 GDK 之後 (上一節中的步驟 1-2)，您可以使用 Windows Installer (msiexec.exe) 解壓縮每個安裝程式套件，以存取其個別檔案。
2. 在命令提示字元視窗中，瀏覽至包含從 .zip 檔案解壓縮之檔案的資料夾，然後執行下列命令列：\


   ```cmd theme={null}
   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) 檔案的檔案解壓縮到的資料夾。例如：\


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

   > [!NOTE]
   >
   > 如果在指令碼中使用此程式碼範例，而不是直接從命令列使用，則必須將 %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)

> [!NOTE]
>
> 從 2023 年 10 月 GDK 開始，GDK 需要 Windows 11 SDK (版本 10.0.22000.0) 或更新版本。

1. 從 [Windows 開發人員中心](https://developer.microsoft.com/windows/downloads/windows-sdk/)下載 Windows SDK 安裝程式。您下載的檔案名稱會類似 winsdksetup.exe。請記下它在您電腦上的位置。

2. 開啟命令提示字元，並在 exe 的下載目錄中執行 **winsdksetup.exe /layout C:\WinSDKDownload** (這會從 exe 解壓縮 msi 檔案)。

3. 逐步完成 UI，保留所有核取方塊的勾選狀態，並讓它下載所有檔案。

4. 瀏覽至 **C:\WinSDKDownload**，確認 .msi 檔案存在。

   > [!TIP]
   >
   > 或者，您可以下載 Windows SDK .ISO 並將其掛接。其中包含與步驟 1-4 所產生相同的 .msi 檔案。

5. 使用上述**解壓縮所有 Microsoft Game Development Kit (GDK) MSI 的內容 (使用 ExtractXboxOneDKs.ps1)** 中提及的指令碼，將 SourcePath 指向 msi 資料夾 (例如 C:\WinSDKDownload)，並將 TargetDirectory 指向用來存放解壓縮內容的另一個資料夾 (例如 C:\ExtractedWinSDK)。

   > [!NOTE]
   >
   > 由於所含檔案的路徑很長，建議將來源和目標目錄 (僅限解壓縮時) 限制在 45 個字元以內 (包括磁碟機代號)。解壓縮完成後，即可移動這些目錄。**資料夾路徑超過 45 個字元將導致解壓縮失敗**，因為超過檔案路徑長度上限。

6. 執行 ExtractXboxOneDKs.ps1 指令碼之後，解壓縮的檔案會位於目標目錄中 (例如 C:\ExtractedWinSDK)

7. 瀏覽至目標目錄，然後將解壓縮的 Windows SDK 檔案複製到您建置系統所需的位置。

   > [!NOTE]
   >
   > 此解壓縮完成後，目標目錄中會有許多檔案/資料夾。Windows Kits\10 資料夾是此範例中供建置系統參考所使用的資料夾。視所需動作而定，可能需要其他資料夾。

### 解壓縮所有 Windows SDK MSI 的內容 (手動)

1. 從 winsdksetup.exe 取得一組 .msi 檔案之後 (上一節中的步驟 1-4)，您可以使用 Windows Installer (msiexec.exe) 解壓縮每個安裝程式套件，以存取其個別檔案。
2. 在命令提示字元視窗中，瀏覽至包含從 .zip 檔案解壓縮之檔案的資料夾，然後執行下列命令列：\


   ```cmd theme={null}
   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) 檔案的檔案解壓縮到的資料夾。例如：\


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

   > [!NOTE]
   >
   > 如果在指令碼中使用此程式碼範例，而不是直接從命令列使用，則必須將 %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) 的情況下設定建置環境](https://learn.microsoft.com/en-us/gaming/gdk/docs/gdk-dev/console-dev/usingwithoutinstall/build-environment-withoutinstall)

[在不安裝的情況下使用 Microsoft Game Development Kit (GDK)](https://docs.xbox.com/zh-TW/build/console-features/build-without-install/gc-usingwithoutinstall-toc.md)


## Related topics

- [在不安裝 Microsoft Game Development Kit (GDK) 的情況下使用工具](https://docs.xbox.com/zh-TW/build/console-features/build-without-install/tools-usage-withoutinstall.md)
- [使用 Microsoft Game Development Kit (GDK) 工具安裝與啟動 PC 遊戲](https://docs.xbox.com/zh-TW/tools/tools-pc/launching-on-pc.md)
- [在不安裝的情況下使用 Microsoft Game Development Kit (目錄)](https://docs.xbox.com/zh-TW/build/console-features/build-without-install/gc-usingwithoutinstall-toc.md)
- [Microsoft Game Development Kit (GDK) 的新功能](https://docs.xbox.com/zh-TW/announcements/gdk/whats-new.md)
- [搭配 Microsoft Game Development Kit (GDK) 使用 Clang](https://docs.xbox.com/zh-TW/tools/tools-pc/visualstudio/gr-vs-clang.md)