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

# Prise en main de l'empaquetage MSIXVC2 pour PC

> Prise en main de l'empaquetage MSIXVC2 pour PC

Suivez les étapes ci-dessous pour créer un package MSIXVC2 que vous pouvez charger de manière indépendante (sideload) pour le tester sur votre PC de développement, puis charger dans Partner Center pour la publication.

Pour des informations générales sur le format et ses avantages, consultez [Vue d'ensemble de l'empaquetage MSIXVC2](/fr/build/core-features/common/packaging/overviews/packaging-msixvc2-overview).

<Info>
  MSIXVC2 est disponible pour tous à partir du Microsoft Game Development Kit (GDK) d'octobre 2026. Vous pouvez charger de manière indépendante des packages MSIXVC2 pour les tester et les soumettre à la certification en vue d'une publication publique.
</Info>

<Note>
  Certaines fonctionnalités et améliorations de MSIXVC2 sont fournies par le biais de mises à jour des Gaming Runtime Services et ne nécessitent pas de mise à jour du GDK. Vous recevez automatiquement ces améliorations dès qu'elles sont disponibles.
</Note>

<Note>
  Si vous créez des packages pour les consoles XBOX, consultez [Prise en main de l'empaquetage pour les consoles XBOX](/fr/build/core-features/common/packaging/overviews/packaging-getting-started-for-console). Les jeux sur console continuent d'utiliser XVC. L'outil `makepkg` gère les deux formats.
</Note>

## Avant de commencer

* **Windows 10** version 18362 ou ultérieure sur votre PC de développement.
* **GDK d'octobre 2026 ou ultérieur** installé. Le GDK inclut `makepkg.exe`.

<Note>
  À partir du GDK d'octobre 2026, l'outil d'empaquetage managé s'appelle `makepkg.exe`. L'ancien MakePkg.exe et le nom temporaire `makepkg2.exe` sont supprimés.
</Note>

* **Produit Partner Center** Vous avez besoin de votre identité d'éditeur, du nom du package et de l'ID Store.
* **Mode développeur** activé sur votre PC de test cible.
* **Clé de Registre du mode développeur MSIXVC2** définie sur tout appareil sur lequel vous installez ou exécutez des packages MSIXVC2. Pour plus d'informations, consultez l'[étape 7](#step-7-test-your-package-locally).

## Étape 1 : préparer votre contenu

Placez tout le matériel source de votre titre dans un seul répertoire. Supprimez tous les fichiers que le système d'empaquetage ne peut pas utiliser ou qui ne conviennent pas à une livraison dans des packages commerciaux.

Supprimez les fichiers suivants s'ils sont présents :

* Fichiers PDB.
* Toute référence à d'autres magasins de jeux PC, comme les ressources, les fichiers binaires, etc.
* Fichiers d'« empreinte » de la plateforme Windows universelle (UWP) et Appx, notamment AppxSignature.p7x et AppxBlockMap.xml.

## Étape 2 : créer votre fichier MicrosoftGame.config

Créez un fichier MicrosoftGame.config dans le répertoire racine du contenu de votre jeu. Ce fichier de configuration fonctionne avec MSIXVC. Votre fichier MicrosoftGame.config existant fonctionne sans modification avec MSIXVC2.

Vous pouvez créer ce fichier manuellement ou à l'aide de l'[éditeur MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Editor), qui synchronise les valeurs d'identité et d'ID directement depuis votre projet Partner Center.

Pour un exemple de fichier MicrosoftGame.config, consultez [Prise en main de MSIXVC pour PC](/fr/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC#sample-microsoftgameconfig).

## Étape 3 : identifier les dépendances du runtime Visual C/C++

Assurez-vous que votre fichier MicrosoftGame.config répertorie toutes les dépendances du runtime Visual C/C++, ou copiez explicitement ces dépendances dans la charge utile de votre package. Pour plus d'informations, consultez [Dépendances des packages d'infrastructure](/fr/build/core-features/common/packaging/packaging-framework-packages).

## Étape 4 : créer vos icônes

Placez les fichiers d'icônes dans le dossier racine du contenu de votre jeu (ou dans un sous-répertoire), mis à l'échelle aux tailles spécifiées dans la section `ShellVisuals` de votre fichier MicrosoftGame.config. L'[éditeur MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Editor) peut générer ces images à partir d'une seule image source.

## Étape 5 : générer un fichier de mappage de disposition (facultatif)

Cette étape est facultative. Par défaut, MSIXVC2 empaquette tout le contenu dans un seul bloc. Vous n'avez besoin d'un fichier de mappage de disposition que si vous souhaitez répartir le contenu en plusieurs blocs ou ajouter des balises Intelligent Delivery.

Pour générer un fichier de mappage de disposition, ouvrez une invite de commandes GDK et exécutez la commande suivante :

```text theme={null}
makepkg genmap /f layout.xml /d <your_game_folder>
```

Cette commande crée un fichier de mappage de disposition qui définit la manière dont votre contenu est organisé en blocs. Le fichier généré contient un seul bloc. Vous pouvez modifier le fichier pour répartir le contenu en plusieurs blocs ou ajouter des balises Intelligent Delivery selon vos besoins.

<Tip>
  Avec MSIXVC2, la réorganisation des blocs ou le déplacement de fichiers entre blocs n'a pas d'incidence sur la taille des mises à jour de contenu. Vous pouvez organiser librement votre disposition sans vous soucier de la pénalité de mise à jour qui existe avec MSIXVC.
</Tip>

Pour plus d'informations sur les fichiers de disposition, consultez [Schéma de package de déploiement](/fr/build/core-features/common/packaging/deployment/atoc-deployment-schema).

## Étape 6 : créer votre package MSIXVC2

Créez le package :

```text theme={null}
makepkg pack /msixvc2 /f layout.xml /d <your_game_folder> /pc /pd <output_folder>
```

Options principales :

| Option | Description |
| - | - |
| `/msixvc2` | Génère un package MSIXVC2. Sans cette option, la commande génère un package MSIXVC. À partir du GDK d'avril 2027, `makepkg` crée des packages MSIXVC2 par défaut. |
| `/f <mapfile>` | Spécifie le fichier de mappage de disposition. S'il est omis, une disposition par défaut à bloc unique est générée. |
| `/d <sourcedir>` | Répertoire contenant le contenu de votre jeu et le fichier MicrosoftGame.config. |
| `/pc` | Génère un package destiné à être utilisé sur PC. |
| `/pd <outputdir>` | Répertoire dans lequel le package généré est placé. |
| `/compress <method>` | Compresse la sortie. Méthodes disponibles : `Automatic` (par défaut), `None`. `Automatic` utilise Brotli pour les packages MSIXVC2. |

## Étape 7 : tester votre package localement

Activez le mode développeur sur votre PC cible. Avant d'installer un package MSIXVC2, définissez la clé de Registre suivante sur l'appareil cible :

```text theme={null}
reg add HKLM\SOFTWARE\Microsoft\GamingServices /v Xvc2DeveloperMode /t REG_DWORD /d 1 /f
```

Vous pouvez également activer le mode développeur MSIXVC2 à l'aide de `packageutil` :

```text theme={null}
packageutil set msixvc2 on
```

Pour désactiver le mode développeur MSIXVC2 :

```text theme={null}
packageutil set msixvc2 off
```

<Note>
  La commande `packageutil set` nécessite le GDK d'octobre 2026 ou ultérieur.
</Note>

<Info>
  Cette clé de Registre est requise jusqu'à une future version du GDK. Sans elle, les packages MSIXVC2 ne s'installent pas. Exécutez la commande depuis une invite de commandes avec élévation de privilèges (administrateur).
</Info>

Installez ensuite votre package :

```text theme={null}
wdapp install <your_package.msixvc>
```

Les packages MSIXVC2 s'installent dans le dossier `[drive]:\XboxGames`. Les fichiers sont installés sous leur forme d'origine et vous pouvez y accéder directement. Cet emplacement d'installation est le même que celui utilisé par les packages MSIXVC avec l'[installation de fichiers plats (Flat File Install)](/fr/build/core-features/common/packaging/packaging-flatfileinstall).

Vous pouvez charger dans Partner Center le même package que celui que vous chargez localement de manière indépendante : il n'y a pas d'étape distincte de package de soumission.

## Étape 8 : charger dans Partner Center

<Info>
  Publiez les packages MSIXVC2 sur une **nouvelle branche** dans Partner Center (par exemple, `msixvc2`). Ne chargez pas de packages MSIXVC2 sur la même branche que vos packages MSIXVC existants. Les deux formats ne sont pas interchangeables au sein d'une branche, et le retour d'une branche de MSIXVC2 à MSIXVC nécessite un chargement et un téléchargement complets du package. Pour plus d'informations, consultez [Bonnes pratiques relatives aux branches de packages](/fr/build/core-features/common/packaging/overviews/packaging-msixvc2-overview#package-branch-best-practices).
</Info>

Vous disposez de deux options pour charger dans Partner Center.

### Option A : charger un package prédéfini

Si vous avez déjà créé un package à l'étape 6, chargez-le directement :

```text theme={null}
makepkg upload /pd <package_directory> /branch msixvc2
```

### Option B : charger à partir de fichiers libres (flux de travail en une seule commande)

Vous pouvez combiner l'empaquetage et le chargement en une seule commande. Cette commande effectue le chargement directement à partir de la sortie de votre build, sans créer de fichier de package local :

```text theme={null}
makepkg upload /d <your_game_folder> /msixvc2 /pc /branch msixvc2
```

### Options de chargement

| Option | Description |
| - | - |
| `/branch <branch>` | Branche vers laquelle effectuer le chargement. La valeur par défaut est `main`. Utilisez une branche MSIXVC2 dédiée. |
| `/flight <flight>` | Version d'évaluation (flight) vers laquelle effectuer le chargement. Ne peut pas être utilisée avec `/branch`. |
| `/market <market>` | Marché vers lequel effectuer le chargement. La valeur par défaut est `default`. |
| `/storeid <storeId>` | ID Store. Extrait du package s'il n'est pas spécifié. |
| `/auth <method>` | Méthode d'authentification. La valeur par défaut est `CacheableBrowser`. Consultez [Méthodes d'authentification](#authentication-methods) pour les options CI/CD. |

Pour la liste complète des options de chargement, consultez [Créer un package (makepkg.exe)](/fr/build/core-features/common/packaging/deployment/makepkg).

<a id="authentication-methods" />

## Méthodes d'authentification

La commande `upload` prend en charge plusieurs méthodes d'authentification pour différents environnements.

| Méthode | Cas d'utilisation |
| - | - |
| `CacheableBrowser` | Par défaut. Ouvre un navigateur pour une connexion interactive. Met en cache les informations d'identification pour les chargements suivants. |
| `Browser` | Ouvre un navigateur pour une connexion interactive sans mise en cache. |
| `AzureCli` | Utilise les informations d'identification Azure CLI. Utile lorsque vous êtes déjà authentifié via `az login`. |
| `AzurePipelines` | Utilise la connexion de service Azure Pipelines. Idéal pour les pipelines CI/CD Azure DevOps. |
| `ManagedIdentity` | Utilise une identité managée Azure. Nécessite `/clientid`. |
| `ManagedIdentityFederated` | Utilise une identité managée fédérée. Nécessite `/clientid` et `/resourceid`. |
| `ClientSecret` | Utilise un ID client et un secret. Nécessite `/clientid` et `/clientsecret`. |
| `ClientCertificate` | Utilise un certificat client. Nécessite `/clientid` et `/certthumbprint`. |
| `Environment` | Utilise les informations d'identification provenant des variables d'environnement. |
| `Default` | Essaie plusieurs méthodes successivement. |

**Exemple : chargement depuis un pipeline CI/CD**

```text theme={null}
makepkg upload /pd <package_directory> /auth AzurePipelines /branch <branch>
```

**Exemple : chargement avec un principal de service**

```text theme={null}
makepkg upload /pd <package_directory> /auth ClientSecret /clientid <appId> /clientsecret <secret> /branch <branch>
```

## Étape 9 : valider et publier dans Partner Center

Après le chargement, utilisez Partner Center pour valider et publier votre package. Le flux de soumission est identique à celui de MSIXVC : sélectionnez votre package, configurez la disponibilité, puis soumettez.

Vous pouvez publier des packages MSIXVC2 dans vos sandbox à des fins de test et les soumettre à la certification en vue d'une publication publique.

<Tip>
  Conservez votre pipeline MSIXVC existant pour les versions de production. Utilisez une branche Partner Center distincte pour l'évaluation de MSIXVC2 afin de pouvoir comparer les résultats côte à côte et migrer vers MSIXVC2 lors de la disponibilité générale sans perturber votre jeu en production.
</Tip>

## Comparaison des tailles de mise à jour

Pour évaluer l'intérêt de MSIXVC2 pour votre titre, créez des packages à partir de deux builds successives et comparez-les :

```text theme={null}
makepkg pack /msixvc2 /f layout.xml /d <old_build> /pc /pd <output_old>
makepkg pack /msixvc2 /f layout.xml /d <new_build> /pc /pd <output_new> /priorpackage <output_old\package.msixvc>
```

Comparez la taille de mise à jour obtenue à celle d'une build MSIXVC équivalente pour constater la différence.

## Intelligent Delivery avec MSIXVC2

Intelligent Delivery fonctionne de la même manière avec MSIXVC2 qu'avec MSIXVC. Vous définissez des blocs dans votre fichier de mappage de disposition et définissez des spécificateurs de langue, d'appareil ou de balise. La principale différence est que la réorganisation des blocs ou le déplacement de fichiers entre blocs n'a aucune incidence sur la taille des mises à jour de contenu.

Pour plus d'informations, consultez [Installation en streaming et Intelligent Delivery : vue d'ensemble](/fr/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery).

## Voir aussi

[Vue d'ensemble de l'empaquetage MSIXVC2](/fr/build/core-features/common/packaging/overviews/packaging-msixvc2-overview) [Créer un package (makepkg.exe)](/fr/build/core-features/common/packaging/deployment/makepkg) [Prise en main de MSIXVC pour PC](/fr/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) [Mises à jour de contenu avec MSIXVC2](/fr/build/core-features/common/packaging/packaging-updates-msixvc2) [Modèle de chiffrement MSIXVC2](/fr/build/core-features/common/packaging/packaging-encryption-msixvc2) [XBOX Game Package Manager](/fr/build/core-features/common/packaging/xgpm) [Automatisation du chargement des packages](/fr/build/core-features/common/packaging/package-uploader) [Vue d'ensemble de Flat File Install](/fr/build/core-features/common/packaging/packaging-flatfileinstall) [Schéma de package de déploiement](/fr/build/core-features/common/packaging/deployment/atoc-deployment-schema)


## Related topics

- [Introducción al empaquetado MSIXVC2 para PC](/es/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md)
- [Modelo de cifrado de MSIXVC2](/es/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [Compiler et exécuter votre premier titre console GDKX](/fr-CA/home/build-first-title/first-console-title-walkthrough.md)
- [Actualizaciones de contenido con MSIXVC2](/es/build/core-features/common/packaging/packaging-updates-msixvc2.md)
- [Getting started with MSIXVC2 packaging for PC](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md)
