> ## 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 タイトルをインストールおよび起動する

> Microsoft Game Development Kit (GDK) ツールを使用して、Microsoft Gaming Runtime 上で動作する PC タイトルをインストール、起動、トラブルシューティングする方法。

このトピックでは、PC タイトルをインストールおよび起動するための Microsoft Game Development Kit (GDK) ツールについて説明します。これらのツールの使い方を説明するとともに、PC のインストールおよび起動時の問題のトラブルシューティングに関する情報を提供します。

## PC 上でタイトルをインストールおよび起動するツール

<Note>アプリの起動および Gaming Runtime での起動の詳細については、「[Win32 ゲームの起動](/build/core-features/common/game-config/MicrosoftGameConfig-Overview#MSGC-PCLaunch)」を参照してください。</Note>

Microsoft Game Development Kit (GDK) では、次の方法でタイトルをインストールできます。

* [wdapp.exe install](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install): タイトルの .MSIXVC パッケージをインストールするために使用します。PC タイトルのパッケージ化の詳細については、「[MSIXVC パッケージング ツールを使用した PC 用タイトルのパッケージ化の概要](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)」を参照してください。パッケージで完全な [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) フローを有効にする場合は、/bootstrapper フラグを使用して有効にできます。

* [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register): 起動できるようにルース ファイル フォルダーを登録するために使用します。詳細については、「[PC ゲームの登録](/tools/tools-pc/title-registration-pc)」を参照してください。2022 年 6 月版の GDK 以降、デスクトップおよびスタート メニュー シェル アイコン (小売版のインストール シナリオをテストする場合など) を有効にする場合にのみ、ゲームを登録する必要があります。

Microsoft Game Development Kit (GDK) では、次の方法でタイトルを起動できます。

* タイトルを登録すると、スタート メニューに選択可能な項目として表示され、検索ボックスからも検索できるようになります。

* [wdapp.exe launch](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_launch) は、アプリケーション ユーザー モデル ID (AUMID) または実行可能ファイルへのパスを使用してタイトルを起動するために使用します。

* Windows Device Portal (WDP): **\[Installed Apps]** に移動し、**\[Start]** を選択します。

### PC Bootstrapper を有効化して起動する

小売ユーザーが目にするような完全な [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) フローで起動するには、wdapp install を使用してパッケージをサイドロードし、/bootstrapper フラグを使用する必要があります。ルース ビルド、またはフラグを使用しないインストールの場合、PC Bootstrapper の機能は、XUserAddAsync 呼び出し時における簡易ユーザー モデルの適用のみに制限されます。

### タイトル ID を使用した起動と使用しない起動

2022 年 6 月版の GDK 以降、[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Overview) が正しく構成されている限り、タイトルの起動方法にかかわらずランタイムは同じように動作するはずです。

### コマンド ライン引数を指定した起動

2022 年 6 月版の GDK 以降、任意の \[起動引数] を直接渡して実行可能ファイルを直接起動できます。

加えて、次のいずれかの方法でコマンド ライン引数を指定してタイトルを起動することもできます。

* GDK コマンド プロンプトから `WdApp Launch [launch args]` を実行する。

* コマンド プロンプトで `<ExecutionAlias> [launch args]` を実行する。

* Visual Studio プロジェクトのプロパティでコマンド ライン引数を指定する。

Execution Alias の使用方法の詳細については、「[ExecutionAlias](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable#MicrosoftGameConfig-Alias)」を参照してください。

<a id="PC-Errors" />

## PC のインストールおよび起動の問題のトラブルシューティング

### エラー コード 0x80073CFF: 有効なライセンスまたはサイドローディング ポリシーが適用できないため、パッケージのデプロイに失敗しました。開発者ライセンスまたはエンタープライズ サイドローディング構成が必要な可能性があります。

#### 問題

タイトルをインストール、登録、または起動しようとしたときに問題が発生しました。

#### 修正方法

次の手順で PC 上で開発者モードを有効にして問題を解決します。

1. **設定**を開きます。

2. 検索フィールドに *開発者* と入力します。

3. 表示されるオプションの一覧から、**\[開発者向け機能を使う]** を選択します。

4. **\[開発者モード]** を選択します。ダイアログ ボックスが表示され、機能を追加中である旨が示されます。この処理が完了するまで必ず待ってください。

### エラー コード 0x80073cfc: アプリケーションを起動できません。問題を修正するにはアプリケーションを再インストールしてみてください。

#### 問題

インストール プロセスの初期段階のいずれかで問題が発生しました。

#### 回避策

Gaming Runtime Services (GRTS) をアンインストールしてから再インストールできます。以下の手順を実行してください。

1. PowerShell 管理者コマンド プロンプトを開きます。

2. 次のコマンドを実行します: `get-appxpackage *gamings*`

3. 次のコマンドを実行します: `remove-package <package fullname from step 2 for the gamingservices package>`

4. XBOX アプリを開き、ゲームをインストールします。これにより、Microsoft Store から gamingservices パッケージのインストールがトリガーされます。

### エラー コード 0x87e00017: インストール ソースは見つかりましたが、到達できません。おそらくインターネットの問題です。

#### 問題

このエラー コードは `IM_E_UNREACHABLE_INSTALL_SOURCE` に対応します。デプロイ システムがファイルにアクセスできない場合、このエラーが発生します。ただし、それだけでなく、インストール ディレクトリが破損している可能性もあります。この最も一般的な原因は、部分的にしか成功しなかったデプロイが後で適切にクリーンアップされなかったことです。

#### 修正方法

これらの問題を修正するには、次の手順に従います。

1. `wdapp list` アプリを実行します。

2. 結果のリストから、インストールしたゲームのバージョンを探します。

3. `wdapp uninstall <pfn>` を使用してすべてのゲームをアンインストールします。

4. ゲームを再度インストールしてみます。

### エラー コード 0x80080203: 指定されたパッケージ形式が無効です: 必須のフットプリント ファイルが不足しているため、有効なアプリ パッケージではありません。

#### 問題

これは、"ネストされた MSIXVC" があるために発生します (これは簡単に起こる可能性があります)。たとえば、デスクトップ ビルドが *C:\MyGame* にあるとします。*C:\MyGame* 下のサブフォルダー (たとえば *C:\MyGame\Package*) で [makepkg.exe](/build/core-features/common/packaging/deployment/makepkg) を使用してパッケージを作成することにします。パッケージが生成されていないため初回はうまくいきますが、再度パッケージを作成しようとすると、この問題が発生します。この失敗 (パッケージ内に 2 つの *AppxManifest.xml* ファイルがあるために発生する) に加えて、*C:\MyGame* に対して *makepkg.exe* を実行すると、既存の .msixvc を新しいパッケージにパッケージ化しようとします (genmap から除外していない場合)。

#### 修正方法

この問題を修正するには、パッケージ ディレクトリを、*MicrosoftGame.config* を含むディレクトリの外に配置してください。

### エラー コード 0x80070490: 要素が見つかりません

#### 問題

`wdapp install` で .XVC (XBOX パッケージのパッケージング形式) をインストールしようとすると、この問題が発生します。

#### 回避策

`wdapp install` は .MSIXVC パッケージ (PC パッケージのパッケージング形式) にのみ使用するようにしてください。

### タイトル フォルダーが共有されている場合の wdapp 起動時のエラー

#### 問題

以前に [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register) で登録したフォルダーを Windows のファイル共有で共有すると、Gaming Runtime が共有権限を失い、このエラーが発生します。

```
    'WdApp.exe launch' must be called with an AUMID to activate an application.

    Use 'WdApp.exe list' to get a list of sideloaded packages including AUMID values.

    Alternatively, if your executable specifies an Alias in the *MicrosoftGame.config*,

    typing the alias name at the command prompt will do an application activation.

    Failed with 0x80070057.
```

#### 回避策

この問題はアクセス制御リスト (ACL) に関連しています。フォルダーを共有すると、アプリ モデルへのアクセスができなくなります。つまり、共有すると、コンテナーがファイルの読み取り権限を失います。回避策として、次の手順に従って ACL データを保存および復元します。

1. フォルダーを共有する前に、'icacls /save AclFile' を実行してパッケージ フォルダーの ACL を保存します。

2. Windows のファイル共有を使用してフォルダーを共有します。

3. 以前の ACL を復元するには、'icacls /restore AclFile' を実行します。

この回避策に加えて、まず `wdapp.exe unregister` を実行してから `wdapp.exe register` を実行することによって再登録することもできます。これにより、フォルダー共有を維持しつつ権限が復元されます。

### エラー コード 0x80070005: アクセスが拒否されました。

#### 問題

wdapp install コマンドを実行すると、「0x8007005: アクセスが拒否されました」というエラーが発生します。

#### 修正方法

.msixvc ファイルへのフルパスを渡していることを確認してください。例えば以下のとおりです。

正しい例:

<i>wdapp install "c:\MyGame\GDKBuildFolder\GdkGame\_1.0.0.0\_x64\_\_pmsdash4d.msixvc"</i>

誤った例 (.msixvc へのフルパスが不足):

<i>wdapp install "c:\MyGame\GDKBuildFolder"</i>

### エラー コード 0x000007b: STATUS\_INVALID\_IMAGE\_FORMAT

#### 問題

wdapp launch コマンドを実行すると、「0x000007b」エラーが発生します。

#### 修正方法

この問題は、起動しようとしている実行可能ファイルのプラットフォーム アーキテクチャが、MicrosoftGame.config で指定されているものと異なることが原因です。MicrosoftGame.config の DesktopRegistration 要素には、'x86' または 'x64' を値として指定できるオプションの子要素 ProcessorArchitecture があります。この指定が Executable 要素で定義された実行可能ファイルのプラットフォーム アーキテクチャと一致していることを確認すれば、この問題を解決できます。

### エラー コード 0x800701B1: 存在しないデバイスが指定されました。

#### 問題

wdapp install /drive コマンドを実行すると、「0x800701B1」エラーが発生します。

#### 修正方法

この問題は、Windows Store がターゲット ドライブを検出できなかったことが原因です。ローカル PC の「設定 -> ストレージの設定 -> 新しいコンテンツの保存先を変更する」にある「新しいアプリの保存先:」のドロップダウン リストに、ターゲット ドライブが存在することを確認してください。ドライブが存在しない場合は、ドライブの状態を確認し、ローカル PC に最新の Windows Update が適用されていることを確認してください。

### エラー コード 0x80072F78: WININET\_E\_INVALID\_SERVER\_RESPONSE

#### 問題

wdapp install コマンドを実行すると、「0x80072F78」エラーが発生します。

#### 修正方法

この問題は、ファイアウォールのプロキシ構成設定が、"settings-win.data.microsoft.com" というアドレスをブロックしていることに関連しています。このアドレスは、PC GDK タイトルをインストールする際にインストール設定を適切にキャッシュするために必要です。ファイアウォール ソフトウェアでこのアドレスが許可されていることを確認してください。

## 関連項目

[Microsoft Game Development Kit を使い始める](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/get-started/get-started-home)

[PC 用パッケージングを始める](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)

[PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper)

[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)

[アプリケーション管理 (wdapp.exe)](/tools/tools-pc/commandlinetools/gr-wdapp)

[PC ゲームの登録](/tools/tools-pc/title-registration-pc)

[フラット ファイル インストールの概要](/build/core-features/common/packaging/packaging-flatfileinstall)

[コマンド ライン ツール (PC 用)](/tools/tools-pc/commandlinetools/gr-commandlinetools-toc)

[PC ゲーム開発 (環境とツール)](/tools/tools-pc/gc-tools-pc-toc)


## Related topics

- [PC ゲーム開発環境とツール](/ja-jp/tools/tools-pc/gc-tools-pc-toc.md)
- [ビデオ キャプチャ (wdcapturesession.exe)](/ja-jp/tools/tools-pc/commandlinetools/gr-wdcapturesession.md)
- [コマンドライン ツール](/ja-jp/tools/tools-pc/commandlinetools/index.md)
- [PC Bootstrapper](/ja-jp/build/gdk-and-engines/guides/pc-bootstrapper.md)
- [Unreal Engine で GDK を使用する](/ja-jp/build/gdk-and-engines/unreal/unreal.md)
