アプリケーション管理 (wdapp.exe)
アプリケーション管理 (wdapp.exe) は、PC Microsoft Game Development Kit (GDK) のタイトルをインストールして起動するコマンドライン ツールです。
wdapp には、次の表で説明されているサブコマンドおよび機能が用意されています。
| コマンド | 説明 |
|---|---|
| wdapp launch | アプリケーションのアプリケーション ユーザー モデル ID (AUMID) を指定することで、アプリケーションを起動します。 |
| wdApp terminate | 指定されたパッケージを終了します。 これは、MSIXVC にインストールされているパッケージに対してのみ機能することに注意してください。 |
| wdapp list | PC 上のサイドロードされたすべてのアプリケーションを一覧表示します。 |
| wdapp gamefolder | ドライブのインストール フォルダを照会または設定します。 |
| wdapp update | ネットワーク共有またはローカル システムのファイル パスから、パッケージ化されたビルドの更新をストリームします。 |
| wdapp install | makepkg で作成されたアプリケーション パッケージのストリーミング インストールを開始することによってアプリケーションを展開します。 |
| wdapp register | 指定したフォルダーにアプリケーションを登録します。 |
| wdapp uninstall | パッケージ内のすべてのプロセスを終了して登録解除します。 |
| wdapp unregister | アプリケーションの登録を解除します。 |
| wdapp migrate | フラット ファイルインストールに移行します。 |
アプリケーションの配置、インストール、更新、一覧表示、削除
wdapp launch
AUMID または実行可能ファイルへのパスを指定して定義されたアプリケーションを起動します。
| wdapp launchAUMID | Executable |
|
オプション |
説明 |
|---|---|
| AUMID | 起動されるアプリケーションの AUMID を指定します。 wdapp launch には、AUMID オプションまたは [実行可能ファイル] オプションを指定できますが、両方は指定できません。 |
| Executable | 起動するアプリケーションの実行可能ファイルへのパスを指定します。 wdapp launch には、AUMID オプションまたは [実行可能ファイル] オプションを指定できますが、両方は指定できません。 |
| WaitToExit | アプリケーションを起動し、タイトルが終了するまでブロックします。 タイトルが終了すると、wdapp はタイトルの終了コードを返して終了します。 |
| log | stdout と stdin をスクラッチ ドライブ上のファイルにリダイレクトします。 プレフィックスが指定されていない場合、ファイルの名前は latest_stdout.txt および latest_stderr.txt になります。 32 文字を超える場合、プレフィックスは切り捨てられます。 |
| すべて表示 |launchResult |terminateResult |targetTerminateReason |exitCode |
all - すべての結果が表示されます launchResult - ゲームが起動できなかった理由。 これが S_OK である場合は、ゲームは正常に起動しました。 terminateResult - 終了状態に達した理由。 これが S_OK である場合は、適切な PLM フローを介して正常に終了しました。 targetTerminateReason - 使用可能な場合、終了がターゲットにされた理由、それ以外の場合はS_FALSE exitCode - プロセス終了時にゲームによって返された終了コード。 WaitToExit 引数を使用している場合、ゲーム終了時の表示内容を決定します。 |
wdApp terminate
指定されたパッケージを終了します。 これは、MSIXVC にインストールされているパッケージに対してのみ機能することに注意してください。
| wdapp terminateAUMID | PackageFullName |
|
オプション |
説明 |
|---|---|
| AUMID | 終了するアプリケーションの AUMID (AppUserModelId) を指定します。 wdapp terminate は、AUMID オプションまたは PackageFullName オプションを受け取りますが、指定した場合は両方を受け取りません。 |
| PackageFullName | 終了する PackageFullName を指定します。 wdapp terminate は、AUMID オプションまたは PackageFullName オプションを受け取りますが、指定した場合は両方を受け取りません。 |
wdapp リスト
| wdapp リスト |
|
オプション |
説明 |
|---|---|
| /d | 一覧表示されたアプリケーションの詳細情報を提供します。 |
wdapp gamefolder
| wdapp gamefolder <DriveLetter>: [/set <FolderPath>] |
|
オプション |
説明 |
|---|---|
| <DriveLetter>: | ストリーミング インストールが行われるターゲット ドライブを指定します。 既定は、XboxGames というルート フォルダの OS ドライブです。 |
| /set | <DriveLetter> で指定されたドライブのストリーミング インストール フォルダを設定します。 既定は XboxGames です。 |
wdapp update
| wdapp updatepackagepath [/l|/AllChunks] [/b] [/a] [/m] [/ContentTypes=[semicolon-delimited specifier list] ] [/Languages=[semicolon-delimited specifier list] ] [/Devices=[semicolon-delimited specifier list] ] [/Tags=[semicolon-delimited specifier list] ] |
|
オプション |
説明 |
|---|---|
| packagepath | 更新に使用されるパッケージ ファイルへのパスを指定します。 |
| /l | 起動チャンクを受信した後で更新が停止するように指定します。 |
| /AllChunks | 変更されていない場合でも、更新がすべてのチャンクを強制的にインストールすることを指定します。 |
| /b | 更新を以前のバージョンに戻すことができるかどうかを指定します。 |
| /a | 更新を利用可能として登録します。 |
| /m | 更新を必須として登録します。 |
| /ContentTypes=[semicolon-delimited specifier list] | デフォルトで更新する ContentTypes 指定子を指定します。 |
| /Languages=[semicolon-delimited specifier list] | 既定で更新する言語指定子を指定します。 |
| /Devices=[semicolon-delimited specifier list] | 既定で更新するデバイス指定子を指定します。 |
| /Tags=[semicolon-delimited specifier list] | 既定で更新するタグ指定子を指定します。 すべてのタグをクリアするには '/Tags=' を指定します。 |
wdapp install
makepkg で作成されたアプリケーション パッケージのストリーミング インストールを開始することによってアプリケーションを展開します。
install コマンドには、アプリケーションがリテール PC にインストールされるときに実行されるストリーミング インストール プロセスが反映されています。
ストリーミング インストール パッケージのテストの詳細については、「インストールとインテリジェントな配信をストリーミング: 概要」を参照してください。
| wdapp install [/l|/AllChunks] [/bootstrapper] [/drive=[drive letter] ] [ /ContentTypes=[semicolon-delimited specifier list] ] [/Languages=[semicolon-delimited specifier list] ] [/Devices=[semicolon-delimited specifier list] ] [/Tags=[semicolon-delimited specifier list] ] [/Drive [Optional] ] [/tm] [/l] [/v] [/w] ] { packagepath | packageURI } |
| オプション | 説明 |
|---|---|
| /bootstrapper | インストール アクションで /bootstrapper フラグを使用すると、ゲームの起動時に PC Bootstrapper が呼び出されます。 これにより、アプリケーションがコードを実行する前に PC Bootstrapper が呼び出され、アプリケーションが PC Bootstrapper の子プロセスとして表示される標準のリテール インストールであるかのようにタイトルが実行されます。 これが設定されていない場合は、該当するランタイム呼び出し (サインイン検証用の XUserAddAsync など) が行われると、必要な前提条件チェックが呼び出されます。 |
| /Features=[semicolon-delimited list of Features] | 既定でインストールする機能を示します。 /Tags と共に使用することはできません。 |
| /Recipes=[semicolon-delimited list of Recipes.] | 既定でインストールするレシピを示します。 /Tags と共に使用することはできません。 |
| { packagepath | packageURI } |
packagepath (開発用コンピューター上のパス) または packageURI (URI) を指定することによって、アプリケーション パッケージの場所を指定します。 書き込まれた光学ディスク (DVD またはブルーレイ ディスク) からインストールするには、次のようにドライブ プレフィックス xo:\ に続けてファイル名を xbapp install に指定します。wdapp install /w xo:\packagepath |
| /Languages=[semicolon-delimited specifier list] | 既定でインストールする言語指定子を指定します。 |
| /Devices=[semicolon-delimited specifier list] | 既定でインストールするデバイス指定子を指定します。 |
| /Tags=[semicolon-delimited specifier list] | 既定でインストールするタグ指定子を指定します。 すべてのタグをクリアするには '/Tags=' を指定します。 |
| /drive=[drive letter] | 既定値を使わずにアプリケーションをインストールする場合の、インストール先のドライブを指定します。 |
| /tm | すべてのファイルの転送後に、転送パフォーマンス メトリックの概要を出力します。 |
| /l | 起動チャンクを受信した後でインストールが停止するように指定します。 |
| /AllChunks | インストールですべてのチャンクを強制的にインストールすることを指定します。 |
| /v | 詳細メッセージを表示します。 |
wdapp register
指定したフォルダーにアプリケーションを登録します。
| wdapp register folder_path |
|
オプション |
説明 |
|---|---|
| folder_path | タイトル登録に使用する必要のある [MicrosoftGame.config][MicrosoftGame.config](../../system/overviews/microsoft-game-config/MicrosoftGameConfig-toc.md) ファイルが含まれるアプリケーションのルート ディレクトリを基準にして、フォルダー パスを指定します。 |
wdapp uninstall
パッケージ内のすべてのプロセスを終了して登録解除します。
| wdapp uninstall package_full_name |
|
オプション |
説明 |
|---|---|
| package_full_name | アプリケーションの完全なパッケージ名を指定します。 たとえば、mygame_1.0.0.0_neutral__r9wapr0zzdgy などです。 |
wdapp unregister
パッケージを終了し、登録を解除します。
| wdapp unregister package_full_name |
|
オプション |
説明 |
|---|---|
| package_full_name | アプリケーションの完全なパッケージ名を指定します。 たとえば、mygame_1.0.0.0_neutral__r9wapr0zzdgy などです。 |
wdapp migrate
既存の MSIXVC インストールをフラット ファイル インストール形式に移行します。 このコマンドは、March 2022 Microsoft Game Development Kit (GDK) を使用するときに、すでにインストールされている既存のゲームのインストール形式をフラット ファイル インストール形式に移行するために提供されています。
| wdapp migrate <PackageFullName> |
|
オプション |
説明 |
|---|---|
| <PackageFullName> | アプリケーションの完全なパッケージ名を指定します。 たとえば、mygame_1.0.0.0_neutral__r9wapr0zzdgy などです。 |
解説
PC の Microsoft Game Development Kit (GDK) タイトルのインストールと起動の詳細については、「Microsoft Game Development Kit ツールを利用して PC タイトルをインストールして起動する」を参照してください。
関連項目
PC コマンド ライン ツールフラット ファイル インストールの概要Microsoft Game Development Kit ツールを使用して PC タイトルをインストールおよび起動する