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

# GDK ツールチェーンをインストールする

> 開発 PC に Windows SDK、Visual Studio、XBOX Game Development Kit をインストールするための要件、前提条件、ステップバイステップの手順。

開発 PC をセットアップし、ツールチェーンをインストールして、GDK をダウンロードします。手順は順番に完了してください。後の手順は前の手順に依存します。

## 手順 1: 開発 PC 要件を確認する

### オペレーティング システム

<Warning>
  GDK の Visual Studio (VSIX) コンポーネントは ARM デバイスをサポートしません。GDK は x64 の開発 PC にインストールしてください。
</Warning>

| 用途                               | サポート対象                                                               |
| -------------------------------- | -------------------------------------------------------------------- |
| XBOX タイトルの開発 (クライアント)            | Windows 10 または Windows 11 (64 ビット): Home、Pro、Enterprise。             |
| XBOX タイトルの開発 (ビルド サーバー)          | Windows Server 2019 (1809 以降): Standard または Datacenter。              |
| Windows タイトルの開発 (Gaming Runtime) | Windows 10 May 2019 Update 以降 (64 ビット)、または Windows 11 (64 ビット)。      |
| MSIXVC パッケージ化された PC ゲームのテスト      | Gaming Services Runtime を備えた Windows 10 May 2019 Update 以降 (64 ビット)。 |

### ハードウェア

* GDK インストール用に 30 GB 以上の空きを持つ、高速なモダン x64 PC。
* XBOX 対応の開発では、NVMe SSD (ヒートシンク付き)、開発 PC 上の 10 GbE NIC、Cat 6a ケーブル対応の 10 GbE スイッチ (開発 PC と開発機を同じサブネットに)、および Thunderbolt 3 対応マザーボードを使用してください。
* ディスプレイ機能を検証するため、4K または UHD で HDR 対応のディスプレイ。

<Accordion title="検証済み 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 Ethernet ケーブル
</Accordion>

## 手順 2: Windows SDK をインストールする

GDK タイトルは Win32 ベースであるため、[Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/) は開発体験の中核です。Direct3D、XAudio、PIX for Windows API、コア OS サービス、`WINAPI_FAMILY_GAMES` パーティション、`xgameplatform.lib`、統合された [GameInput](/build/core-features/common/input/overviews/input-overview) API、および Process Lifecycle Management (PLM) を提供します。

必要な最小バージョン: Windows SDK 22000 以降 (Windows 11 SDK)。単独でインストールするか、Visual Studio Installer のオプション コンポーネントとしてインストールしてください。

## 手順 3: Visual Studio をインストールする

C++ ワークロードを備えた Visual Studio 2022 または Visual Studio 2026 を使用してください。

<Note>
  GDK の後で新しいエディションの Visual Studio をインストールした場合は、新しいエディションと統合されるように GDK を修復してください。Visual Studio をアンインストールする必要がある場合は、先に GDK をアンインストールしてください。
</Note>

<Tip>
  GDK をインストールする前にシステムの復元ポイントを作成してください。
</Tip>

## 手順 4: GDK をダウンロードしてインストールする

1. [XBOX GDK ダウンロード ページ](https://aka.ms/gdkdl) から GDK、および任意で Game Core for XBOX をダウンロードします。これには ID\@XBOX へのアクセスが必要です。
2. インストーラーを **管理者として** 実行します。
3. ライセンス条項に同意します。
4. GDK、および任意で Game Core for XBOX コンポーネントを選択します。
5. インストーラーの完了を待ち、要求された場合は再起動します。

インストール後、Visual Studio を開き、Configuration Manager に **Gaming.Desktop.x64** と **Gaming.XBOX.Scarlett.x64** プラットフォームが表示されることを確認します。

### GDK に含まれるもの

* **Gaming Runtime:** MSIXVC パッケージング、TCUI、Connected Storage、非同期ブロック、デバイスの関連付け、ユーザー、TTS、アクセシビリティ、Screen Time。
* **Gaming Cloud Services:** XSAPI、XAL、マルチプレイヤー ネットワーキング、PlayFab、アプリ内購入を伴う Store。
* **Gaming device extensions:** DirectX 12.x、Audio.x、PIX.x、`XMemAlloc`、その他のコンソール固有メモリ API。

## PC と XBOX のツール

**PC ゲーム:** 標準の Visual Studio ツーリングと PIX for Windows を使い、ローカルでイテレーション、テスト、デバッグを行います。オプションで VS Remote Tools を構成し、ラボ PC 上で問題を再現します。

**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 で **\[デバッグ]** > **\[オプション]** > **\[シンボル]** に移動し、**\[Microsoft Symbol Servers]** を選択します。[Microsoft 公開シンボル サーバー](https://learn.microsoft.com/windows-hardware/drivers/debugger/microsoft-public-symbols)のドキュメントを参照してください。

## Build Without Install (BWOI)

BWOI を使用すると、ビルド サーバー上でインストーラーを実行することなく GDK を使用できます。これは CI やロックダウンされたビルド環境で不可欠です。GDK セットアップのペイロードを既知のディレクトリに展開し、ビルド環境変数をそのディレクトリに向けて、`msbuild` またはツールチェーンでビルドします。

* BWOI は Visual Studio VSIX 統合をインストールしません。
* XBTC や makepkg のペイロードなど、一部のツールは 1 回限りの展開手順が必要です。
* 開発者ごとの開発機と PIX は、ワークステーションに通常どおりインストールされます。

コンテナ化された CI で GDK ビルドを実行するために BWOI を使用してください。

## リモートの Windows ゲーム開発

リモート ゲーム開発ツールを使用して、開発ネットワーク越しにリモート Windows PC へデプロイしデバッグします。これは複数 PC の開発パイプラインに役立ちます。たとえば、Windows 10 上のアーティスト、Server 2019 上のビルド、別のテスト PC 上のターゲットといった構成です。一時的なテスト イメージには Hyper-V や VMware が使えます。

## 次のステップ

同梱のサンプルを Visual Studio で開いて、インストールが機能することを確認してください。

<Card title="GDK サンプル" icon="arrow-right" href="/home/setup-install/samples">
  GDK に同梱されているリファレンス サンプル。
</Card>


## Related topics

- [GDK のセットアップとインストール](/ja-jp/home/setup-install/get-started.md)
- [GDK ツールで PC タイトルをインストールおよび起動する](/ja-jp/tools/tools-pc/launching-on-pc.md)
- [Unity で Editor Extensions を使わずに PlayFab SDK をインストールする](/ja-jp/services/playfab/sdks/unity3d/installing-unity3d-sdk.md)
- [ゲーム パッケージを作成し Partner Center にアップロードする](/ja-jp/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package.md)
- [GDK サンプル](/ja-jp/home/setup-install/samples.md)