> ## 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.

# packageutil.exe

> packageutil.exe

PackageUtil inspecte, compare et extrait le contenu de fichiers de package XVC, MSIXVC et MSIXVC2.

```text theme={null}
packageutil <command> [options]
```

## Options globales

| Option | Description |
| - | - |
| `/v` | Active la sortie détaillée dans la console. |
| `/?`, `/h` | Affiche l'aide et les informations d'utilisation. |

## Commandes

* [`info`](#info) - Affiche les métadonnées du package.
* [`compare`](#compare) - Compare deux packages et signale les différences.
* [`license`](#license) - Affiche les informations sur la clé de signature.
* [`osinfo`](#osinfo) - Affiche les informations sur le système d'exploitation de jeu.
* [`chunkinfo`](#chunkinfo) - Affiche les détails des segments.
* [`fileinfo`](#fileinfo) - Affiche les détails des fichiers.
* [`extract`](#extract) - Extrait des fichiers d'un package.
* [`set`](#set) - Modifie un paramètre de PackageUtil.

## info

Fournit des informations sur le package, notamment le numéro de version, le ContentID, le ProductID, la version de GameOS et les ID des clés de chiffrement.

```text theme={null}
packageutil info <packagefile>
```

### Arguments

| Argument | Description |
| - | - |
| `<packagefile>` | Spécifie le fichier de package à examiner. |

## compare

Compare un package de base avec un package mis à jour et signale les différences, notamment la taille de la mise à jour et les segments modifiés.

```text theme={null}
packageutil compare <basepackagefile> <updatedpackagefile> [options]
```

### Arguments

| Argument | Description |
| - | - |
| `<basepackagefile>` | Spécifie le package de base pour la comparaison de mise à jour. |
| `<updatedpackagefile>` | Spécifie le package mis à jour pour la comparaison. |

### Options

| Option | Description |
| - | - |
| `/quiet` | Affiche uniquement les informations récapitulatives. |
| `/out <out>` | Spécifie le répertoire de sortie des rapports de comparaison. |

PackageUtil produit un rapport HTML du contenu téléchargé lors de la mise à jour du package de base vers le package mis à jour. Le rapport comprend une estimation de la taille du téléchargement de la mise à jour.

Les deux packages doivent utiliser le chiffrement `/lk` ou le mode de chiffrement par défaut. N'utilisez pas `/l`, car les résultats de la comparaison ne sont pas exacts pour les packages qui utilisent une licence de contenu unique.

## license

Affiche des informations sur la clé de signature utilisée pour un package. La commande peut également vérifier si un fichier EKB correspond au package.

La commande signale l'une des valeurs suivantes :

* Signé pour la soumission (`/l`) - uniquement pour la soumission à Partner Center.
* Signé pour les tests (`/lt`) - chargement latéral activé et chiffrement non sécurisé.

<Note>
  Actuellement, `packageutil license` signale les packages signés avec `/lk` comme des packages signés avec `/l`.
</Note>

```text theme={null}
packageutil license <packagefile> [<ekbfile>]
```

### Arguments

| Argument | Description |
| - | - |
| `<packagefile>` | Spécifie le fichier de package à examiner. |
| `<ekbfile>` | Spécifie facultativement un fichier EKB à vérifier par rapport au package. Avant la certification, utilisez cette vérification pour vous assurer que vous fournissez le fichier EKB associé au package en cours de certification. |

## osinfo

Fournit des informations sur un système d'exploitation de jeu, notamment son GUID et son numéro de version en quatre parties.

```text theme={null}
packageutil osinfo <gameos>
```

### Arguments

| Argument | Description |
| - | - |
| `<gameos>` | Spécifie le fichier de système d'exploitation de jeu à examiner. |

## chunkinfo

Fournit des informations sur les segments (chunks) d'un package, notamment l'ID du segment, la taille du segment et les spécificateurs Intelligent Delivery.

```text theme={null}
packageutil chunkinfo <packagefile>
```

### Arguments

| Argument | Description |
| - | - |
| `<packagefile>` | Spécifie le fichier de package à examiner. |

## fileinfo

Fournit des informations sur les fichiers d'un package, notamment les noms de fichiers, leurs tailles et les détails des segments de données.

```text theme={null}
packageutil fileinfo <packagefile> [options]
```

### Arguments

| Argument | Description |
| - | - |
| `<packagefile>` | Spécifie le fichier de package à examiner. |

## extract

Extrait un ou plusieurs fichiers d'un package vers un répertoire de sortie.

<Note>
  L'extraction est prise en charge uniquement pour les packages MSIXVC2.
</Note>

<Note>
  L'extraction est possible uniquement à partir de packages non chiffrés. Par exemple, il est impossible d'extraire le contenu d'un fichier de package situé sur le CDN XBOX.
</Note>

```text theme={null}
packageutil extract /package <packagefile> /out <outputdir> [options]
```

### Options

| Option | Description |
| - | - |
| `/package <package>` | Spécifie le fichier de package MSIXVC2. |
| `/file <file>` | Spécifie un fichier à extraire. S'il est omis, tous les fichiers sont extraits. |
| `/out <out>` | **(Obligatoire)** Spécifie le répertoire de sortie. |

**Exemple d'utilisation :**

```text theme={null}
packageutil extract /package MyGame.msixvc /out extracted_files
```

## set

Modifie un paramètre de PackageUtil. Utilisez `set msixvc2` pour activer ou désactiver le mode développeur MSIXVC2 sur l'appareil actuel.

```text theme={null}
packageutil set msixvc2 <on|off>
```

Exécutez cette commande à partir d'une invite de commandes avec élévation de privilèges.

## Sortie JSON pour les intergiciels et les outils personnalisés

Lorsque vous exécutez `compare`, PackageUtil crée un fichier JSON complémentaire au rapport HTML. Les intergiciels, les moteurs et les outils personnalisés peuvent utiliser ce fichier pour inspecter la disposition du package, localiser des fichiers dans le fichier binaire du package, vérifier l'alignement ou extraire des informations structurelles sans décompresser le package.

La commande `fileinfo` produit également une sortie structurée adaptée au traitement automatisé.

La sortie JSON utilise des noms de champs abrégés pour limiter la taille du fichier.

| Nom abrégé | Nom complet | Description |
| - | - | - |
| `O` | Offset | Le décalage en octets d'un segment de données dans le fichier de package. |
| `L` | Length | La longueur d'un segment de données, en octets. |

## Rubriques connexes

[Vue d'ensemble de la création de packages MSIXVC2](/fr-CA/build/core-features/common/packaging/overviews/packaging-msixvc2-overview)

[Créer un package (makepkg.exe)](/fr-CA/build/core-features/common/packaging/deployment/makepkg)

[Prise en main de MSIXVC2 pour PC](/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2)


## Related topics

- [packageutil.exe](/build/core-features/common/packaging/deployment/packageutil.md)
- [XBOX environment tools and APIs](/tools/tools-console/gc-xbox-tools-and-apis-toc.md)
- [Command-line tools for PC development](/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [Herramientas y API del entorno de XBOX](/es/tools/tools-console/gc-xbox-tools-and-apis-toc.md)
- [XBOX 环境工具与 API](/zh-CN/tools/tools-console/gc-xbox-tools-and-apis-toc.md)
