グローバルオプション
コマンド
info- パッケージメタデータを表示します。compare- 2 つのパッケージを比較して差異を報告します。license- 署名キー情報を表示します。osinfo- game OS 情報を表示します。chunkinfo- チャンクの詳細を表示します。fileinfo- ファイルの詳細を表示します。extract- パッケージからファイルを抽出します。set- PackageUtil 設定を変更します。
info
バージョン番号、ContentID、ProductID、GameOS バージョン、暗号化キー ID などのパッケージ情報を提供します。引数
compare
ベースパッケージと更新されたパッケージを比較し、更新サイズと変更されたセグメントを含む差異を報告します。引数
オプション
PackageUtil は、ベースパッケージから更新されたパッケージに更新するときにダウンロードされるコンテンツの HTML レポートを生成します。レポートには推定更新ダウンロードサイズが含まれます。
両方のパッケージが
/lk 暗号化または既定の暗号化モードを使用している必要があります。/l は使用しないでください。一意のコンテンツライセンスを使用するパッケージに対しては比較結果が正確でないためです。
license
パッケージで使用されている署名キーに関する情報を表示します。EKB ファイルがパッケージと一致するかどうかを確認することもできます。 コマンドは次のいずれかの値を報告します。- Submission signed (
/l) - Partner Center への提出のみ。 - Test signed (
/lt) - サイドロードが有効で、安全でない方法で暗号化されています。
現在、
packageutil license は /lk 署名パッケージを /l 署名パッケージとして報告します。引数
osinfo
GUID と 4 部構成のバージョン番号を含む、game OS に関する情報を提供します。引数
chunkinfo
チャンク ID、チャンクサイズ、および Intelligent Delivery 指定子を含む、パッケージ内のチャンクに関する情報を提供します。引数
fileinfo
ファイル名、サイズ、およびセグメントの詳細を含む、パッケージ内のファイルに関する情報を提供します。引数
extract
パッケージから 1 つ以上のファイルを出力ディレクトリに抽出します。Extract は MSIXVC2 パッケージでのみサポートされます。
Extract は暗号化されていないパッケージからのみ抽出できます。たとえば、XBOX CDN 上のパッケージファイルからは抽出できません。
オプション
使用例:
set
PackageUtil 設定を変更します。現在のデバイスで MSIXVC2 開発者モードをオンまたはオフに切り替えるにはset msixvc2 を使用します。
ミドルウェアやカスタムツール用の JSON 出力
compare を実行すると、PackageUtil は HTML レポートと共に JSON コンパニオンファイルを作成します。ミドルウェア、エンジン、カスタムツールは、このファイルを使用してパッケージレイアウトを検査したり、パッケージバイナリ内のファイルを見つけたり、アライメントを検証したり、パッケージをアンパックせずに構造情報を抽出したりできます。
fileinfo コマンドも、機械処理に適した構造化された出力を生成します。
JSON 出力では、ファイルサイズを小さく保つために略記フィールド名を使用します。