PC 上でタイトルをインストールおよび起動するツール
アプリの起動および Gaming Runtime での起動の詳細については、「Win32 ゲームの起動」を参照してください。
- wdapp.exe install: タイトルの .MSIXVC パッケージをインストールするために使用します。PC タイトルのパッケージ化の詳細については、「MSIXVC パッケージング ツールを使用した PC 用タイトルのパッケージ化の概要」を参照してください。パッケージで完全な PC Bootstrapper フローを有効にする場合は、/bootstrapper フラグを使用して有効にできます。
- wdapp.exe register: 起動できるようにルース ファイル フォルダーを登録するために使用します。詳細については、「PC ゲームの登録」を参照してください。2022 年 6 月版の GDK 以降、デスクトップおよびスタート メニュー シェル アイコン (小売版のインストール シナリオをテストする場合など) を有効にする場合にのみ、ゲームを登録する必要があります。
- タイトルを登録すると、スタート メニューに選択可能な項目として表示され、検索ボックスからも検索できるようになります。
- wdapp.exe launch は、アプリケーション ユーザー モデル ID (AUMID) または実行可能ファイルへのパスを使用してタイトルを起動するために使用します。
- Windows Device Portal (WDP): [Installed Apps] に移動し、[Start] を選択します。
PC Bootstrapper を有効化して起動する
小売ユーザーが目にするような完全な PC Bootstrapper フローで起動するには、wdapp install を使用してパッケージをサイドロードし、/bootstrapper フラグを使用する必要があります。ルース ビルド、またはフラグを使用しないインストールの場合、PC Bootstrapper の機能は、XUserAddAsync 呼び出し時における簡易ユーザー モデルの適用のみに制限されます。タイトル ID を使用した起動と使用しない起動
2022 年 6 月版の GDK 以降、MicrosoftGame.config が正しく構成されている限り、タイトルの起動方法にかかわらずランタイムは同じように動作するはずです。コマンド ライン引数を指定した起動
2022 年 6 月版の GDK 以降、任意の [起動引数] を直接渡して実行可能ファイルを直接起動できます。 加えて、次のいずれかの方法でコマンド ライン引数を指定してタイトルを起動することもできます。-
GDK コマンド プロンプトから
WdApp Launch [launch args]を実行する。 -
コマンド プロンプトで
<ExecutionAlias> [launch args]を実行する。 - Visual Studio プロジェクトのプロパティでコマンド ライン引数を指定する。
PC のインストールおよび起動の問題のトラブルシューティング
エラー コード 0x80073CFF: 有効なライセンスまたはサイドローディング ポリシーが適用できないため、パッケージのデプロイに失敗しました。開発者ライセンスまたはエンタープライズ サイドローディング構成が必要な可能性があります。
問題
タイトルをインストール、登録、または起動しようとしたときに問題が発生しました。修正方法
次の手順で PC 上で開発者モードを有効にして問題を解決します。- 設定を開きます。
- 検索フィールドに 開発者 と入力します。
- 表示されるオプションの一覧から、[開発者向け機能を使う] を選択します。
- [開発者モード] を選択します。ダイアログ ボックスが表示され、機能を追加中である旨が示されます。この処理が完了するまで必ず待ってください。
エラー コード 0x80073cfc: アプリケーションを起動できません。問題を修正するにはアプリケーションを再インストールしてみてください。
問題
インストール プロセスの初期段階のいずれかで問題が発生しました。回避策
Gaming Runtime Services (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 にあるとします。C:\MyGame 下のサブフォルダー (たとえば C:\MyGame\Package) で makepkg.exe を使用してパッケージを作成することにします。パッケージが生成されていないため初回はうまくいきますが、再度パッケージを作成しようとすると、この問題が発生します。この失敗 (パッケージ内に 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 のファイル共有で共有すると、Gaming Runtime が共有権限を失い、このエラーが発生します。回避策
この問題はアクセス制御リスト (ACL) に関連しています。フォルダーを共有すると、アプリ モデルへのアクセスができなくなります。つまり、共有すると、コンテナーがファイルの読み取り権限を失います。回避策として、次の手順に従って ACL データを保存および復元します。- フォルダーを共有する前に、‘icacls /save AclFile’ を実行してパッケージ フォルダーの ACL を保存します。
- Windows のファイル共有を使用してフォルダーを共有します。
- 以前の ACL を復元するには、‘icacls /restore AclFile’ を実行します。
wdapp.exe unregister を実行してから wdapp.exe register を実行することによって再登録することもできます。これにより、フォルダー共有を維持しつつ権限が復元されます。