> ## 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) à des fins de test sur votre PC de développement, puis téléverser dans Partner Center pour la publication. Pour en savoir plus sur le format et ses avantages, consultez [Vue d'ensemble de l'empaquetage MSIXVC2](/fr-CA/build/core-features/common/packaging/overviews/packaging-msixvc2-overview). 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 à des fins de test et les soumettre à la certification en vue d'une publication publique. Certaines fonctionnalités et améliorations de MSIXVC2 sont fournies au moyen 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. Si vous créez des packages pour les consoles XBOX, consultez [Prise en main de l'empaquetage pour les consoles XBOX](/fr-CA/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. ## 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 comprend `makepkg.exe`. À partir du GDK d'octobre 2026, l'outil d'empaquetage managé se nomme `makepkg.exe`. L'ancien MakePkg.exe et le nom temporaire `makepkg2.exe` sont supprimés. * **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 où vous installez ou exécutez des packages MSIXVC2. Consultez l'[étape 7](#step-7-test-your-package-locally) pour plus de détails. ## É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 distribution 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 des ressources, des binaires, etc. * Fichiers d'« empreinte » de la plateforme Windows universelle (UWP) et Appx, notamment AppxSignature.p7x et AppxBlockMap.xml. ## Étape 2 : Créer votre 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-CA/build/core-features/common/game-config/MicrosoftGameConfig-Editor), qui synchronise les valeurs d'identité et d'ID directement à partir de votre projet Partner Center. Pour un exemple de fichier MicrosoftGame.config, consultez [Prise en main de MSIXVC pour PC](/fr-CA/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 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'information, consultez [Dépendances des packages d'infrastructure](/fr-CA/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 selon les tailles spécifiées dans la section `ShellVisuals` de votre MicrosoftGame.config. L'[éditeur MicrosoftGame.config](/fr-CA/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 ``` Cette commande crée un fichier de mappage de disposition qui définit la façon 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 au besoin. Avec MSIXVC2, la réorganisation des blocs ou le déplacement de fichiers entre les blocs n'a aucune 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. Pour plus d'information sur les fichiers de disposition, consultez [Schéma des packages de déploiement](/fr-CA/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 /pc /pd ``` 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 ` | 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 ` | Le 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 ` | Le répertoire où le package généré est placé. | | `/compress ` | 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 aussi 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 ``` La commande `packageutil set` nécessite le GDK d'octobre 2026 ou ultérieur. Cette clé de registre est requise jusqu'à une version future du GDK. Sans elle, les packages MSIXVC2 ne s'installeront pas. Exécutez la commande à partir d'une invite de commandes avec élévation de privilèges (administrateur). Installez ensuite votre package : ```text theme={null} wdapp install ``` Les packages MSIXVC2 s'installent dans le dossier `[drive]:\XboxGames`. Les fichiers sont installés dans leur forme originale et vous pouvez y accéder directement. Cet emplacement d'installation est le même que celui utilisé par les packages MSIXVC avec [Flat File Install](/fr-CA/build/core-features/common/packaging/packaging-flatfileinstall). Vous pouvez téléverser dans Partner Center le même package que celui que vous chargez localement; il n'y a pas d'étape distincte de package de soumission. ## Étape 8 : Téléverser dans Partner Center Publiez les packages MSIXVC2 dans une **nouvelle branche** de Partner Center (par exemple, `msixvc2`). Ne téléversez pas les packages MSIXVC2 dans 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 téléversement et un téléchargement complets du package. Pour plus d'information, consultez [Pratiques exemplaires relatives aux branches de packages](/fr-CA/build/core-features/common/packaging/overviews/packaging-msixvc2-overview#package-branch-best-practices). Vous disposez de deux options pour téléverser dans Partner Center. ### Option A : Téléverser un package préconstruit Si vous avez déjà créé un package à l'étape 6, téléversez-le directement : ```text theme={null} makepkg upload /pd /branch msixvc2 ``` ### Option B : Téléverser à partir de fichiers libres (flux de travail en une seule commande) Vous pouvez combiner l'empaquetage et le téléversement en une seule commande. Cette commande téléverse directement à partir de la sortie de votre build sans créer de fichier de package local : ```text theme={null} makepkg upload /d /msixvc2 /pc /branch msixvc2 ``` ### Options de téléversement | Option | Description | | - | - | | `/branch ` | La branche dans laquelle téléverser. La valeur par défaut est `main`. Utilisez une branche dédiée à MSIXVC2. | | `/flight ` | La version d'évaluation (flight) dans laquelle téléverser. Ne peut pas être utilisée avec `/branch`. | | `/market ` | Le marché dans lequel téléverser. La valeur par défaut est `default`. | | `/storeid ` | L'ID Store. Extrait du package s'il n'est pas spécifié. | | `/auth ` | 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 téléversement, consultez [Make package (makepkg.exe)](/fr-CA/build/core-features/common/packaging/deployment/makepkg). ## 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 téléversements subséquents. | | `Browser` | Ouvre un navigateur pour une connexion interactive sans mise en cache. | | `AzureCli` | Utilise les informations d'identification d'Azure CLI. Utile lorsque vous êtes déjà authentifié au moyen de `az login`. | | `AzurePipelines` | Utilise la connexion de service Azure Pipelines. Idéal pour les pipelines CI/CD d'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 des variables d'environnement. | | `Default` | Essaie plusieurs méthodes successivement. | **Exemple : téléversement à partir d'un pipeline CI/CD** ```text theme={null} makepkg upload /pd /auth AzurePipelines /branch ``` **Exemple : téléversement avec un principal de service** ```text theme={null} makepkg upload /pd /auth ClientSecret /clientid /clientsecret /branch ``` ## Étape 9 : Valider et publier dans Partner Center Après le téléversement, utilisez Partner Center pour valider et publier votre package. Le flux de soumission est le même qu'avec MSIXVC : sélectionnez votre package, configurez la disponibilité et 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. 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 à la disponibilité générale sans perturber votre jeu en ligne. ## Comparer la taille des mises à jour Pour évaluer l'avantage de MSIXVC2 pour votre titre, créez des packages à partir de deux builds successifs et comparez-les : ```text theme={null} makepkg pack /msixvc2 /f layout.xml /d /pc /pd makepkg pack /msixvc2 /f layout.xml /d /pc /pd /priorpackage ``` Comparez la taille de mise à jour obtenue à celle d'un build MSIXVC équivalent pour constater la différence. ## Intelligent Delivery avec MSIXVC2 Intelligent Delivery fonctionne de la même façon 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 les blocs n'a aucune incidence sur la taille des mises à jour de contenu. Pour plus d'information, consultez [Installation en continu et Intelligent Delivery : vue d'ensemble](/fr-CA/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery). ## Voir aussi [Vue d'ensemble de l'empaquetage MSIXVC2](/fr-CA/build/core-features/common/packaging/overviews/packaging-msixvc2-overview) [Make package (makepkg.exe)](/fr-CA/build/core-features/common/packaging/deployment/makepkg) [Prise en main de MSIXVC pour PC](/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) [Mises à jour de contenu avec MSIXVC2](/fr-CA/build/core-features/common/packaging/packaging-updates-msixvc2) [Modèle de chiffrement MSIXVC2](/fr-CA/build/core-features/common/packaging/packaging-encryption-msixvc2) [XBOX Game Package Manager](/fr-CA/build/core-features/common/packaging/xgpm) [Automatisation du téléversement des packages](/fr-CA/build/core-features/common/packaging/package-uploader) [Vue d'ensemble de Flat File Install](/fr-CA/build/core-features/common/packaging/packaging-flatfileinstall) [Schéma des packages de déploiement](/fr-CA/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)