> ## 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.

# 開発者環境のセットアップ (目次)

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

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

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

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

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

| 用途 | サポート対象 |
| - | - |
| 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 対応のディスプレイ。

> **検証済み 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 ケーブル

## 手順 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](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-overview.md) 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 をアンインストールしてください。

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

## 手順 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 で開いて、インストールが機能することを確認してください。

> **[GDK サンプル](https://docs.xbox.com/ja-jp/home/setup-install/samples.md)**
>
> GDK に同梱されているリファレンス サンプル。


## Related topics

- [統計情報のクイックスタート](https://docs.xbox.com/ja-jp/services/playfab/player-progression/statistics/quickstart-statistics.md)
- [クラフト ゲーム パート 1 - セットアップ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-environment.md)
- [クラフト ゲーム パート 2 - Game Manager](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-game-manager.md)
- [XBOX 環境のツールと API](https://docs.xbox.com/ja-jp/tools/tools-console/gc-xbox-tools-and-apis-toc.md)
- [サンドボックスのセットアップ](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)