Microsoft Game Development Kit ツールを利用して PC タイトルをインストールして起動する
このトピックでは、Microsoft Game Development Kit (GDK) ツールを使用して PC タイトルをインストールおよび起動する方法について説明します。 これらのツールの使い方について説明し、PC のインストールと起動の問題のトラブルシューティングについて説明します。
PC にタイトルをインストールして起動するためのツール
注意
アプリの起動と、ゲーム ランタイムを使用した起動の詳細については、「Win32 ゲームを起動する」をご覧ください。
Microsoft Game Development Kit (GDK) は、タイトルをインストールする次の方法を提供します。
wdapp.exe install: タイトルの .MSIXVC パッケージをインストールする際に使います。 PC ゲームのパッケージ化の詳細については、「MSIXVC パッケージ化ツールを使用してタイトルを PC 用にパッケージする方法についてのスタートガイド」をご覧ください。 パッケージを使用して、完全な PC Bootstrapper フローを有効にしたい場合、/bootstrapper フラグを介してこれを有効にすることができます。
wdapp.exe register: 圧縮されていないファイル フォルダーを起動できるよう登録する際に使います。 詳細については、「PC ゲームの登録」をご覧ください。 2022 年 6 月の GDK 以降は、小売店インストールのシナリオをテストする場合など、デスクトップとスタート メニューのシェル アイコンを有効にする場合にのみ、ゲームの登録が必要になります。
Microsoft Game Development Kit (GDK) は、タイトルを起動する次の方法を提供します。
タイトルを登録すると、スタート メニューで選択可能なタイトルとして表示され、検索ボックスで検索できます。
wdapp.exe launch: アプリケーション ユーザー モデル ID (AUMID) または実行可能ファイルへのパスのいずれかを使用してタイトルを起動する際に使います。
Windows デバイス ポータル (WDP): [インストールされているアプリ] に移動し、[スタート] を選択します。
PC Bootstrapper を有効にした状態での起動
小売店ユーザーが見るような完全な PC Bootstrapper フローで起動するには、wdapp インストール経由でパッケージをサイドロードし、/bootstrapper フラグを使用する必要があります。 フラグのないルース ビルドやインストールでは、PC Bootstrapper 機能は、XUserAddAsync が呼び出された時点で、単純化されたユーザー モデルの実施に制限されます。
タイトル ID を使ってまたは使わずに起動する
2022 年 6 月の GDK 時点では、MicrosoftGame.config が正しく構成されていれば、タイトルの起動方法に関係なくランタイムは同じように機能します。
コマンド ライン引数で起動する
2022 年 6 月の GDK では、任意の [launch args] を直接渡して実行ファイルを簡単に起動できます。
さらに、コマンド ライン引数でタイトルを起動するには、次のいずれかの方法を使用できます。
WdApp Launch [launch args]GDK コマンド プロンプトから。<ExecutionAlias> [launch args]コマンド プロンプトで。Visual Studio プロジェクト プロパティのコマンド ライン引数。
実行エイリアスの使用の詳細については、「ExecutionAlias」をご覧ください。
PC のインストールと起動の問題のトラブルシューティング
エラー コード 0x80073CFF: 有効なライセンスまたはサイドローディング ポリシーを適用できなかったため、パッケージの展開に失敗しました。 開発者ライセンスまたはエンタープライズ サイドローディング構成が必要になる場合があります。
問題
タイトルをインストール、登録、または起動しようとして、問題が発生しました。
解決方法
修正プログラムは、次の手順を使用して PC で開発者モードを有効にすることです。
[設定] を開きます。
検索フィールドに「開発者」と入力します。
表示されたオプション一覧から、[開発者向け機能を使う] を選択します。
[開発者モード] を選択します。 システムが機能を追加していることを示すダイアログ ボックスが表示されます。 このプロセスが完了するのを待っていることを確認します。
エラー コード 0x80073cfc: アプリケーションを開始できません。 アプリケーションを再インストールして問題を解決してください。
問題
インストール プロセスの最初の手順の 1 つで問題が発生しました。
回避策
ゲーム ランタイム サービス (GRTS) をアンインストールして再インストールします。 そのためには、次の手順を実行します。
PowerShell 管理者コマンド プロンプトを開きます。
次のコマンドを実行します:
get-appxpackage *gamings*次のコマンドを実行します:
remove-package <package fullname from step 2 for the gamingservices package>Xbox アプリを開き、ゲームをインストールします。 これにより、Microsoft Store から gamingservices パッケージのインストールがトリガーされます。
エラー コード 0x87e00017: インストール ソースが見つかりましたが、アクセスできません。 インターネットに問題がある可能性があります。
問題
このエラー コードは IM_E_UNREACHABLE_INSTALL_SOURCE に対応しています。 展開システムがファイルにアクセスできない場合、このエラーが発生します。 ただし、その場合であっても、インストール ディレクトリが破損していることを意味する可能性もあります。 このエラーの最も一般的な原因は、展開が部分的に成功したが、その後正しくクリーンアップされなかった場合です。
解決方法
これらの問題を解決するには
アプリ
wdapp listを実行します。結果の一覧で、インストールしたゲームの任意のバージョンを探します。
wdapp uninstall <pfn>を使ってすべてのゲームをアンインストールします。ゲームをもう一度インストールしてみます。
エラー コード 0x80080203: 指定したパッケージ形式は無効です。必要なフットプリント ファイルが存在しないため、ファイルは有効なアプリ パッケージではありません。
問題
これは、"入れ子になった MSIXVC" があるために発生します (これは簡単に発生します)。 デスクトップ ビルドが C:\MyGame であるとします。 makepkg.exe を使用して、パッケージを C:\MyGame (C:\MyGame\Package など) に作成するとします。 パッケージが生成されないため、これは最初には機能しますが、パッケージを再び作成した後にこの問題が発生する可能性があります。 このエラー (パッケージに 2 つの AppxManifest.xml ファイルが含まれていることが原因) に加えて、 C:\MyGame で makepkg.exe を実行すると、既存の .msixvc が新しいパッケージにパッケージ化されます (genmap から除外した場合を除く)。
解決方法
この問題を解決するには、パッケージ ディレクトリが、使用している MicrosoftGame.config があるディレクトリ以外にあることを確認します。
エラー コード 0x80070490: 要素が見つかりません
問題
この問題は、wdapp install で .XVC (Xbox パッケージのパッケージ形式) をインストールしようとすると発生することがあります。
回避策
wdapp install は、.MSIXVC パッケージ (PC パッケージのパッケージ形式) にのみ使用してください。
タイトル フォルダーが共有されているときに wdapp から起動するとエラーが発生する
問題
以前に wdapp.exe register に登録したフォルダーを Windows ファイル共有と共有すると、ゲーム ランタイムは共有アクセス許可を失い、その後このエラーが発生します。
'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 データを保存し、復元します。
フォルダーを共有する前に、'icacls /save AclFile' を実行してパッケージ フォルダーの ACL を保存します。
Windows ファイル共有を使用してフォルダーを共有します。
以前の ACL を復元するには、'icacls/restore AclFile' を実行します。
この回避策に加えて、最初に wdapp.exe unregisterを実行し、次に wdapp.exe registerを実行して再登録することもできます。 フォルダーの共有を維持しながらアクセス許可が復元されます。
エラー コード 0x80070005: アクセスが拒否されました。
問題
wdapp install コマンドを実行しているときに、"0x8007005: アクセスが拒否されました" エラーが発生しました。
解決方法
.msixvc ファイルへの完全なパスを渡していることを確認します。 例は以下のとおりです。
正しい場合:
wdapp install "c:\MyGame\GDKBuildFolder\GdkGame_1.0.0.0_x64__pmsdash4d.msixvc"
間違っている場合 (.msixvc への完全なパスがありません):
wdapp install "c:\MyGame\GDKBuildFolder"
エラー コード 0x000007b: STATUS_INVALID_IMAGE_FORMAT
問題
wdapp launch コマンドの実行時に "0x000007b" エラーが発生しました。
解決方法
問題は、起動される実行可能ファイルが、MicrosoftGame.config で指定されているものとは異なるプラットフォーム アーキテクチャであることです。MicrosoftGame.config の DesktopRegistration 要素には、ProcessorArchitecture というオプションの子要素があり、その値として 'x86' または 'x64' のいずれかを指定できます。 この仕様が、実行可能ファイルの要素で定義された実行可能ファイルのプラットフォーム アーキテクチャと一致することで、この問題が解決することを確認します。
エラーコード 0x800701B1: 存在しないデバイスが指定されました。
問題
wdapp install / drive コマンドを実行すると、 "0x800701B1" エラーが発生します。
解決方法
問題は、ターゲット ドライブが Windows ストアによって検出されなかったことです。 ローカル PC の [設定 -> ストレージ設定 -> 新しいコンテンツの保存場所を変更する] の [新しいアプリの保存先:] ドロップダウン リストにターゲット ドライブが存在することを確認します。 ドライブが存在しない場合は、ドライブの状態を確認し、ローカル PC に最新の Windows の更新プログラムがインストールされていることを確認してください。
エラー コード 0x80072F78: WININET_E_INVALID_SERVER_RESPONSE
問題
wdapp install コマンドを実行すると、 "0x80072F78" エラーが発生します。
解決方法
この問題は、このアドレス"settings-win.data.microsoft.com" をブロックするファイアウォール プロキシ構成設定に関連しています。 このアドレスは、PC GDK タイトルをインストールするときにインストール設定が適切にキャッシュされるために必要です。 このアドレスがファイアウォール ソフトウェアで許可されていることを確認してください。