> ## 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 向け MSIXVC2 パッケージングの使い始め

> PC 向け MSIXVC2 パッケージングの使い始め

以下の手順を使用して、開発 PC でテスト用にサイドロードし、その後 Partner Center にアップロードして公開できる MSIXVC2 パッケージを作成します。

形式とその利点の背景情報については、[MSIXVC2 パッケージングの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md) を参照してください。

> [!NOTE]
>
> MSIXVC2 は 2026 年 10 月の Microsoft Game Development Kit (GDK) 以降で一般提供されます。テスト用に MSIXVC2 パッケージをサイドロードし、公開リリース用に認定に提出できます。

> [!NOTE]
>
> 一部の MSIXVC2 機能と改善は、Gaming Runtime Services の更新を通じて提供され、GDK の更新を必要としません。これらの拡張機能は利用可能になり次第、自動的に受け取ることができます。

> [!NOTE]
>
> XBOX コンソール向けにパッケージ化する場合は、[XBOX コンソール向けパッケージングの使い始め](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md) を参照してください。コンソールゲームは引き続き XVC を使用します。`makepkg` ツールは両方の形式を処理します。

## 開始する前に

* 開発 PC 上の **Windows 10** バージョン 18362 以降。
* **2026 年 10 月の GDK 以降** がインストールされていること。GDK には `makepkg.exe` が含まれます。

> [!NOTE]
>
> 2026 年 10 月の GDK 以降、管理されたパッケージングツールの名前は `makepkg.exe` です。従来の MakePkg.exe と一時的な `makepkg2.exe` の名前は削除されました。

* **Partner Center 製品** パブリッシャー ID、パッケージ名、および Store ID が必要です。
* ターゲットテスト PC で有効になっている **開発者モード**。
* MSIXVC2 パッケージをインストールまたは実行するすべてのデバイスに設定された **MSIXVC2 開発者モードレジストリキー**。詳細については、[ステップ 7](#step-7-test-your-package-locally) を参照してください。

## ステップ 1: コンテンツを準備する

タイトルのすべてのソースマテリアルを単一のディレクトリに配置します。パッケージシステムが使用できない、または小売パッケージでの出荷に不適切なファイルは削除します。

存在する場合は、以下のファイルを削除します。

* PDB ファイル。
* 他の PC ゲームストア (アセット、バイナリなど) への参照。
* AppxSignature.p7x や AppxBlockMap.xml を含む、Universal Windows Platform (UWP) と Appx の「フットプリント」ファイル。

## ステップ 2: MicrosoftGame.config を作成する

ゲームコンテンツのルートディレクトリに MicrosoftGame.config ファイルを作成します。この構成ファイルは MSIXVC で動作します。既存の MicrosoftGame.config は変更なしで MSIXVC2 で動作します。

このファイルは手動で作成することも、Partner Center プロジェクトから ID と ID 値を直接同期する [MicrosoftGame.config Editor](https://docs.xbox.com/ja-jp/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) を使用して作成することもできます。

MicrosoftGame.config ファイルのサンプルについては、[PC 向け MSIXVC の使い始め](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md#sample-microsoftgameconfig) を参照してください。

## ステップ 3: Visual C/C++ ランタイム依存関係を特定する

MicrosoftGame.config に Visual C/C++ ランタイム依存関係がリストされていること、またはそれらの依存関係を明示的にパッケージペイロードにコピーしていることを確認します。詳細については、[Framework パッケージ依存関係](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-framework-packages.md) を参照してください。

## ステップ 4: アイコンを作成する

MicrosoftGame.config の `ShellVisuals` セクションで指定されたサイズにスケーリングされたアイコンファイルを、ゲームコンテンツのルートフォルダー (またはサブディレクトリ) に配置します。[MicrosoftGame.config Editor](https://docs.xbox.com/ja-jp/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) は、単一のソース画像からこれらの画像を生成できます。

## ステップ 5: レイアウトマッピングファイルを生成する (オプション)

このステップはオプションです。既定では、MSIXVC2 はすべてのコンテンツを単一のチャンクにパッケージ化します。コンテンツを複数のチャンクに分割したり、Intelligent Delivery タグを追加したりしたい場合にのみ、レイアウトマッピングファイルが必要です。

レイアウトマッピングファイルを生成するには、GDK コマンドプロンプトを開いて次のコマンドを実行します。

```text theme={null}
makepkg genmap /f layout.xml /d <your_game_folder>
```

このコマンドは、コンテンツがどのようにチャンクに整理されるかを定義するレイアウトマッピングファイルを作成します。生成されたファイルには単一のチャンクが含まれます。必要に応じて、コンテンツを複数のチャンクに分割したり、Intelligent Delivery タグを追加したりするようにファイルを編集できます。

> [!TIP]
>
> MSIXVC2 では、チャンクの並べ替えやチャンク間でのファイル移動はコンテンツ更新のサイズに影響しません。MSIXVC で存在する更新ペナルティを心配することなく、自由にレイアウトを整理できます。

レイアウトファイルの詳細については、[デプロイパッケージスキーマ](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/atoc-deployment-schema.md) を参照してください。

## ステップ 6: MSIXVC2 パッケージを作成する

パッケージを作成します。

```text theme={null}
makepkg pack /msixvc2 /f layout.xml /d <your_game_folder> /pc /pd <output_folder>
```

主なオプション:

| オプション | 説明 |
| - | - |
| `/msixvc2` | MSIXVC2 パッケージを生成します。このオプションがない場合、コマンドは MSIXVC パッケージを生成します。2027 年 4 月の GDK 以降、`makepkg` は既定で MSIXVC2 パッケージを作成します。 |
| `/f <mapfile>` | レイアウトマッピングファイルを指定します。省略した場合、既定の単一チャンクレイアウトが生成されます。 |
| `/d <sourcedir>` | ゲームコンテンツと MicrosoftGame.config を含むディレクトリ。 |
| `/pc` | PC で使用するパッケージを生成します。 |
| `/pd <outputdir>` | 生成されたパッケージが配置されるディレクトリ。 |
| `/compress <method>` | 出力を圧縮します。利用可能な方式: `Automatic` (既定)、`None`。`Automatic` は MSIXVC2 パッケージに Brotli を使用します。 |

## ステップ 7: ローカルでパッケージをテストする

ターゲット PC で開発者モードを有効にします。MSIXVC2 パッケージをインストールする前に、ターゲットデバイスに次のレジストリキーを設定します。

```text theme={null}
reg add HKLM\SOFTWARE\Microsoft\GamingServices /v Xvc2DeveloperMode /t REG_DWORD /d 1 /f
```

または、`packageutil` を使用して MSIXVC2 開発者モードを有効にできます。

```text theme={null}
packageutil set msixvc2 on
```

MSIXVC2 開発者モードを無効にするには:

```text theme={null}
packageutil set msixvc2 off
```

> [!NOTE]
>
> `packageutil set` コマンドには 2026 年 10 月の GDK 以降が必要です。

> [!NOTE]
>
> このレジストリキーは、将来の GDK リリースまで必要です。これがないと、MSIXVC2 パッケージはインストールできません。管理者コマンドプロンプトからコマンドを実行してください。

次にパッケージをインストールします。

```text theme={null}
wdapp install <your_package.msixvc>
```

MSIXVC2 パッケージは `[drive]:\XboxGames` フォルダーにインストールされます。ファイルは元の形式でインストールされ、直接アクセスできます。このインストール場所は、[フラット ファイル インストール](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-flatfileinstall.md) を使用する MSIXVC パッケージによって使用される場所と同じです。

ローカルでサイドロードするのと同じパッケージを Partner Center にアップロードできます。個別の提出パッケージ手順はありません。

## ステップ 8: Partner Center にアップロードする

> [!NOTE]
>
> MSIXVC2 パッケージは Partner Center の**新しいブランチ** (たとえば、`msixvc2`) に公開してください。既存の MSIXVC パッケージと同じブランチに MSIXVC2 パッケージをアップロードしないでください。2 つの形式はブランチ内で交換可能ではなく、MSIXVC2 から MSIXVC にブランチを戻すには、パッケージの完全なアップロードとダウンロードが必要です。詳細については、[パッケージブランチのベストプラクティス](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md#package-branch-best-practices) を参照してください。

Partner Center へのアップロードには 2 つのオプションがあります。

### オプション A: 事前ビルド済みパッケージのアップロード

ステップ 6 で既にパッケージを作成した場合、直接アップロードします。

```text theme={null}
makepkg upload /pd <package_directory> /branch msixvc2
```

### オプション B: ルーズファイルからのアップロード (1 コマンドワークフロー)

パッケージングとアップロードを 1 つのコマンドに組み合わせることができます。このコマンドは、ローカルパッケージファイルを作成せずに、ビルド出力から直接アップロードします。

```text theme={null}
makepkg upload /d <your_game_folder> /msixvc2 /pc /branch msixvc2
```

### アップロードオプション

| オプション | 説明 |
| - | - |
| `/branch <branch>` | アップロード先のブランチ。既定は `main` です。専用の MSIXVC2 ブランチを使用します。 |
| `/flight <flight>` | アップロード先のフライト。`/branch` と共に使用できません。 |
| `/market <market>` | アップロード先のマーケット。既定は `default` です。 |
| `/storeid <storeId>` | Store ID。指定しない場合はパッケージから抽出されます。 |
| `/auth <method>` | 認証方式。既定は `CacheableBrowser` です。CI/CD オプションについては [認証方式](#authentication-methods) を参照してください。 |

アップロードオプションの完全なリストについては、[Make package (makepkg.exe)](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/makepkg.md) を参照してください。

## 認証方式

`upload` コマンドは、さまざまな環境向けに複数の認証方式をサポートします。

| 方式 | ユースケース |
| - | - |
| `CacheableBrowser` | 既定。インタラクティブなサインイン用にブラウザーを開きます。後続のアップロードのために資格情報をキャッシュします。 |
| `Browser` | キャッシュせずに、インタラクティブなサインイン用にブラウザーを開きます。 |
| `AzureCli` | Azure CLI 資格情報を使用します。`az login` で既に認証されている場合に便利です。 |
| `AzurePipelines` | Azure Pipelines サービス接続を使用します。Azure DevOps CI/CD パイプラインに最適です。 |
| `ManagedIdentity` | Azure マネージド ID を使用します。`/clientid` が必要です。 |
| `ManagedIdentityFederated` | フェデレーションマネージド ID を使用します。`/clientid` と `/resourceid` が必要です。 |
| `ClientSecret` | クライアント ID とシークレットを使用します。`/clientid` と `/clientsecret` が必要です。 |
| `ClientCertificate` | クライアント証明書を使用します。`/clientid` と `/certthumbprint` が必要です。 |
| `Environment` | 環境変数から資格情報を使用します。 |
| `Default` | 複数の方式を順次試行します。 |

**例: CI/CD パイプラインのアップロード**

```text theme={null}
makepkg upload /pd <package_directory> /auth AzurePipelines /branch <branch>
```

**例: サービスプリンシパルアップロード**

```text theme={null}
makepkg upload /pd <package_directory> /auth ClientSecret /clientid <appId> /clientsecret <secret> /branch <branch>
```

## ステップ 9: Partner Center で検証および公開する

アップロード後、Partner Center を使用してパッケージを検証し公開します。提出フローは MSIXVC から変更されていません。パッケージを選択し、利用可能性を構成し、提出します。

MSIXVC2 パッケージをサンドボックスに公開してテストしたり、公開リリース用に認定に提出したりできます。

> [!TIP]
>
> 本番リリースには既存の MSIXVC パイプラインを維持してください。MSIXVC2 評価には別の Partner Center ブランチを使用することで、結果を並行して比較でき、稼働中のゲームを中断することなく GA で MSIXVC2 に移行できます。

## 更新サイズの比較

タイトルに対する MSIXVC2 の利点を評価するには、2 つの連続するビルドからパッケージを作成し比較します。

```text theme={null}
makepkg pack /msixvc2 /f layout.xml /d <old_build> /pc /pd <output_old>
makepkg pack /msixvc2 /f layout.xml /d <new_build> /pc /pd <output_new> /priorpackage <output_old\package.msixvc>
```

同等の MSIXVC ビルドに対する結果として得られる更新サイズを比較して、違いを確認します。

## MSIXVC2 での Intelligent Delivery

Intelligent Delivery は MSIXVC2 でも MSIXVC と同じように動作します。レイアウトマッピングファイル内でチャンクを定義し、言語、デバイス、またはタグ指定子を設定します。主な違いは、チャンクの再編成またはチャンク間でのファイルの移動がコンテンツ更新のサイズに影響しないことです。

詳細については、[ストリーミングインストールと Intelligent Delivery: 概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery.md) を参照してください。

## 関連項目

[MSIXVC2 パッケージングの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md) [Make package (makepkg.exe)](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/makepkg.md) [PC 向け MSIXVC の使い始め](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md) [MSIXVC2 でのコンテンツ更新](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-updates-msixvc2.md) [MSIXVC2 暗号化モデル](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-encryption-msixvc2.md) [XBOX Game Package Manager](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/xgpm.md) [パッケージアップロードの自動化](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/package-uploader.md) [フラット ファイル インストールの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-flatfileinstall.md) [デプロイパッケージスキーマ](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/atoc-deployment-schema.md)


## Related topics

- [PC 向けパッケージングの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)
- [XBOX コンソール向けパッケージングの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)
- [MSIXVC2 パッケージング概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
- [packageutil.exe](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/packageutil.md)
- [Make package (makepkg.exe)](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/makepkg.md)